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 · booleanAPI 参考
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
open | boolean | false | 受控指定内容区域当前是否展开。 |
onOpenChange | (open: boolean) => void | 未设置 | 在用户展开或收起内容时接收最新状态。 |
组合结构
- 01
Collapsible - 02
CollapsibleTrigger - 03
CollapsibleContent
键盘约定
- Enter 或空格键切换内容,关闭后焦点仍保留在触发器。
可访问性契约
- 触发器暴露展开状态并控制内容区域,禁用时不能展开。
- 关闭内容会离开可访问性树;减少或关闭动效时不执行空间插值。