0

0

如何为导航项动态添加和移除 active 类并同步控制内容面板显隐

霞舞

霞舞

发布时间:2026-01-07 19:29:01

|

315人浏览过

|

来源于php中文网

原创

如何为导航项动态添加和移除 active 类并同步控制内容面板显隐

本文详解如何通过原生 javascript 实现点击 `

  • ` 时自动为对应按钮添加 `active` 类、移除其他按钮的 `active` 类,并同步切换关联的 `.tab-pane` 内容区的 `show active` 状态,兼容 bootstrap 5 的 tab 交互逻辑。

    在使用 Bootstrap 5 的 Tabs 组件时,虽然 data-bs-toggle="tab" 能自动处理切换逻辑,但有时需手动控制激活状态(例如:自定义事件、AJAX 加载后重置状态、或与非标准 DOM 结构集成)。此时,仅靠 Bootstrap 默认行为可能无法满足需求——比如你希望点击 <li> 触发而非 <button>,或需精确控制 .tab-pane 的 show active 类。

    以下是一个完整、健壮的解决方案,分为三步实现:

    ✅ 步骤一:监听 <li> 点击,统一管理 nav-link 激活状态

    document.addEventListener('DOMContentLoaded', () => {
      const tabList = document.getElementById('postsTab');
    
      tabList.addEventListener('click', (e) => {
        // 仅响应 <button> 的点击(避免误触 li)
        if (e.target.tagName !== 'BUTTON') return;
    
        // 移除所有 .nav-link 的 active 类
        document.querySelectorAll('.nav-link').forEach(btn => {
          btn.classList.remove('active');
          btn.setAttribute('aria-selected', 'false');
        });
    
        // 为当前按钮添加 active 并更新 ARIA 属性
        e.target.classList.add('active');
        e.target.setAttribute('aria-selected', 'true');
    
        // ? 关键:获取 data-bs-target 值(如 "#entertainment")
        const targetSelector = e.target.getAttribute('data-bs-target');
        if (!targetSelector) return;
    
        // 隐藏所有 .tab-pane
        document.querySelectorAll('.tab-pane').forEach(pane => {
          pane.classList.remove('show', 'active');
          pane.setAttribute('aria-hidden', 'true');
        });
    
        // 显示目标 .tab-pane 并设为活跃
        const targetPane = document.querySelector(targetSelector);
        if (targetPane) {
          targetPane.classList.add('show', 'active');
          targetPane.setAttribute('aria-hidden', 'false');
        }
      });
    });
    ? 说明:此逻辑不依赖 Bootstrap 的 JS 插件,完全由原生代码控制,确保 aria-selected 和 aria-hidden 同步更新,符合无障碍(a11y)规范。

    ✅ 步骤二:确保 HTML 结构语义正确(无需修改你的现有结构)

    你已有的 <ul> 和 <div class="tab-pane"> 结构完全可用,只需保证:

    B12
    B12

    B12是一个由AI驱动的一体化网站建设平台

    下载
    • 每个 <button> 包含 data-bs-target="#xxx",且对应 #xxx 是唯一 ID;
    • 所有 .tab-pane 初始状态可为 fade + show active(首个默认展开),其余为 fade(无需 show active)。

    示例片段(保持不变):

    <!-- 首个默认激活 -->
    <div class="tab-pane fade show active" id="entertainment" role="tabpanel">...</div>
    <!-- 其余初始隐藏 -->
    <div class="tab-pane fade" id="infotainment" role="tabpanel">...</div>

    ✅ 步骤三:可选增强 —— CSS 样式微调(提升体验)

    /* 确保 nav-link 在 active 时视觉突出 */
    .nav-link.active {
      border-bottom: 2px solid #0d6efd;
      font-weight: 600;
    }
    
    /* 可选:为 tab-pane 添加淡入过渡 */
    .tab-pane {
      transition: opacity 0.2s ease-in-out;
    }
    .tab-pane.show {
      opacity: 1;
    }
    .tab-pane:not(.show) {
      opacity: 0;
    }

    ⚠️ 注意事项

    • 不要混用 Bootstrap JS 与手动逻辑:若同时引入 bootstrap.bundle.js 并启用 data-bs-toggle,可能造成事件冲突。推荐:禁用默认行为(移除 data-bs-toggle="tab"),完全交由上述脚本控制。
    • ID 唯一性必须严格保证:data-bs-target 指向的 ID 必须存在于 DOM 中且不重复。
    • 动态内容场景:若 .tab-pane 是后续 AJAX 插入的,需在插入后调用 initTabHandlers() 函数重新绑定(可封装为可复用函数)。

    ✅ 总结

    该方案以最小侵入方式实现了「点击导航项 → 高亮按钮 + 显示对应内容」的核心需求,兼顾语义化、可访问性与可维护性。无需 jQuery,纯原生 ES6+ 语法,适配现代浏览器及 Bootstrap 5 生态。调试时可通过浏览器开发者工具实时观察 class 和 aria-* 属性变化,快速验证逻辑正确性。

  • 热门AI工具

    更多
    DeepSeek
    DeepSeek

    幻方量化公司旗下的开源大模型平台

    豆包大模型
    豆包大模型

    字节跳动自主研发的一系列大型语言模型

    WorkBuddy
    WorkBuddy

    腾讯云推出的AI原生桌面智能体工作台

    腾讯元宝
    腾讯元宝

    腾讯混元平台推出的AI助手

    文心一言
    文心一言

    文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

    讯飞写作
    讯飞写作

    基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

    即梦AI
    即梦AI

    一站式AI创作平台,免费AI图片和视频生成。

    ChatGPT
    ChatGPT

    最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

    相关专题

    更多
    jquery插件有哪些
    jquery插件有哪些

    jquery插件有jQuery UI、jQuery Validate、jQuery DataTables、jQuery Slick、jQuery LazyLoad、jQuery Countdown、jQuery Lightbox、jQuery FullCalendar、jQuery Chosen和jQuery EasyUI等。本专题为大家提供jquery插件相关的文章、下载、课程内容,供大家免费下载体验。

    156

    2023.09.12

    jquery怎么操作json
    jquery怎么操作json

    操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

    337

    2023.10.13

    jquery删除元素的方法
    jquery删除元素的方法

    jquery可以通过.remove() 方法、 .detach() 方法、.empty() 方法、.unwrap() 方法、.replaceWith() 方法、.html('') 方法和.hide() 方法来删除元素。更多关于jquery相关的问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

    406

    2023.11.10

    jQuery hover()方法的使用
    jQuery hover()方法的使用

    hover()是jQuery中一个常用的方法,它用于绑定两个事件处理函数,这两个函数将在鼠标指针进入和离开匹配的元素时执行。想了解更多hover()的相关内容,可以阅读本专题下面的文章。

    516

    2023.12.04

    jquery实现分页方法
    jquery实现分页方法

    在jQuery中实现分页可以使用插件或者自定义实现。想了解更多jquery分页的相关内容,可以阅读本专题下面的文章。

    312

    2023.12.06

    jquery中隐藏元素是什么
    jquery中隐藏元素是什么

    jquery中隐藏元素是非常重要的一个概念,在使用jquery隐藏元素之前,需要先了解css样式中关于元素隐藏的属性,比如display、visibility、opacity等属性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

    129

    2024.02.23

    jquery中什么是高亮显示
    jquery中什么是高亮显示

    jquery中高亮显示是指对页面搜索关键词时进行高亮显示,其实现办法:1、先获取要高亮显示的行,获取搜索的内容,再遍历整行内容,最后添加高亮颜色;2、使用“jquery highlight”高亮插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

    184

    2024.02.23

    jQuery 正则表达式相关教程
    jQuery 正则表达式相关教程

    本专题整合了jQuery正则表达式相关教程大全,阅读专题下面的文章了解更多详细内容。

    51

    2026.01.13

    TypeScript类型系统进阶与大型前端项目实践
    TypeScript类型系统进阶与大型前端项目实践

    本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

    69

    2026.03.13

    热门下载

    更多
    网站特效
    /
    网站源码
    /
    网站素材
    /
    前端模板

    精品课程

    更多
    相关推荐
    /
    热门推荐
    /
    最新课程
    Sass 教程
    Sass 教程

    共14课时 | 0.9万人学习

    Bootstrap 5教程
    Bootstrap 5教程

    共46课时 | 3.6万人学习

    CSS教程
    CSS教程

    共754课时 | 43.6万人学习

    关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
    php中文网:公益在线php培训,帮助PHP学习者快速成长!
    关注服务号 技术交流群
    PHP中文网订阅号
    每天精选资源文章推送

    Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号