Accordion 折叠面板

实时预览

引入

<link rel="stylesheet" href="/tokens/tokens.css">
<link rel="stylesheet" href="/components/accordion/accordion.css">

代码

HTML

<!-- Accordion Component — 折叠面板组件，支持 default 和 bordered 两种变体 -->


<!-- Demo: Accordion 组件 -->
<div style="display: flex; flex-direction: column; gap: 32px; padding: 20px; max-width: 600px;">
  <!-- 基础折叠面板 -->
  <div>
    <h4 style="margin: 0 0 12px 0; font-size: var(--text-sm); color: var(--color-text-secondary);">基础折叠面板</h4>
    <div class="accordion">
      <div class="accordion__item accordion__item--open">
        <button class="accordion__header">
          <span>什么是设计系统？</span>
          <svg class="accordion__icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
            <path d="M6 9l6 6 6-6"></path>
          </svg>
        </button>
        <div class="accordion__content" style="max-height: 200px;">
          <div class="accordion__body">
            设计系统是一套完整的标准，用于管理设计规模。它由实际可交付的组件和模式组成，以及将它们联系在一起的原则、价值观和实践。设计系统使团队能够为用户构建一致的、以品牌为中心的体验。
          </div>
        </div>
      </div>
      <div class="accordion__item">
        <button class="accordion__header">
          <span>设计系统的好处是什么？</span>
          <svg class="accordion__icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
            <path d="M6 9l6 6 6-6"></path>
          </svg>
        </button>
        <div class="accordion__content">
          <div class="accordion__body">
            设计系统提供了许多好处，包括：提高设计和开发效率、确保品牌一致性、改善团队协作、简化维护流程，以及提升用户体验。
          </div>
        </div>
      </div>
      <div class="accordion__item">
        <button class="accordion__header">
          <span>如何开始构建设计系统？</span>
          <svg class="accordion__icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
            <path d="M6 9l6 6 6-6"></path>
          </svg>
        </button>
        <div class="accordion__content">
          <div class="accordion__body">
            构建设计系统的第一步是审计现有的设计和代码。然后定义设计原则和价值观，建立设计令牌，创建组件库，最后文档化和推广设计系统。
          </div>
        </div>
      </div>
    </div>
  </div>

  <!-- 带边框折叠面板 -->
  <div>
    <h4 style="margin: 0 0 12px 0; font-size: var(--text-sm); color: var(--color-text-secondary);">带边框折叠面板</h4>
    <div class="accordion accordion--bordered">
      <div class="accordion__item">
        <button class="accordion__header">
          <span>账户设置</span>
          <svg class="accordion__icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
            <path d="M6 9l6 6 6-6"></path>
          </svg>
        </button>
        <div class="accordion__content">
          <div class="accordion__body">
            管理您的账户信息、密码设置、隐私选项和通知偏好。
          </div>
        </div>
      </div>
      <div class="accordion__item">
        <button class="accordion__header">
          <span>隐私与安全</span>
          <svg class="accordion__icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
            <path d="M6 9l6 6 6-6"></path>
          </svg>
        </button>
        <div class="accordion__content">
          <div class="accordion__body">
            配置两步验证、查看登录活动、管理设备授权和数据下载。
          </div>
        </div>
      </div>
      <div class="accordion__item">
        <button class="accordion__header">
          <span>支付方式</span>
          <svg class="accordion__icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
            <path d="M6 9l6 6 6-6"></path>
          </svg>
        </button>
        <div class="accordion__content">
          <div class="accordion__body">
            添加、编辑或删除支付方式，查看账单历史和下载发票。
          </div>
        </div>
      </div>
    </div>
  </div>
</div>

<script>
// Accordion 交互逻辑
document.addEventListener('DOMContentLoaded', function() {
  const accordions = document.querySelectorAll('.accordion');
  
  accordions.forEach(accordion => {
    const items = accordion.querySelectorAll('.accordion__item');
    
    items.forEach(item => {
      const header = item.querySelector('.accordion__header');
      const content = item.querySelector('.accordion__content');
      const body = item.querySelector('.accordion__body');
      
      // 跳过禁用项
      if (item.classList.contains('accordion__item--disabled')) {
        return;
      }
      
      header.addEventListener('click', function() {
        const isOpen = item.classList.contains('accordion__item--open');
        
        // 如果是手风琴模式（一次只能打开一个）
        if (accordion.classList.contains('accordion--exclusive')) {
          items.forEach(otherItem => {
            if (otherItem !== item && otherItem.classList.contains('accordion__item--open')) {
              otherItem.classList.remove('accordion__item--open');
              const otherContent = otherItem.querySelector('.accordion__content');
              otherContent.style.maxHeight = '0';
            }
          });
        }
        
        // 切换当前项
        item.classList.toggle('accordion__item--open');
        
        if (!isOpen) {
          // 展开
          content.style.maxHeight = body.scrollHeight + 'px';
        } else {
          // 折叠
          content.style.maxHeight = '0';
        }
      });
    });
  });
});
</script>

CSS

/* Accordion.css */
.accordion {
  width: 100%;
  border-radius: var(--radius-md);
  overflow: hidden;
}

.accordion__item {
  border-bottom: 1px solid var(--color-border);
}

.accordion__item:last-child {
  border-bottom: none;
}

.accordion__header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  width: 100%;
  padding: var(--space-4) var(--space-5);
  background-color: var(--color-surface);
  border: none;
  cursor: pointer;
  text-align: left;
  font-family: var(--font-sans);
  font-size: var(--text-base);
  font-weight: var(--weight-medium);
  color: var(--color-text);
  transition: background-color var(--duration-fast) var(--ease-default);
}

.accordion__header:hover {
  background-color: var(--color-bg-subtle);
}

.accordion__header:focus-visible {
  outline: 2px solid var(--color-primary);
  outline-offset: -2px;
}

.accordion__icon {
  width: 20px;
  height: 20px;
  transition: transform var(--duration-normal) var(--ease-default);
  color: var(--color-text-secondary);
}

.accordion__item--open .accordion__icon {
  transform: rotate(180deg);
}

.accordion__content {
  max-height: 0;
  overflow: hidden;
  transition: max-height var(--duration-normal) var(--ease-default);
}

.accordion__body {
  padding: var(--space-4) var(--space-5);
  background-color: var(--color-bg-subtle);
  color: var(--color-text-secondary);
  font-size: var(--text-sm);
  line-height: var(--leading-relaxed);
}

/* 带边框变体 */
.accordion--bordered {
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
}

.accordion--bordered .accordion__item {
  border-bottom: 1px solid var(--color-border);
}

.accordion--bordered .accordion__header {
  background-color: transparent;
}

.accordion--bordered .accordion__body {
  background-color: transparent;
  border-top: 1px solid var(--color-border);
}

/* 禁用状态 */
.accordion__item--disabled .accordion__header {
  opacity: 0.5;
  cursor: not-allowed;
}

/* 箭头图标 */
.accordion__arrow {
  width: 16px;
  height: 16px;
  border: solid var(--color-text-secondary);
  border-width: 0 2px 2px 0;
  padding: 3px;
  transform: rotate(45deg);
  transition: transform var(--duration-normal) var(--ease-default);
  margin-left: var(--space-2);
}

.accordion__item--open .accordion__arrow {
  transform: rotate(-135deg);
}

AI 使用说明

组件名: accordion
选择器: .accordion
依赖: /tokens/tokens.css
文件: /components/accordion/accordion.html