使用JavaScript和Bootstrap实现可切换侧边栏的按钮-html教程-PHP中文网

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

霞舞

发布： 2025-10-28 10:41:22

原创

720人浏览过

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

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

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

HTML 结构准备

首先，我们需要准备侧边栏和切换按钮的HTML结构。确保侧边栏和按钮都具有唯一的id属性，以便JavaScript能够准确地选中它们。在本例中，侧边栏的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">
        <img class="float-start py-2 ps-2 pe-2" src="assets/img/unknown.png" alt="Logo">
        <!-- 侧边栏切换按钮，通过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="navbar-nav w-100">
        <div class="nav-item dropdown">
          <a href="#" class="nav-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="nav-item nav-link"><i class="fa fa-th me-2"></i>Cập nhật PO</a>
        <a href="#" class="nav-item nav-link"><i class="fa fa-keyboard me-2"></i>Phân loại PO</a>
        <a href="#" class="nav-item nav-link"><i class="fa fa-chart-bar me-2"></i>Ước tính rebate</a>
        <a href="#" class="nav-item nav-link"><i class="fa fa-tachometer-alt me-2"></i>Cập nhật rebate</a>
        <a href="#" class="nav-item nav-link"><i class="fa fa-tachometer-alt me-2"></i>Báo cáo</a>
        <a href="#" class="nav-item nav-link"><i class="fa fa-tachometer-alt me-2"></i>Tra cứu thông tin</a>
        <a href="#" class="nav-item nav-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>

  <!-- JavaScript代码应放在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>

登录后复制

JavaScript 切换逻辑

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

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

注意事项与优化

CSS Class 切换（推荐）: 直接操作style.display虽然简单，但在更复杂的场景（如需要动画效果或维护多种状态）下可能不够灵活。更推荐的做法是通过JavaScript添加或移除CSS类。例如，可以定义一个.sidebar-hidden { display: none; }类，然后使用sidebar.classList.toggle('sidebar-hidden')来切换。这样可以将样式与行为分离，提高代码的可维护性和可扩展性。

立即学习“Java免费学习笔记（深入）”；

AppMall应用商店
AI应用商店，提供即时交付、按需付费的人工智能应用服务

56

查看详情
初始状态设置: 如果希望侧边栏在页面加载时默认是隐藏的，可以在CSS中为#sidebar元素添加display: none;样式。
响应式设计: 结合Bootstrap的响应式工具类（如d-none d-lg-block），可以根据屏幕尺寸动态调整侧边栏的可见性，提供更佳的移动端体验。例如，在小屏幕上默认隐藏侧边栏，在大屏幕上默认显示。

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

// ...
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));
};
// ...

登录后复制