Switch 开关
表单控件
开关选择器,代表两种状态之间的切换,比 Checkbox 更直观的开关形态。
何时使用
两种状态之间的切换,典型用于开/关、启用/禁用。
代码示例
基础用法
tsx
import { Switch } from "@/components/ui/switch"
export function Basic() {
return <Switch />
}状态
tsx
<Switch>Normal</Switch>
<Switch disabled>Disabled</Switch>API / Props
Switch
| Prop | Type | Default | 说明 |
|---|---|---|---|
className | string | — | 自定义样式类名 |
| ...rest | React.HTMLAttributes | — | 透传原生 DOM 属性 |
注意事项
- Client Component: 使用
"use client",依赖 React hooks/状态,需在客户端渲染。 - Base UI: 基于
@base-ui/react无头(headless)原语构建,无障碍(a11y)开箱即用。
📘 完整交互式示例与控件属性请查看 Storybook 文档。