doc(Vote): add gitee vote toast (#7009)

* refactor: 增加 doTask 客户端脚本

* feat: 增加投票弹窗

* refactor: 增加点击逻辑

* refactor: 增加延时

Author: ArgoZhang

src/BootstrapBlazor.Server/Components/Layout/BaseLayout.razor

@@ -15,3 +15,14 @@
     <a href="" class="reload">Reload</a>
     <a class="dismiss">🗙</a>
 </div>
+
+@code {
+	RenderFragment RenderVote =>
+	@<div>
+		<p style="font-weight: bold;">我正在参加 Gitee 2025 最受欢迎的开源软件投票活动，快来给我投票吧！</p>
+		<div style="display: flex; justify-content: space-around;" id="bb-gitee-vote">
+			<a href="https://gitee.com/activity/2025opensource?ident=I6MYBB" target="_blank" style="font-weight: bold; padding: 3px 12px; border: 1px solid var(--bs-primary); border-radius: var(--bs-border-radius);">必须投一票</a>
+			<a href="https://gitee.com/activity/2025opensource?ident=I6MYBB" target="_blank" class="text-muted" style="padding: 3px 12px;" title="老六你居然不投票">我知道了</a>
+		</div>
+	</div>;
+}

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

@@ -5,13 +5,14 @@
 
 using Microsoft.Extensions.Options;
 using Microsoft.JSInterop;
+using System.Globalization;
 
 namespace BootstrapBlazor.Server.Components.Layout;
 
 /// <summary>
 /// 母版页基类
 /// </summary>
-public partial class BaseLayout : IDisposable
+public partial class BaseLayout : IAsyncDisposable
 {
     [Inject]
     [NotNull]
@@ -50,6 +51,8 @@ public partial class BaseLayout : IDisposable
     private string? CancelText { get; set; }
 
     private bool _init = false;
+    private JSModule? _module;
+    private DotNetObjectReference<BaseLayout>? _interop;
 
     /// <summary>
     /// <inheritdoc/>
@@ -71,13 +74,18 @@ protected override void OnInitialized()
     /// <inheritdoc/>
     /// </summary>
     /// <returns></returns>
-    protected override async Task OnInitializedAsync()
+    protected override async Task OnAfterRenderAsync(bool firstRender)
     {
-        await base.OnInitializedAsync();
+        await base.OnAfterRenderAsync(firstRender);
 
-        var module = await JSRuntime.LoadModule($"{WebsiteOption.Value.JSModuleRootPath}Layout/BaseLayout.razor.js");
-        await module.InvokeVoidAsync("initTheme");
-        _init = true;
+        if (firstRender)
+        {
+            _module = await JSRuntime.LoadModule($"{WebsiteOption.Value.JSModuleRootPath}Layout/BaseLayout.razor.js");
+            _interop = DotNetObjectReference.Create(this);
+            await _module.InvokeVoidAsync("doTask", _interop);
+            _init = true;
+            StateHasChanged();
+        }
     }
 
     private async Task NotifyCommit(DispatchEntry<GiteePostBody> payload)
@@ -121,25 +129,55 @@ private async Task NotifyReboot(DispatchEntry<bool> payload)
         }
     }
 
+    /// <summary>
+    /// 显示投票弹窗
+    /// </summary>
+    /// <returns></returns>
+    [JSInvokable]
+    public async Task ShowVoteToast()
+    {
+        // 英文环境不投票
+        if(CultureInfo.CurrentUICulture.Name == "en-US")
+        {
+            return;
+        }
+
+        _option = new ToastOption()
+        {
+            Category = ToastCategory.Information,
+            Title = "Gitee 评选活动",
+            IsAutoHide = false,
+            ChildContent = RenderVote,
+            PreventDuplicates = true
+        };
+        await Toast.Show(_option);
+    }
+
     /// <summary>
     /// 释放资源
     /// </summary>
     /// <param name="disposing"></param>
-    private void Dispose(bool disposing)
+    private async ValueTask DisposeAsync(bool disposing)
     {
         if (disposing)
         {
             CommitDispatchService.UnSubscribe(NotifyCommit);
             RebootDispatchService.UnSubscribe(NotifyReboot);
+
+            if (_module != null)
+            {
+                await _module.InvokeVoidAsync("dispose");
+                await _module.DisposeAsync();
+            }
         }
     }
 
     /// <summary>
     /// 释放资源
     /// </summary>
-    public void Dispose()
+    public async ValueTask DisposeAsync()
     {
-        Dispose(true);
+        await DisposeAsync(true);
         GC.SuppressFinalize(this);
     }
 }

src/BootstrapBlazor.Server/Components/Layout/BaseLayout.razor.js

@@ -1,6 +1,41 @@
 import { getTheme, setTheme } from "../../_content/BootstrapBlazor/modules/utility.js"
+import EventHandler from "../../_content/BootstrapBlazor/modules/event-handler.js"
 
-export function initTheme() {
+function initTheme() {
     const currentTheme = getTheme();
     setTheme(currentTheme, false);
 }
+
+export function doTask(invoke) {
+    initTheme();
+
+    const v = localStorage.getItem('bb-gitee-vote');
+    if (v) {
+        try {
+            const differ = new Date().getTime() - v;
+            if (differ < 86400000) {
+                return;
+            }
+        }
+        catch {
+            localStorage.removeItem('bb-gitee-vote');
+        }
+    }
+    const handler = setTimeout(async () => {
+        clearTimeout(handler);
+        await invoke.invokeMethodAsync("ShowVoteToast");
+    }, 10000);
+
+    EventHandler.on(document, 'click', '#bb-gitee-vote', e => {
+        const toast = e.delegateTarget.closest('.toast');
+        if (toast) {
+            toast.classList.remove('show');
+
+            localStorage.setItem('bb-gitee-vote', new Date().getTime());
+        }
+    });
+}
+
+export function dispose() {
+    EventHandler.off(document, 'click', '#bb-gitee-vote');
+}