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/switch.md.
v0.0.57
  • 简体中文
  • Switch

    数据录入@rockshin/tao-ui

    立即切换一个布尔设置,并展示当前开关状态。

    何时使用

    设置可立即生效且不需要额外提交时使用 Switch。

    推荐

    • 标签描述开启后的状态。
    • 异步切换期间使用 loading。

    避免

    • 需要提交确认或选择多个值时不要使用 Switch。

    代码演示

    基础用法

    TSX

    标签与尺寸

    TSX

    加载与禁用状态

    TSX

    受控开关

    onChange 返回布尔值,可直接与设置状态同步。

    Notifications enabled
    TSX

    加载期间禁止重复切换

    使用独立按钮切换 loading,观察开关的等待状态。

    TSX

    状态文字与尺寸

    简短文字适合双态开关,大小尺寸都应保持完整可读。

    TSX

    共享尺寸与禁用

    多个开关可继承配置,局部 disabled 可以覆盖。

    TSX

    API

    Switch

    属性说明类型默认值
    disabled是否禁用boolean | undefined-
    className节点类名string | undefined-
    style节点样式CSSProperties | undefined-