本教程详细介绍了如何利用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免费学习笔记（深入）”；
-
初始状态设置: 如果希望侧边栏在页面加载时默认是隐藏的，可以在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)); }; // ...
总结
通过上述步骤，您已经成功创建了一个使用JavaScript和Bootstrap控制侧边栏显示/隐藏的按钮。这种方法简单直接，适用于快速实现交互功能。在实际项目中，可以根据需求进一步优化，例如引入CSS过渡动画、使用CSS类进行状态管理或更完善的可访问性支持，以构建更健壮和用户友好的界面。