You need to enable JavaScript to run this app. ASP.NET Core Razor Pages 用JavaScript实现导航栏激活链接样式切换
优惠活动
大模型
产品
解决方案
定价
更多

ASP.NET Core Razor Pages 用JavaScript实现导航栏激活链接样式切换

问题根因

你当前逻辑失效的核心原因是:你在点击事件中修改类名的操作发生在页面跳转之前,而Razor Pages采用服务端全量渲染返回新HTML的跳转模式,跳转完成后整个DOM会被完全重建,所有前端临时修改的类名都会被重置,完全无法被保留。
正确的适配思路不需要拦截导航点击行为,而是在每次页面加载完成时,基于浏览器当前的实际访问路径,自动匹配对应导航链接并添加激活类,从根源上适配全量重渲染的机制。

第一步:清理原有冗余代码
  • 删除Home导航链接上硬编码的active-link类,将原<a class="nav-link active-link" asp-area="" asp-page="/Index">Home</a>修改为<a class="nav-link" asp-area="" asp-page="/Index">Home</a>,避免默认激活状态干扰自动匹配逻辑。
  • 移除原site.js中绑定点击事件、临时存储激活元素的所有逻辑,这部分逻辑在全量跳转场景下没有实际作用。
无硬编码的纯JavaScript实现

直接将site.js的逻辑替换为以下内容:

document.addEventListener('DOMContentLoaded', () => {
    // 选取导航栏内的所有导航链接
    const navLinks = document.querySelectorAll('.navbar-nav .nav-link');
    // 标准化当前页面路径:移除尾部斜杠、过滤无关的查询参数和哈希值
    const currentPath = window.location.pathname.replace(/\/$/, '');

    navLinks.forEach(link => {
        // 标准化每个导航链接的目标路径
        const linkTargetPath = new URL(link.href).pathname.replace(/\/$/, '');
        
        // 匹配规则:
        // 1. 常规场景:路径完全相等则激活
        // 2. 特殊兼容:站点根路径自动匹配指向/Index的首页链接
        const isActive = 
            currentPath === linkTargetPath || 
            (currentPath === '' && linkTargetPath.endsWith('/Index'));

        if (isActive) {
            link.classList.add('active-link');
        }
    });
});

方案特性

  • 完全无硬编码:不需要在JS中写死每个页面对应的导航项,后续新增导航只需要在导航栏加正常的asp-page链接标签即可,JS逻辑不需要做任何修改
  • 完美适配Razor Pages的重渲染机制:每次服务端返回新HTML加载完成后,都会自动根据当前地址匹配激活项,不存在跳转后状态丢失的问题
  • 兼容特殊路径场景:自动处理根路径匹配、路径尾部斜杠差异、带查询参数的页面访问等情况,不会出现匹配失效的问题
  • 性能损耗极低:仅在页面加载时执行一次路径匹配,没有额外的事件监听开销
可选的无JS依赖方案

如果需要不依赖前端JS也能正常显示导航激活状态,可以通过自定义Razor Tag Helper实现服务端渲染时自动添加激活类:

  • 自定义的Tag Helper会在服务端输出导航标签时,自动对比当前请求的路由路径和链接的目标页面路径
  • 路径匹配成功时直接在输出的HTML中添加active-link类,不需要任何前端脚本介入
  • 同样支持根路径自动匹配首页链接的场景,不需要逐页硬编码判断逻辑

内容的提问来源于stack exchange,提问作者Miraziz

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 15:27:01