垂直摺疊側邊欄是後台管理系統、文檔站點常見的導航模式。本文將經典的「銀灰色豎排摺疊菜單」重構為現代化實現:語義化 HTML5、CSS3 動畫、原生 JS 模組化控制、無依賴、響應式適配、無障礙訪問支持。摒棄了原代碼中的表格佈局、內聯樣式、全局函數、IE 專有屬性(scrollbar-*)等歷史包袱。
max-height + transition 實現流暢展開/收合localStorage 記憶用戶展開偏好<nav id="sidebar" class="sidebar" role="navigation" aria-label="主導航">
<ul class="menu">
<li class="menu-item">
<button class="menu-toggle" aria-expanded="false" aria-controls="submenu-1">
<span class="menu-icon" aria-hidden="true">📁</span>
<span class="menu-text">產品管理</span>
<span class="menu-arrow" aria-hidden="true">▼</span>
</button>
<ul id="submenu-1" class="submenu" role="group" hidden>
<li><a href="/products" class="menu-link">產品列表</a></li>
<li><a href="/categories" class="menu-link">分類管理</a></li>
<li class="menu-item">
<button class="menu-toggle" aria-expanded="false" aria-controls="submenu-1-1">
<span class="menu-icon">📦</span>
<span class="menu-text">庫存管理</span>
<span class="menu-arrow">▼</span>
</button>
<ul id="submenu-1-1" class="submenu" role="group" hidden>
<li><a href="/stock" class="menu-link">庫存查詢</a></li>
<li><a href="/alerts" class="menu-link">預警設置</a></li>
</ul>
</li>
</ul>
</li>
<li><a href="/orders" class="menu-link"><span class="menu-icon">📋</span>訂單中心</a></li>
<li><a href="/users" class="menu-link"><span class="menu-icon">👥</span>用戶管理</a></li>
<li><a href="/settings" class="menu-link"><span class="menu-icon">⚙️</span>系統設置</a></li>
</ul>
</nav>
<main class="main-content">
<button id="mobileToggle" class="mobile-toggle" aria-label="切換側邊欄" aria-expanded="false">☰</button>
<div class="content">頁面主內容區域</div>
</main>
:root {
--sidebar-width: 240px;
--sidebar-bg: #f0f0f0;
--item-hover: #e4e4e4;
--item-active: #d0d0d0;
--border-color: #ccc;
--text-color: #333;
--text-hover: #d90000;
--transition: 0.3s ease;
--arrow-transition: 0.2s ease;
}
.sidebar {
position: fixed;
top: 0; left: 0; bottom: 0;
width: var(--sidebar-width);
background: var(--sidebar-bg);
border-right: 1px solid var(--border-color);
overflow-y: auto;
z-index: 100;
transform: translateX(0);
transition: transform var(--transition);
}
.menu, .submenu {
list-style: none;
padding: 0; margin: 0;
}
.menu-item { position: relative; }
.menu-toggle {
display: flex;
align-items: center;
width: 100%;
padding: 12px 16px;
background: transparent;
border: none;
border-bottom: 1px solid var(--border-color);
text-align: left;
cursor: pointer;
color: var(--text-color);
font: inherit;
font-weight: 500;
transition: background var(--transition);
}
.menu-toggle:hover { background: var(--item-hover); }
.menu-toggle[aria-expanded="true"] { background: var(--item-active); }
.menu-toggle[aria-expanded="true"] .menu-arrow { transform: rotate(180deg); }
.menu-icon { margin-right: 10px; font-size: 1.1em; }
.menu-arrow { margin-left: auto; transition: transform var(--arrow-transition); }
.submenu {
max-height: 0;
overflow: hidden;
background: #fafafa;
border-left: 3px solid #c0c0c0;
transition: max-height var(--transition), padding var(--transition);
padding-left: 0;
}
.submenu:not([hidden]) {
max-height: 500px; /* 足夠大的值 */
padding: 8px 0;
}
.menu-link {
display: flex;
align-items: center;
padding: 10px 16px 10px 40px;
color: var(--text-color);
text-decoration: none;
font-size: 0.95em;
transition: background var(--transition), color var(--transition);
}
.menu-link:hover {
background: var(--item-hover);
color: var(--text-hover);
}
/* 移動端抽屜模式 */
.mobile-toggle {
display: none;
position: fixed;
top: 16px; left: 16px;
z-index: 200;
padding: 8px 12px;
background: var(--sidebar-bg);
border: 1px solid var(--border-color);
border-radius: 4px;
font-size: 1.5rem;
cursor: pointer;
}
@media (max-width: 768px) {
.sidebar { transform: translateX(-100%); }
.sidebar.open { transform: translateX(0); }
.mobile-toggle { display: block; }
.main-content { margin-left: 0; }
}
const SidebarNav = (() => {
const STORAGE_KEY = 'sidebar_nav_state';
let sidebar, mobileToggle, mainContent;
// 狀態管理
const state = {
expandedIds: new Set(),
isMobileOpen: false
};
// DOM 就緒初始化
function init() {
sidebar = document.getElementById('sidebar');
mobileToggle = document.getElementById('mobileToggle');
mainContent = document.querySelector('.main-content');
loadState();
bindEvents();
applyState();
}
// 事件綁定
function bindEvents() {
// 摺疊按鈕點擊
sidebar.querySelectorAll('.menu-toggle').forEach(btn => {
btn.addEventListener('click', e => {
e.preventDefault();
const submenuId = btn.getAttribute('aria-controls');
toggleSubmenu(submenuId, btn);
});
// 鍵盤支持
btn.addEventListener('keydown', e => {
if (e.key === 'Enter' || e.key === ' ') {
e.preventDefault();
btn.click();
}
});
});
// 移動端切換
mobileToggle.addEventListener('click', () => {
state.isMobileOpen = !state.isMobileOpen;
sidebar.classList.toggle('open', state.isMobileOpen);
mobileToggle.setAttribute('aria-expanded', state.isMobileOpen);
});
// 點擊主內容關閉移動端側邊欄
mainContent.addEventListener('click', () => {
if (state.isMobileOpen) {
state.isMobileOpen = false;
sidebar.classList.remove('open');
mobileToggle.setAttribute('aria-expanded', 'false');
}
});
// ESC 關閉
document.addEventListener('keydown', e => {
if (e.key === 'Escape' && state.isMobileOpen) {
mobileToggle.click();
}
});
}
// 切換子菜單
function toggleSubmenu(id, btn) {
const submenu = document.getElementById(id);
if (!submenu) return;
const isExpanded = btn.getAttribute('aria-expanded') === 'true';
const newState = !isExpanded;
btn.setAttribute('aria-expanded', newState);
submenu.hidden = !newState;
if (newState) {
state.expandedIds.add(id);
} else {
state.expandedIds.delete(id);
// 遞歸關閉子孫菜單
closeDescendants(submenu);
}
saveState();
}
// 遞歸關閉後代菜單
function closeDescendants(parent) {
parent.querySelectorAll('.menu-toggle[aria-expanded="true"]').forEach(btn => {
const subId = btn.getAttribute('aria-controls');
btn.setAttribute('aria-expanded', 'false');
const sub = document.getElementById(subId);
if (sub) sub.hidden = true;
state.expandedIds.delete(subId);
});
}
// 本地存儲持久化
function saveState() {
try {
localStorage.setItem(STORAGE_KEY, JSON.stringify([...state.expandedIds]));
} catch (e) { /* 忽略存儲錯誤 */ }
}
function loadState() {
try {
const saved = localStorage.getItem(STORAGE_KEY);
if (saved) state.expandedIds = new Set(JSON.parse(saved));
} catch (e) { /* 忽略 */ }
}
function applyState() {
state.expandedIds.forEach(id => {
const btn = sidebar.querySelector(`[aria-controls="${id}"]`);
const sub = document.getElementById(id);
if (btn && sub) {
btn.setAttribute('aria-expanded', 'true');
sub.hidden = false;
}
});
}
// 公開 API
return { init, toggleSubmenu };
})();
// 啟動
document.addEventListener('DOMContentLoaded', SidebarNav.init);
| 舊版特徵 | 問題 | 現代替代方案 |
|---|---|---|
| <table> 佈局 | 語義錯誤、響應式困難、無障礙差 | <nav> + <ul>/<li> 語義化結構 |
| 內聯 onclick | 內容行為耦合、CSP 違規、難維護 | 事件委托 + addEventListener |
| IE scrollbar-* 屬性 | 非標準、僅 IE 支持、維護成本高 | 原生滾動條或自定義滾動條庫 |
| display:none 切換 | 無動畫、佈局抖動、無法過渡 | max-height + transition 動畫 |
| 全局函數 | 命名衝突、難測試、無模組化 | IIFE/ESM 模組封裝 |
現代側邊欄導航應建立在語義化 HTML、CSS3 動畫、模組化 JS、無障礙標準四大支柱之上。本文方案完全摒棄 jQuery 依賴,原生實現僅約 120 行 JS,gzip 後不足 3KB,卻提供企業級功能:多級摺疊、狀態記憶、鍵盤操作、響應式抽屜、ARIA 無障礙。代碼結構清晰,易於擴展圖標庫、權限控制、國際化等業務需求,是後台系統導航的最佳實踐基礎。