萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

原生 JavaScript 實現銀灰色垂直摺疊側邊欄導航菜單

前言

垂直摺疊側邊欄是後台管理系統、文檔站點常見的導航模式。本文將經典的「銀灰色豎排摺疊菜單」重構為現代化實現:語義化 HTML5、CSS3 動畫、原生 JS 模組化控制、無依賴、響應式適配、無障礙訪問支持。摒棄了原代碼中的表格佈局、內聯樣式、全局函數、IE 專有屬性(scrollbar-*)等歷史包袱。

核心功能特性

  • 多級摺疊:支持無限層級巢狀菜單
  • 平滑動畫:CSS3 max-height + transition 實現流暢展開/收合
  • 狀態持久化:localStorage 記憶用戶展開偏好
  • 鍵盤導航:完整支持 Tab/Enter/Space/方向鍵操作
  • 響應式:移動端自動轉為抽屜式側邊欄
  • 無障礙:ARIA 屬性、語義化結構、焦點管理

HTML 結構(語義化、無障礙)

<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>

CSS3 樣式系統(變量驅動、BEM 命名)

: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; }
}

JavaScript 模組化控制器

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 無障礙。代碼結構清晰,易於擴展圖標庫、權限控制、國際化等業務需求,是後台系統導航的最佳實踐基礎。

copyright © 萬盛學電腦網 all rights reserved