展开与折叠组件版本 0.1.0

Collapsible 折叠区

控制单个辅助内容区域的展开状态,减少默认页面占用空间。

使用概览

适合使用

  • 高级选项、技术细节或次要说明需要按需展示时。

不建议使用

  • 内容是完成当前任务所必需,默认隐藏会造成遗漏时。

真实示例

高级设置折叠区

让用户按需显示次要的高级设置内容。

正在加载示例…

安装

本地候选警告Registry 地址仅指向当前本地文档站;npm 包也只用于本地候选验证,尚未公开发布。
pnpm dlx shadcn@4.16.0 add http://127.0.0.1:3000/r/collapsible.json

基础用法

导入

import { Collapsible, CollapsibleTrigger, CollapsibleContent } from "@richardqiu/quartz/collapsible";

JSX

<Collapsible defaultOpen><CollapsibleTrigger>高级设置</CollapsibleTrigger><CollapsibleContent>启用请求重试与调试日志。</CollapsibleContent></Collapsible>

状态与控制摘要

默认
键盘焦点可见
已禁用
已打开
已关闭
label · textactive · boolean

API 参考

属性类型默认值说明
openbooleanfalse受控指定内容区域当前是否展开。
onOpenChange(open: boolean) => void未设置在用户展开或收起内容时接收最新状态。

组合结构

  1. 01Collapsible
  2. 02CollapsibleTrigger
  3. 03CollapsibleContent

键盘约定

  • Enter 或空格键切换内容,关闭后焦点仍保留在触发器。

可访问性契约

  • 触发器暴露展开状态并控制内容区域,禁用时不能展开。
  • 关闭内容会离开可访问性树;减少或关闭动效时不执行空间插值。