Switch 开关
即时开启或关闭某项设置。
基础用法
使用开关切换开启和关闭状态,并提供关联名称。
basic.tsx
示例
禁用与加载
disabled 禁用交互。保存期间设置 loading 可阻止重复操作,异步请求由应用处理。
禁用加载
states.tsx
尺寸
通过 size 设置开关尺寸。
小中大
sizes.tsx
受控状态
通过 checked 控制状态,在 onChange 中从 event.target.checked 读取布尔值。
邮件通知已开启
controlled.tsx
设置 name 后,已开启且未禁用的开关提交其 value;未开启、禁用或加载时不参与提交。非受控开关在表单重置时恢复 defaultChecked,受控开关需要同步重置应用状态。
API
Switch API
配置开关的选中状态、提交字段与交互状态。
支持 name、value、required、form 等原生 checkbox 属性。通过文字或 aria-label 提供名称;className 和 style 作用于标签容器。