For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/zh/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/zh/llms-full.txt, and this page is available as Markdown at https://rickyshin93.github.io/tao-ui/zh/components/collapse.md.
v0.0.57
  • 简体中文
  • Collapse

    数据展示@rockshin/tao-ui

    折叠面板,内置标题、展开图标与内容区域;支持独立展开和手风琴。

    何时使用

    用于组织设置、说明和次要详情。需要只展开一个面板时设置 accordion;必填信息应有明确的展开提示。

    代码演示

    基础面板

    传入 items 即可使用完整面板。默认允许多个面板同时展开。

    集中查看项目的目标、进度与最近变更。
    TSX

    手风琴

    一次只展开一个面板,再次点击当前面板可收起全部内容。

    集中查看项目的目标、进度与最近变更。
    TSX

    受控展开

    使用 activeKey 和 onChange 协调展开状态,回调始终返回字符串 key 数组。

    集中查看项目的目标、进度与最近变更。
    已展开: 1
    TSX

    三种尺寸

    支持 small、medium 和 large,也继承 TaoProvider 的 size。

    集中查看项目的目标、进度与最近变更。
    集中查看项目的目标、进度与最近变更。
    集中查看项目的目标、进度与最近变更。
    TSX

    无边框与透明背景

    bordered={false} 去掉外边框;ghost 同时去掉背景与分隔线。

    集中查看项目的目标、进度与最近变更。
    集中查看项目的目标、进度与最近变更。
    TSX

    触发方式与禁用

    可以点击整个标题行、仅点击图标,或禁用单个面板。隐藏箭头时仍可点击标题。

    仅图标点击
    TSX

    额外操作与右侧图标

    extra 放置独立操作,点击它不会改变面板展开状态。

    编辑次数: 0
    TSX

    嵌套面板与自定义图标

    内外层独立管理状态;自定义图标根据 isActive 显示展开状态。

    TSX

    内容保留与销毁

    默认首次展开才挂载内容,收起后保留输入。destroyOnHidden 可在收起时销毁内容;item 的 forceRender 会始终保留挂载。

    TSX

    手机中的折叠面板

    长标题自然换行,图标和操作区保持可点击。手机与桌面选择使用全局预览状态。

    390 × 640
    TSX

    迁移与组合式用法

    从旧版本迁移时,将 Collapsible / @rockshin/tao-ui/collapsible 改为 Collapse / @rockshin/tao-ui/collapse。推荐用 items 替代手写标题和内容;组合式 Collapse.Trigger / Collapse.Content 仍可用于自定义单区块,配合 open / onOpenChange。面板模式使用 activeKey / onChange,两种状态接口不要混用。

    API

    Collapse

    属性说明类型默认值
    itemsComplete panels with built-in headers, icons and content styling.CollapseItem[] | undefined-
    onChangeCalled with normalized string keys, including in accordion mode.((activeKeys: string[]) => void) | undefined-
    accordionAllow at most one active panel; clicking it again closes it.boolean | undefined-
    destroyOnHiddenUnmount closed bodies unless the item has forceRender.boolean | undefined-
    openControlled open state.boolean | undefined-
    defaultOpenUncontrolled initial open state. Defaults to false.boolean | undefined-
    disabledDisable the trigger. Falls back to TaoProvider's disabled.boolean | undefined-
    classNameMerged into the root element.string | undefined-
    style节点样式CSSProperties | undefined-

    Collapse.Trigger

    属性说明类型默认值
    asChildRender the child element as the trigger instead of a default button.boolean | undefined-
    className节点类名string | undefined-
    style节点样式CSSProperties | undefined-

    Collapse.Content

    属性说明类型默认值
    className节点类名string | undefined-
    style节点样式CSSProperties | undefined-

    CollapseItem

    属性说明
    key唯一的 string / number key;回调统一为字符串
    label / children标题与内容
    extra独立的标题操作区
    collapsibleheader / icon / disabled
    showArrow默认 true;不能同时设置 false 与 collapsible="icon"
    forceRender默认 false;预先挂载并保留内容
    className / style面板容器样式
    classNames / stylesheader 与 body 的语义样式;覆盖组级同名值