本教程详细介绍了如何利用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类进行状态管理或更完善的可访问性支持，以构建更健壮和用户友好的界面。
