Collapse
数据展示
@rockshin/tao-ui折叠面板,内置标题、展开图标与内容区域;支持独立展开和手风琴。
何时使用
用于组织设置、说明和次要详情。需要只展开一个面板时设置 accordion;必填信息应有明确的展开提示。
代码演示
基础面板
传入 items 即可使用完整面板。默认允许多个面板同时展开。
集中查看项目的目标、进度与最近变更。
手风琴
一次只展开一个面板,再次点击当前面板可收起全部内容。
集中查看项目的目标、进度与最近变更。
受控展开
使用 activeKey 和 onChange 协调展开状态,回调始终返回字符串 key 数组。
集中查看项目的目标、进度与最近变更。
三种尺寸
支持 small、medium 和 large,也继承 TaoProvider 的 size。
集中查看项目的目标、进度与最近变更。
集中查看项目的目标、进度与最近变更。
集中查看项目的目标、进度与最近变更。
无边框与透明背景
bordered={false} 去掉外边框;ghost 同时去掉背景与分隔线。
集中查看项目的目标、进度与最近变更。
集中查看项目的目标、进度与最近变更。
触发方式与禁用
可以点击整个标题行、仅点击图标,或禁用单个面板。隐藏箭头时仍可点击标题。
仅图标点击
额外操作与右侧图标
extra 放置独立操作,点击它不会改变面板展开状态。
嵌套面板与自定义图标
内外层独立管理状态;自定义图标根据 isActive 显示展开状态。
内容保留与销毁
默认首次展开才挂载内容,收起后保留输入。destroyOnHidden 可在收起时销毁内容;item 的 forceRender 会始终保留挂载。
手机中的折叠面板
长标题自然换行,图标和操作区保持可点击。手机与桌面选择使用全局预览状态。
迁移与组合式用法
从旧版本迁移时,将 Collapsible / @rockshin/tao-ui/collapsible 改为 Collapse / @rockshin/tao-ui/collapse。推荐用 items 替代手写标题和内容;组合式 Collapse.Trigger / Collapse.Content 仍可用于自定义单区块,配合 open / onOpenChange。面板模式使用 activeKey / onChange,两种状态接口不要混用。