Switch

在开启与关闭之间切换，适合需要即时生效的设置和功能开关。

我们正在让 SnowUI 组件成为 AI 对话中可直接操作的界面。目前对话交互能力仍在建设中；本页展示网站用法，支持的对话平台与组件版本将在验证后公布。 AI 对话内生成和使用 SnowUI 界面完全免费，不属于项目，不占项目或开发者席位额度，无需 SnowUI 注册、激活或付费证明。

如何使用

用于立即生效的二态设置。表单多选使用 Checkbox，互斥参数组使用 Radio 或 Segmented。

bind:checked 同步开关状态；value 只表示内部输入值，不决定开关状态。
当前 name / form 不转发给内部 input；需要原生表单提交时由表单层显式同步字段。提供可读标签。

导入

import { Switch } from '@snowui-design-system/components';

用法

选择

尺寸

禁用状态

颜色

API 参考

属性	类型	默认值	示例	描述
`checked`	`boolean`	`false`	`bind:checked={subscribed}`	开关状态，支持 `bind:checked`。点击标签或聚焦后按 Space 切换；绑定变量、可见轨道与原生输入状态同步。禁用时用户操作不改变状态。
`value`	`any`	`—`	`value="Components"`	传给内部原生 checkbox 的值，不决定开关状态，也不建立选择组。当前 `name` / `form` 等其余属性传给外层标签，不转发至内部 input，因此仅设置 `value` 不会产生具名表单提交项。
`size`	`ResourceSize \| number`	`—`	`size={24}`	可见轨道高度，数字按根字号为 16px 时的名义 px 解析，外侧留白另计。支持 12 / 16 / 20 / 24 / 28 / 32 / 40 / 48 / 80 及其它有限正数；未传时依次读取父级尺寸 Context 的 `iconSize`、`size`，最后回退到 16。非法数字回退到默认尺寸 Token。显式值优先，随根字号缩放。
`disabled`	`boolean`	`false`	`disabled`	禁用原生输入及用户切换，保留当前开关值和标签，退出 Tab 顺序。外部仍可更新 `checked`。
`children`	`Snippet`	`—`	`<Switch>Components</Switch>`	无参数标签内容，显示在轨道后；省略时不显示标签。标签文字同时为内部开关提供可访问名称，可通过内容 Snippet 组合文本。
`singleLine`	`boolean`	`true`	`singleLine`	默认标签与控件保持单行，附件不压缩；窄宽时原始标签可省略显示并保留完整可访问名称，不复制 children。复杂多行内容可显式设为 false，由该内容拥有布局。需要全文提示时组合 Text lines={1}。
`gap`	`number`	`—`	`gap={42}`	继承 Frame 的间距 Token 序号；省略时使用原组件间距，显式值覆盖组件间距。有效间距至少 4 CSS px，包含零值、根字号及 gap-scale 缩放；较大首选值保留。
`enableResponsive`	`boolean`	`false`	`enableResponsive`	传给根 Frame，启用其容器内容适配监听；不改变 Switch 的标准尺寸值域。通用行为见 Frame 能力开关。
`enableContext`	`boolean`	`false`	`enableContext`	传给根 Frame，控制向子组件提供状态、加载与动效等 Context；不控制 Switch 读取父级尺寸 Context。通用行为见 Frame 能力开关。