添加项目文件。

2026-04-25 00:29:16 +08:00
parent 1850fdc75d
commit 2c56c7f04d
2177 changed files with 97211 additions and 0 deletions
--- a/TagHelpers/ActiveLinkTagHelper.cs
+++ b/TagHelpers/ActiveLinkTagHelper.cs
@@ -0,0 +1,84 @@
+using Microsoft.AspNetCore.Mvc.Rendering;
+using Microsoft.AspNetCore.Mvc.ViewFeatures;
+using Microsoft.AspNetCore.Razor.TagHelpers;
+using System;
+
+namespace AcdiuTools.TagHelpers
+{
+    /// <summary>
+    /// 自动为当前激活的导航链接添加 'active' 类和 'aria-current="page"' 属性。
+    /// <para>
+    /// 用法示例: 
+    /// &lt;a asp-active-link="true" asp-controller="Home" asp-action="Index" class="nav-link"&gt;首页&lt;/a&gt;
+    /// </para>
+    /// </summary>
+    [HtmlTargetElement("a", Attributes = "asp-active-link")]
+    public class ActiveLinkTagHelper : TagHelper
+    {
+        /// <summary>
+        /// 获取或设置当前视图的上下文，用于读取路由数据。
+        /// </summary>
+        [ViewContext]
+        [HtmlAttributeNotBound]
+        public ViewContext ViewContext { get; set; } = default!;
+
+        /// <summary>
+        /// 是否启用自动激活检测。对应 HTML 属性: asp-active-link
+        /// </summary>
+        [HtmlAttributeName("asp-active-link")]
+        public bool IsActiveLink { get; set; }
+
+        /// <summary>
+        /// 目标控制器名称。映射自内置的 asp-controller 属性。
+        /// </summary>
+        [HtmlAttributeName("asp-controller")]
+        public string? Controller { get; set; }
+
+        /// <summary>
+        /// 目标 Action 名称。映射自内置的 asp-action 属性。
+        /// </summary>
+        [HtmlAttributeName("asp-action")]
+        public string? Action { get; set; }
+
+        /// <summary>
+        /// 执行 TagHelper 逻辑。
+        /// </summary>
+        /// <param name="context">TagHelper 上下文。</param>
+        /// <param name="output">TagHelper 输出内容。</param>
+        public override void Process(TagHelperContext context, TagHelperOutput output)
+        {
+            // 如果未设置 asp-active-link="true"，则不执行逻辑
+            if (!IsActiveLink) return;
+
+            // 1. 获取当前路由中的 Controller 和 Action
+            var routeData = ViewContext.RouteData.Values;
+            string? currentController = routeData["controller"]?.ToString();
+            string? currentAction = routeData["action"]?.ToString();
+
+            // 2. 确定目标 Controller 和 Action (如果未指定，则默认为当前页面或 Index)
+            string targetController = Controller ?? currentController ?? string.Empty;
+            string targetAction = Action ?? "Index";
+
+            // 3. 忽略大小写进行匹配
+            bool isActive = string.Equals(currentController, targetController, StringComparison.OrdinalIgnoreCase) &&
+                            string.Equals(currentAction, targetAction, StringComparison.OrdinalIgnoreCase);
+
+            if (isActive)
+            {
+                // 4. 合并 Class 属性，确保不覆盖原有样式
+                var existingClasses = output.Attributes["class"]?.Value?.ToString();
+                if (string.IsNullOrWhiteSpace(existingClasses))
+                {
+                    output.Attributes.SetAttribute("class", "active");
+                }
+                else if (!existingClasses.Contains("active"))
+                {
+                    output.Attributes.SetAttribute("class", $"{existingClasses} active");
+                }
+
+                // 5. 增强无障碍支持
+                output.Attributes.SetAttribute("aria-current", "page");
+            }
+        }
+    }
+}