feat(Step): add SetStepIndex method (#7619)

* doc: 更新 xml 注释

* feat(Step): add SetStepIndex method

* chore: bump version 10.3.1-beta04

* test: 更新单元测试

* test: 更新单元测试

Author: ArgoZhang

src/BootstrapBlazor/BootstrapBlazor.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Razor">
 
   <PropertyGroup>
-    <Version>10.3.1-beta03</Version>
+    <Version>10.3.1-beta04</Version>
   </PropertyGroup>
 
   <ItemGroup>

src/BootstrapBlazor/Components/Step/Step.razor.cs

@@ -155,6 +155,21 @@ public async Task<int> Next()
         return _currentStepIndex;
     }
 
+    /// <summary>
+    /// <para lang="zh">设置当前步骤索引 <see cref="StepIndex"/> 值</para>
+    /// <para lang="en">Set current step index <see cref="StepIndex"/> value</para>
+    /// </summary>
+    /// <param name="index"></param>
+    public async Task SetStepIndex(int index)
+    {
+        _currentStepIndex = Math.Max(0, Math.Min(Items.Count, index));
+        if (IsFinished && OnFinishedCallback != null)
+        {
+            await OnFinishedCallback();
+        }
+        StateHasChanged();
+    }
+
     /// <summary>
     /// <para lang="zh">重置步骤方法</para>
     /// <para lang="en">Reset Step Method</para>

src/BootstrapBlazor/Components/TreeView/TreeView.razor.cs

@@ -196,13 +196,13 @@ public partial class TreeView<TItem> : IModelEqualityComparer<TItem>
     public Func<TreeViewItem<TItem>, Task<IEnumerable<TreeViewItem<TItem>>>>? OnExpandNodeAsync { get; set; }
 
     /// <summary>
-    /// <inheritdoc/>
+    /// <inheritdoc cref="IModelEqualityComparer{TItem}.CustomKeyAttribute"/>
     /// </summary>
     [Parameter]
     public Type CustomKeyAttribute { get; set; } = typeof(KeyAttribute);
 
     /// <summary>
-    /// <inheritdoc/>
+    /// <inheritdoc cref="IModelEqualityComparer{TItem}.ModelEqualityComparer"/>
     /// </summary>
     [Parameter]
     public Func<TItem, TItem, bool>? ModelEqualityComparer { get; set; }

test/UnitTest/Components/StepTest.cs

@@ -128,7 +128,7 @@ public void Step_Method()
     }
 
     [Fact]
-    public void FinishedTemplate_Ok()
+    public async Task FinishedTemplate_Ok()
     {
         bool finished = false;
         var cut = Context.Render<Step>(pb =>
@@ -143,8 +143,29 @@ public void FinishedTemplate_Ok()
             });
         });
         var step = cut.Instance;
-        cut.InvokeAsync(() => step.Next());
-        cut.WaitForAssertion(() => cut.Contains("Finished-Template"));
+        await cut.InvokeAsync(() => step.Next());
+        cut.Contains("Finished-Template");
+        Assert.True(finished);
+    }
+
+    [Fact]
+    public async Task SetStepIndex()
+    {
+        bool finished = false;
+        var cut = Context.Render<Step>(pb =>
+        {
+            pb.Add(a => a.Items, GetStepItems);
+            pb.Add(a => a.StepIndex, 2);
+            pb.Add(a => a.OnFinishedCallback, () =>
+            {
+                finished = true;
+                return Task.CompletedTask;
+            });
+        });
+        var step = cut.Instance;
+        await cut.InvokeAsync(() => step.SetStepIndex(1));
+        Assert.False(finished);
+        await cut.InvokeAsync(() => step.SetStepIndex(3));
         Assert.True(finished);
     }