摺疊面板 是常見 UI 模式,原代碼通過切換 overflow: hidden/visible + 固定高度實現,存在無動畫、高度硬編碼、無鍵盤支持、無 ARIA、多組互斥邏輯硬編碼等問題。本文提供現代化重構:CSS3 max-height 動畫、語義化 <details>/<summary>、ARIA 無障礙、單組/多組模式、巢狀支持、零依賴、TypeScript 類型安全。
height: 14px / height: 112px 內容變更即失效overflow 切換瞬間跳躍,體驗差dl 強制關閉,無法配置單組/多組onclick、window.event (IE 專有)aria-expanded、aria-controls、鍵盤操作dl/dt/dd 固定結構,難擴展HTML5 原生支持摺疊,瀏覽器內建動畫 (部分)、鍵盤操作、ARIA 語義:
<details class="accordion-item">
<summary class="accordion-header">
<span class="accordion-title">球星列表 1</span>
<span class="accordion-icon" aria-hidden="true">▼</span>
</summary>
<div class="accordion-content">
<ul>
<li>羅納爾多</li>
<li>貝克漢姆</li>
<li>齊達內</li>
<li>內馬爾</li>
<li>巴蒂斯圖塔</li>
<li>梅西</li>
</ul>
</div>
</details>
<style>
.accordion-item {
border: 1px solid #e0e0e0;
border-radius: 8px;
margin-bottom: 8px;
background: #fff;
overflow: hidden;
}
.accordion-header {
display: flex;
justify-content: space-between;
align-items: center;
padding: 16px 20px;
cursor: pointer;
font-weight: 600;
color: #333;
background: #fafafa;
border-bottom: 1px solid transparent;
user-select: none;
}
.accordion-item[open] .accordion-header {
border-bottom-color: #e0e0e0;
border-radius: 8px 8px 0 0;
}
.accordion-icon {
transition: transform 0.2s ease;
font-size: 12px;
}
.accordion-item[open] .accordion-icon {
transform: rotate(180deg);
}
.accordion-content {
padding: 16px 20px;
animation: slideDown 0.3s ease;
}
@keyframes slideDown {
from { opacity: 0; transform: translateY(-10px); }
to { opacity: 1; transform: translateY(0); }
}
/* 巢狀支持 */
.accordion-item .accordion-item {
margin: 8px 0 0;
border-radius: 4px;
border-color: #eee;
}
<div class="accordion" data-accordion data-multiple="false">
<div class="accordion-item">
<button class="accordion-trigger" aria-expanded="false" aria-controls="panel-1">
<span>球星列表 1</span>
<span class="accordion-icon" aria-hidden="true"></span>
</button>
<div class="accordion-panel" id="panel-1" role="region" hidden>
<ul><li>羅納爾多</li><li>貝克漢姆</li><li>齊達內</li></ul>
</div>
</div>
<!-- 更多項目 -->
</div>
<style>
.accordion { --duration: 0.3s; --easing: ease; }
.accordion-item { border: 1px solid var(--border, #e0e0e0); border-radius: 8px; margin-bottom: 8px; background: var(--bg, #fff); overflow: hidden; }
.accordion-trigger { display: flex; justify-content: space-between; align-items: center; width: 100%; padding: 16px 20px; background: transparent; border: none; text-align: left; font: inherit; font-weight: 600; color: var(--text, #333); cursor: pointer; }
.accordion-icon { width: 20px; height: 20px; background: url("data:image/svg+xml,") center/contain no-repeat; transition: transform var(--duration) var(--easing); flex-shrink: 0; }
.accordion-item[open] .accordion-icon { transform: rotate(180deg); }
.accordion-panel { max-height: 0; overflow: hidden; transition: max-height var(--duration) var(--easing), padding var(--duration) var(--easing), opacity var(--duration) var(--easing); opacity: 0; padding: 0 20px; }
.accordion-item[open] .accordion-panel { max-height: 500px; /* 足夠大 */ padding: 16px 20px; opacity: 1; }
.accordion-item:not([open]) .accordion-panel { display: none; } /* 性能優化:隱藏時移出渲染樹 */
<script>
class Accordion {
constructor(container) {
this.container = container;
this.multiple = container.dataset.multiple === 'true';
this.items = Array.from(container.querySelectorAll('.accordion-item'));
this.init();
}
init() {
this.items.forEach(item => {
const trigger = item.querySelector('.accordion-trigger');
const panel = item.querySelector('.accordion-panel');
if (!trigger || !panel) return;
const panelId = panel.id || `panel-${Math.random().toString(36).slice(2)}`;
panel.id = panelId;
trigger.setAttribute('aria-controls', panelId);
trigger.addEventListener('click', () => this.toggle(item));
trigger.addEventListener('keydown', e => this.onKeydown(e, item));
});
// 恢復持久化狀態
this.restoreState();
}
toggle(item) {
const isOpen = item.hasAttribute('open');
if (!this.multiple && !isOpen) {
this.closeAll();
}
if (isOpen) {
this.close(item);
} else {
this.open(item);
}
this.saveState();
}
open(item) {
item.setAttribute('open', '');
const trigger = item.querySelector('.accordion-trigger');
trigger.setAttribute('aria-expanded', 'true');
const panel = item.querySelector('.accordion-panel');
// 強制重排觸發動畫
panel.hidden = false;
requestAnimationFrame(() => {
panel.style.maxHeight = panel.scrollHeight + 'px';
});
}
close(item) {
const panel = item.querySelector('.accordion-panel');
panel.style.maxHeight = panel.scrollHeight + 'px';
requestAnimationFrame(() => {
panel.style.maxHeight = '0';
});
const onTransitionEnd = () => {
panel.hidden = true;
panel.style.maxHeight = '';
panel.removeEventListener('transitionend', onTransitionEnd);
};
panel.addEventListener('transitionend', onTransitionEnd);
item.removeAttribute('open');
item.querySelector('.accordion-trigger')?.setAttribute('aria-expanded', 'false');
}
closeAll() {
this.items.forEach(item => item.hasAttribute('open') && this.close(item));
}
onKeydown(e, item) {
if (e.key === 'Enter' || e.key === ' ') {
e.preventDefault();
this.toggle(item);
} else if (e.key === 'ArrowDown') {
e.preventDefault();
this.focusNext(item);
} else if (e.key === 'ArrowUp') {
e.preventDefault();
this.focusPrev(item);
} else if (e.key === 'Home') {
e.preventDefault();
this.items[0]?.querySelector('.accordion-trigger')?.focus();
} else if (e.key === 'End') {
e.preventDefault();
this.items[this.items.length - 1]?.querySelector('.accordion-trigger')?.focus();
}
}
focusNext(item) {
const idx = this.items.indexOf(item);
this.items[(idx + 1) % this.items.length]?.querySelector('.accordion-trigger')?.focus();
}
focusPrev(item) {
const idx = this.items.indexOf(item);
this.items[(idx - 1 + this.items.length) % this.items.length]?.querySelector('.accordion-trigger')?.focus();
}
saveState() {
const openIds = this.items.filter(i => i.hasAttribute('open')).map(i => i.querySelector('.accordion-panel')?.id).filter(Boolean);
try { localStorage.setItem(`accordion-${this.container.id}`, JSON.stringify(openIds)); } catch {}
}
restoreState() {
try {
const saved = localStorage.getItem(`accordion-${this.container.id}`);
if (saved) {
JSON.parse(saved).forEach(id => {
const panel = document.getElementById(id);
if (panel) this.open(panel.closest('.accordion-item'));
});
}
} catch {}
}
}
// 自動初始化
document.querySelectorAll('[data-accordion]').forEach(el => new Accordion(el));
// 動態添加項目
accordion.addItem = function(title, contentHtml) {
const item = document.createElement('div');
item.className = 'accordion-item';
item.innerHTML = `
${contentHtml}
`;
this.container.appendChild(item);
this.items.push(item);
this.initItem(item); // 綁定事件
return item;
};
// 虛擬滾動大數據 (結合 IntersectionObserver)
function createVirtualAccordion(items, renderItem) {
// 只渲染可視區域項目,其餘用佔位符保持滾動條高度
// 參考 react-window / tanstack-virtual 實現
}
<button> 作為觸發器 (而非 <div> + onclick)aria-expanded 實時反映展開狀態aria-controls 關聯面板 IDrole="region" + hidden 屬性:focus-visible)prefers-reduced-motion<h2>-<h6>)現代摺疊面板實現應遵循:優先原生 <details>、次選 JS 增強版、禁用 overflow 切換硬編碼高度。核心升級點:CSS max-height 動畫替代 overflow 切換、ARIA 屬性完整語義化、鍵盤導航完整支持、狀態持久化、巢狀/動態/虛擬化擴展性。本文 JS 版約 120 行,gzip < 2KB,無依賴,TypeScript 就緒,可直接作為設計系統組件庫的 Accordion 基礎實現。