refactor: 增加 Layout 参数用于接管 RenderTabHeader 方法

Author: ArgoZhang

src/BootstrapBlazor/Components/Layout/Layout.razor

@@ -143,7 +143,7 @@
           ShowRefreshToolbarButton="ShowRefreshToolbarButton" ShowFullscreenToolbarButton="ShowFullscreenToolbarButton"
           RefreshToolbarButtonIcon="@RefreshToolbarButtonIcon" FullscreenToolbarButtonIcon="@FullscreenToolbarButtonIcon"
           RefreshToolbarTooltipText="@RefreshToolbarTooltipText" FullscreenToolbarTooltipText="@FullscreenToolbarTooltipText"
-          OnToolbarRefreshCallback="OnToolbarRefreshCallback"
+          OnToolbarRefreshCallback="OnToolbarRefreshCallback" Layout="this"
           Body="@Main" NotAuthorized="NotAuthorized!" NotFound="NotFound!" NotFoundTabText="@NotFoundTabText">
     </Tab>;
 

src/BootstrapBlazor/Components/Layout/Layout.razor.cs

@@ -458,7 +458,7 @@ public partial class Layout : IHandlerException
 
     private bool _init;
     private Tab? _tab = null;
-    private LayoutTabHeader? _tabHeader = null;
+    private ITabHeader? _tabHeader = null;
 
     /// <summary>
     /// <inheritdoc/>
@@ -636,14 +636,14 @@ public virtual Task HandlerException(Exception ex, RenderFragment<Exception> err
 
     private RenderFragment RenderTabHeader() => builder =>
     {
-        builder.OpenComponent<LayoutTabHeader>(0);
-        builder.AddComponentReferenceCapture(1, instance => _tabHeader = (LayoutTabHeader)instance);
+        builder.OpenComponent<LayoutHeader>(0);
+        builder.AddComponentReferenceCapture(1, instance => _tabHeader = (ITabHeader)instance);
         builder.CloseComponent();
     };
 
     internal void RegisterTab(Tab tab)
     {
-        tab.layoutTabHeader = _tabHeader;
+        tab.TabHeader = _tabHeader;
     }
 
     /// <summary>

src/BootstrapBlazor/Components/Layout/LayoutTabHeader.cs renamed to src/BootstrapBlazor/Components/Layout/LayoutHeader.cs

@@ -5,7 +5,7 @@
 
 namespace BootstrapBlazor.Components;
 
-internal class LayoutTabHeader : IComponent
+internal class LayoutHeader : IComponent, ITabHeader
 {
     private RenderHandle _renderHandle;
 

src/BootstrapBlazor/Components/Tab/ITabHeader.cs

@@ -0,0 +1,18 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the Apache 2.0 License
+// See the LICENSE file in the project root for more information.
+// Maintainer: Argo Zhang([email protected]) Website: https://www.blazor.zone
+
+namespace BootstrapBlazor.Components;
+
+/// <summary>
+/// ITabHeader interface
+/// </summary>
+public interface ITabHeader
+{
+    /// <summary>
+    /// Render method
+    /// </summary>
+    /// <param name="renderFragment"></param>
+    void Render(RenderFragment renderFragment);
+}

src/BootstrapBlazor/Components/Tab/Tab.razor

@@ -40,9 +40,9 @@ else
 @code {
     RenderFragment RenderTab =>
     @<div @attributes="@AdditionalAttributes" id="@Id" class="@ClassString" style="@StyleString">
-        @if (layoutTabHeader != null)
+        @if (TabHeader != null)
         {
-            layoutTabHeader.Render(RenderTabHeader);
+            TabHeader.Render(RenderTabHeader);
         }
         else
         {

src/BootstrapBlazor/Components/Tab/Tab.razor.cs

@@ -419,8 +419,14 @@ public partial class Tab : IHandlerException
     [Parameter]
     public Func<TabItem, Task<bool>>? OnBeforeShowContextMenu { get; set; }
 
+    /// <summary>
+    /// Gets or sets the <see cref="ITabHeader"/> instance. Default is null.
+    /// </summary>
+    [Parameter]
+    public Layout? Layout { get; set; }
+
     [CascadingParameter]
-    private Layout? Layout { get; set; }
+    private Layout? CascadeLayout { get; set; }
 
     [Inject]
     [NotNull]
@@ -465,7 +471,7 @@ public partial class Tab : IHandlerException
 
     private bool IsPreventDefault => _contextMenuZone != null;
 
-    internal LayoutTabHeader? layoutTabHeader = null;
+    internal ITabHeader? TabHeader { get; set; }
 
     /// <summary>
     /// <inheritdoc/>
@@ -786,6 +792,8 @@ public void AddTab(string url, string text, string? icon = null, bool active = t
         StateHasChanged();
     }
 
+    private Layout? LayoutInstance => Layout ?? CascadeLayout;
+
     private void AddTabItem(string url)
     {
         var parameters = new Dictionary<string, object?>
@@ -823,7 +831,7 @@ private void AddTabItem(string url)
                 builder.AddAttribute(1, nameof(BootstrapBlazorAuthorizeView.Type), context.Handler);
                 builder.AddAttribute(2, nameof(BootstrapBlazorAuthorizeView.Parameters), context.Parameters);
                 builder.AddAttribute(3, nameof(BootstrapBlazorAuthorizeView.NotAuthorized), NotAuthorized);
-                builder.AddAttribute(4, nameof(BootstrapBlazorAuthorizeView.Resource), Layout?.Resource);
+                builder.AddAttribute(4, nameof(BootstrapBlazorAuthorizeView.Resource), LayoutInstance?.Resource);
                 builder.CloseComponent();
             }));
         }
@@ -1005,7 +1013,7 @@ private RenderFragment RenderTabItemContent(TabItem item) => builder =>
     private IEnumerable<MenuItem>? _menuItems;
     private MenuItem? GetMenuItem(string url)
     {
-        _menuItems ??= (Menus ?? Layout?.Menus).GetAllItems();
+        _menuItems ??= (Menus ?? LayoutInstance?.Menus).GetAllItems();
         return _menuItems?.FirstOrDefault(i => !string.IsNullOrEmpty(i.Url) && (i.Url.TrimStart('/').Equals(url.TrimStart('/'), StringComparison.OrdinalIgnoreCase)));
     }