feat(DockView): remove EditorRequired attribute (#985)

* refactor: 参数排序

* feat: 增加参数检查逻辑开启本地存储时必须给 Name 参数

* chore: bump version 10.0.9

Author: ArgoZhang

src/components/BootstrapBlazor.DockView/BootstrapBlazor.DockView.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Razor">
 
   <PropertyGroup>
-    <Version>10.0.8</Version>
+    <Version>10.0.9</Version>
   </PropertyGroup>
 
   <PropertyGroup>

src/components/BootstrapBlazor.DockView/Components/DockViewV2.razor.cs

@@ -14,15 +14,6 @@ namespace BootstrapBlazor.Components;
 /// </summary>
 public partial class DockViewV2
 {
-    /// <summary>
-    /// <para lang="zh">获得/设置 DockView 名称，默认为 null，用于本地存储标识</para>
-    /// <para lang="en">Gets or sets the DockView name. Default is null and it is used for local storage identification</para>
-    /// </summary>
-    [Parameter]
-    [EditorRequired]
-    [NotNull]
-    public string? Name { get; set; }
-
     /// <summary>
     /// <para lang="zh">获得/设置 布局配置</para>
     /// <para lang="en">Gets or sets the layout configuration</para>
@@ -128,6 +119,14 @@ public partial class DockViewV2
     [Parameter]
     public string? Version { get; set; }
 
+    /// <summary>
+    /// <para lang="zh">获得/设置 DockView 名称，默认为 null，用于本地存储标识</para>
+    /// <para lang="en">Gets or sets the DockView name. Default is null and it is used for local storage identification</para>
+    /// </summary>
+    [Parameter]
+    [NotNull]
+    public string? Name { get; set; }
+
     /// <summary>
     /// <para lang="zh">获得/设置 是否启用本地存储布局，默认为 null</para>
     /// <para lang="en">Gets or sets whether local storage layout is enabled. Default is null</para>
@@ -186,6 +185,20 @@ protected override void OnInitialized()
         ThemeProviderService.ThemeChangedAsync += OnThemeChangedAsync;
     }
 
+    /// <summary>
+    /// <inheritdoc/>
+    /// </summary>
+    protected override void OnParametersSet()
+    {
+        base.OnParametersSet();
+
+        // 开启本体存储未提供 Name 时抛出异常提示
+        if (IsEnableLocalStorage && string.IsNullOrEmpty(Name))
+        {
+            throw new InvalidOperationException("Name must be provided when local storage is enabled.");
+        }
+    }
+
     /// <summary>
     /// <inheritdoc/>
     /// </summary>
@@ -196,19 +209,19 @@ protected override async Task OnAfterRenderAsync(bool firstRender)
 
         if (!firstRender)
         {
-            await InvokeVoidAsync("update", Id, GetOptions());
+            await InvokeVoidAsync("update", Id, GetDockViewConfig());
         }
     }
 
     /// <summary>
     /// <inheritdoc />
     /// </summary>
-    protected override Task InvokeInitAsync() => InvokeVoidAsync("init", Id, Interop, GetOptions());
+    protected override Task InvokeInitAsync() => InvokeVoidAsync("init", Id, Interop, GetDockViewConfig());
 
-    private DockViewConfig GetOptions() => new()
+    private DockViewConfig GetDockViewConfig() => new()
     {
-        EnableLocalStorage = EnableLocalStorage ?? _options.EnableLocalStorage ?? false,
-        LocalStorageKey = $"{GetPrefixKey()}-{Name}-{GetVersion()}",
+        EnableLocalStorage = IsEnableLocalStorage,
+        LocalStorageKey = LocalStorageKey,
         IsLock = IsLock,
         ShowLock = ShowLock,
         IsFloating = IsFloating,
@@ -227,6 +240,10 @@ protected override async Task OnAfterRenderAsync(bool firstRender)
         LoadTabs = nameof(LoadTabs)
     };
 
+    private bool IsEnableLocalStorage => EnableLocalStorage ?? _options.EnableLocalStorage ?? false;
+
+    private string? LocalStorageKey => IsEnableLocalStorage ? $"{GetPrefixKey()}-{Name}-{GetVersion()}" : null;
+
     private string GetVersion() => Version ?? _options.Version ?? "v1";
 
     private string GetPrefixKey() => LocalStoragePrefix ?? _options.LocalStoragePrefix ?? "bb-dockview";
@@ -237,7 +254,7 @@ protected override async Task OnAfterRenderAsync(bool firstRender)
     /// </summary>
     public async Task Reset(string? layoutConfig = null)
     {
-        var options = GetOptions();
+        var options = GetDockViewConfig();
         if (layoutConfig != null)
         {
             options.LayoutConfig = layoutConfig;