使用J*aScript和Bootstrap实现可切换侧边栏的按钮

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

使用J*aScript和Bootstrap实现可切换侧边栏的按钮

2025-10-28

浏览次数：次

返回列表

使用JavaScript和Bootstrap实现可切换侧边栏的按钮

本教程详细介绍了如何利用html、bootstrap框架以及纯j*ascript创建一个可切换显示/隐藏的侧边栏按钮。通过识别关键dom元素并编写简洁的事件监听器，您可以轻松实现一个交互式侧边导航菜单，提升用户界面的灵活性和用户体验。

侧边栏是现代网页设计中常见的导航元素，它能有效地组织内容并节省屏幕空间。为了提供更好的用户体验，通常需要一个按钮来控制侧边栏的显示与隐藏。本文将指导您如何使用HTML、Bootstrap和J*aScript实现这一功能。

HTML 结构准备

首先，我们需要准备侧边栏和切换按钮的HTML结构。确保侧边栏和按钮都具有唯一的id属性，以便J*aScript能够准确地选中它们。在本例中，侧边栏的id为sidebar，切换按钮的id为menu-toggle。我们使用Bootstrap的布局类来构建基本的页面结构。

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>可切换侧边栏示例</title>
  <!-- 引入Bootstrap CSS -->
  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.0.2/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-EVSTQN3/azprG1Anm3QDgpJLIm9Nao0Yz1ztcQTwFspd3yD65VohhpuuCOmLASjC" crossorigin="anonymous">
  <!-- 引入Font Awesome图标库 -->
  <script src="https://kit.fontawesome.com/60bf89e922.js" crossorigin="anonymous"></script>
  <style>
    /* 可选：为侧边栏添加过渡效果，使其切换更平滑 */
    .sidebar {
      transition: all 0.3s ease-in-out;
    }
    /* 如果希望侧边栏初始状态为隐藏，可以在此处设置 */
    /* #sidebar { display: none; } */
  </style>
</head>
<body>

  <header class="header row">
    <div class="d-flex justify-content-between">
      <div id="logo" class="pb-2 ps-2 pe-0 col-2">
        @@##@@
        <!-- 侧边栏切换按钮，通过id 'menu-toggle' 识别 -->
        <a href="#" class="sidebar-toggler flex-shrink-0" id="menu-toggle">
          <i class="fa-solid fa-angle-left py-4 pe-2"></i>
        </a>
      </div>
    </div>
  </header>

  <div class="body row">
    <!-- 侧边栏容器，通过id 'sidebar' 识别 -->
    <div class="sidebar col-2" id="sidebar">
      <div class="n*bar-n* w-100">
        <div class="n*-item dropdown">
          <a href="#" class="n*-link dropdown-toggle" data-bs-toggle="dropdown"><i class="fa fa-laptop me-2"></i>Admin</a>
          <div class="dropdown-menu bg-transparent border-0">
            <a href="#" class="dropdown-item">A</a>
            <a href="#" class="dropdown-item">B</a>
            <a href="#" class="dropdown-item">C</a>
          </div>
        </div>
        <a href="#" class="n*-item n*-link"><i class="fa fa-th me-2"></i>Cập nhật PO</a>
        <a href="#" class="n*-item n*-link"><i class="fa fa-keyboard me-2"></i>Phân loại PO</a>
        <a href="#" class="n*-item n*-link"><i class="fa fa-chart-bar me-2"></i>Ước tính rebate</a>
        <a href="#" class="n*-item n*-link"><i class="fa fa-tachometer-alt me-2"></i>Cập nhật rebate</a>
        <a href="#" class="n*-item n*-link"><i class="fa fa-tachometer-alt me-2"></i>Báo cáo</a>
        <a href="#" class="n*-item n*-link"><i class="fa fa-tachometer-alt me-2"></i>Tra cứu thông tin</a>
        <a href="#" class="n*-item n*-link"><i class="fa fa-tachometer-alt me-2"></i>Hướng dẫn sử dụng</a>
      </div>
    </div>
    <!-- 主内容区域 -->
    <div class="content col-10"> Content </div>
  </div>

  <!-- J*aScript代码应放在body结束标签之前 -->
  <script>
    // 确保DOM内容完全加载后再执行脚本
    document.addEventListener('DOMContentLoaded', function() {
      const menuToggle = document.querySelector('#menu-toggle');
      const sidebar = document.querySelector('#sidebar');

      // 为切换按钮添加点击事件监听器
      menuToggle.onclick = function(e) {
        e.preventDefault(); // 阻止a标签默认的跳转行为

        // 检查侧边栏当前的display样式
        if (sidebar.style.display !== 'none') {
          sidebar.style.display = 'none'; // 如果不是隐藏状态，则将其隐藏
        } else {
          sidebar.style.display = 'block'; // 如果是隐藏状态，则将其显示
        }
      };
    });
  </script>

</body>
</html>

J*aScript 切换逻辑

核心功能通过一段简洁的J*aScript代码实现。这段代码监听切换按钮的点击事件，并根据侧边栏当前的显示状态来切换其display样式属性。

获取元素引用： 使用document.querySelector()方法获取侧边栏元素（通过#sidebar）和切换按钮元素（通过#menu-toggle）。
添加事件监听器： 为切换按钮的onclick事件绑定一个处理函数。为了确保脚本在DOM加载完成后执行，我们将其包裹在DOMContentLoaded事件监听器中。
切换显示状态： 在事件处理函数内部，通过检查sidebar.style.display的值来判断侧边栏当前是显示还是隐藏。
- 如果display不为'none'（即侧边栏可见），则将其设置为'none'以隐藏。
- 否则（即侧边栏已隐藏），则将其设置为'block'以显示。
阻止默认行为： 由于切换按钮是一个标签，其默认行为是跳转。e.preventDefault()用于阻止这一默认行为，确保点击按钮只执行侧边栏切换逻辑。

注意事项与优化

CSS Class 切换（推荐）: 直接操作style.display虽然简单，但在更复杂的场景（如需要动画效果或维护多种状态）下可能不够灵活。更推荐的做法是通过J*aScript添加或移除CSS类。例如，可以定义一个.sidebar-hidden { display: none; }类，然后使用sidebar.classList.toggle('sidebar-hidden')来切换。这样可以将样式与行为分离，提高代码的可维护性和可扩展性。
初始状态设置: 如果希望侧边栏在页面加载时默认是隐藏的，可以在CSS中为#sidebar元素添加display: none;样式。
小爱开放平台
小米旗下小爱开放平台
291 查看详情
响应式设计: 结合Bootstrap的响应式工具类（如d-none d-lg-block），可以根据屏幕尺寸动态调整侧边栏的可见性，提供更佳的移动端体验。例如，在小屏幕上默认隐藏侧边栏，在大屏幕上默认显示。

可访问性 (Accessibility): 为了提高网页的可访问性，建议为切换按钮添加aria-expanded和aria-controls等ARIA属性，并在J*aScript中根据侧边栏的显示状态动态更新这些属性。例如：

// ...
menuToggle.setAttribute('aria-controls', 'sidebar');
let isSidebarExpanded = true; // 假设初始是展开的
menuToggle.setAttribute('aria-expanded', String(isSidebarExpanded));

menuToggle.onclick = function(e) {
  e.preventDefault();
  isSidebarExpanded = !isSidebarExpanded;
  sidebar.style.display = isSidebarExpanded ? 'block' : 'none';
  menuToggle.setAttribute('aria-expanded', String(isSidebarExpanded));
};
// ...