refactor(Select): rename IsUseActiveWhenValueIsNull parameter (#6390)

* feat: 更改参数 IsUseActiveWhenValueIsNull 为 IsUseDefaultItemWhenValueIsNull

* test: 更新单元测试

* chore: bump version 9.8.1-beta04

---------

Co-Authored-By: Francisco Lima <[email protected]>
Co-authored-by: Argo Zhang <[email protected]>

Author: ArgoZhang

src/BootstrapBlazor/BootstrapBlazor.csproj

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

src/BootstrapBlazor/Components/Select/Select.razor.cs

@@ -27,11 +27,24 @@ public partial class Select<TValue> : ISelect, ILookup
     private ILookupService? InjectLookupService { get; set; }
 
     /// <summary>
-    /// 获得/设置 值为 null 时是否使用第一个选项作为默认值
-    /// <para>Gets or sets a value indicating whether the "active" state should be used when the associated value is null.</para>
+    /// 获得/设置 值为 null 时是否使用第一个选项或者标记为 active 的候选项作为默认值
+    /// <para>Gets or sets a value indicating Whether to use the first option or the candidate marked as active as the default value when the value is null</para>
     /// </summary>
     [Parameter]
-    public bool IsUseActiveWhenValueIsNull { get; set; }
+    [Obsolete("已弃用，请使用 IsUseDefaultItemWhenValueIsNull 参数代替；Deprecated, use the IsUseDefaultItemWhenValueIsNull parameter instead")]
+    [ExcludeFromCodeCoverage]
+    public bool IsUseActiveWhenValueIsNull
+    {
+        get => IsUseDefaultItemWhenValueIsNull;
+        set => IsUseDefaultItemWhenValueIsNull = value;
+    }
+
+    /// <summary>
+    /// 获得/设置 值为 null 时是否使用第一个选项或者标记为 active 的候选项作为默认值
+    /// <para>Gets or sets a value indicating Whether to use the first option or the candidate marked as active as the default value when the value is null</para>
+    /// </summary>
+    [Parameter]
+    public bool IsUseDefaultItemWhenValueIsNull { get; set; }
 
     /// <summary>
     /// Gets or sets the display template. Default is null.
@@ -452,7 +465,7 @@ private async Task OnChange(ChangeEventArgs args)
             _lastSelectedValueString = "";
             _init = false;
 
-            return IsUseActiveWhenValueIsNull && !IsVirtualize
+            return IsUseDefaultItemWhenValueIsNull && !IsVirtualize
                 ? SetSelectedItemState(GetItemByRows())
                 : null;
         }

test/UnitTest/Components/SelectTest.cs

@@ -27,7 +27,7 @@ public async Task IsUseActiveWhenValueNull_Ok()
                     new("1", "Test1"),
                     new("2", "Test2") { Active = true }
                 });
-                pb.Add(a => a.IsUseActiveWhenValueIsNull, true);
+                pb.Add(a => a.IsUseDefaultItemWhenValueIsNull, true);
                 pb.Add(a => a.OnSelectedItemChanged, item =>
                 {
                     selectedValue = item.Value;