refactor: 组件方法直接调用 DockView 方法

Author: ArgoZhang

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

@@ -173,6 +173,7 @@ protected override void OnParametersSet()
     {
         base.OnParametersSet();
 
+        // 同步组件状态到缓存
         var state = DockView.GetComponentState(Key);
         if (state != null)
         {
@@ -189,9 +190,7 @@ private async Task OnClickBar()
         }
     }
 
-    private bool IsRender() => DockView.GetComponentState(Key).IsRender();
-
-    internal object? GetState() => DockView.GetComponentState(Key).GetComponentState(this);
+    private bool IsRender() => DockView.IsRender(Key);
 
     internal void SetVisible(bool visible) => Visible = visible;
 

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

@@ -249,7 +249,7 @@ public async Task Reset(string? layoutConfig = null)
     /// <para lang="zh">获得 当前布局 JSON 字符串</para>
     /// <para lang="en">Gets the current layout JSON string</para>
     /// </summary>
-    public Task<string?> SaveLayout() => InvokeAsync<string?>("save", Id);
+    public Task<string?> SaveLayout() => InvokeAsync<string>("save", Id);
 
     private Task OnThemeChangedAsync(string themeName)
     {
@@ -341,6 +341,7 @@ public async Task SplitterCallbackAsync()
     [JSInvokable]
     public Task LoadTabs(List<string> tabs)
     {
+        // 注意渲染方式 DockViewRenderMode 为 DockViewRenderMode.OnlyWhenVisible 时此逻辑生效
         _loadTabs = tabs.ToHashSet();
         foreach (var componnet in _componentStates)
         {
@@ -354,6 +355,11 @@ public Task LoadTabs(List<string> tabs)
 
     internal void AddComponentState(DockViewComponentState state)
     {
+        if (Renderer == DockViewRenderMode.Always)
+        {
+            return;
+        }
+
         if (!string.IsNullOrEmpty(state.Key))
         {
             _componentStates.TryAdd(state.Key, state);
@@ -362,6 +368,11 @@ internal void AddComponentState(DockViewComponentState state)
 
     internal void RemoveComponentState(string? key)
     {
+        if (Renderer == DockViewRenderMode.Always)
+        {
+            return;
+        }
+
         if (!string.IsNullOrEmpty(key))
         {
             _componentStates.TryRemove(key, out _);
@@ -371,13 +382,23 @@ internal void RemoveComponentState(string? key)
     internal DockViewComponentState? GetComponentState(string? key)
     {
         DockViewComponentState? state = null;
-        if (!string.IsNullOrEmpty(key) && _componentStates.TryGetValue(key, out var _state))
+        if (Renderer == DockViewRenderMode.OnlyWhenVisible)
         {
-            state = _state;
+            if (!string.IsNullOrEmpty(key) && _componentStates.TryGetValue(key, out var _state))
+            {
+                state = _state;
+            }
         }
+
         return state;
     }
 
+    internal bool IsRender(string? key) => Renderer switch
+    {
+        DockViewRenderMode.OnlyWhenVisible => GetComponentState(key)?.IsRender() ?? false,
+        _ => true
+    };
+
     private void Dispose(bool disposing)
     {
         if (disposing)

src/components/BootstrapBlazor.DockView/Data/DockViewComponentState.cs

@@ -32,11 +32,15 @@ class DockViewComponentState(DockViewComponent component)
     /// <para lang="zh">获得/设置 组件内容是否渲染，默认为 false</para>
     /// <para lang="en">Gets or sets whether the component is rendered. Default is false</para>
     /// </summary>
+    /// <remarks>
+    ///   <para lang="zh">组件内容是否渲染，默认为 false，只有当组件可见时并且当前状态为 Active 时才会渲染组件内容</para>
+    ///   <para lang="en">Whether the component content is rendered. Default is false. The content is only rendered when the component is visible and the current state is Active.</para>
+    /// </remarks>
     public bool Render { get; set; }
 
     /// <summary>
     /// <para lang="zh">获得/设置 组件实例，默认为 null</para>
     /// <para lang="en">Gets or sets the component instance. Default is null</para>
     /// </summary>
-    public DockViewComponent? Component => component;
+    public DockViewComponent Component => component;
 }