---
category: Components
chinese: 开关
type: Form Controls
english: Switch
---

开关选择器。

## 何时使用

- 需要表示开关状态/两种状态之间的切换时；
- 和 `checkbox `的区别是，切换 `switch` 会直接触发状态改变，而 `checkbox` 一般用于状态标记，需要和提交操作配合。

## API

### Switch

| 参数      | 说明                                     | 类型        |默认值 |
|-----------|------------------------------------------|------------|--------|
| checked | 指定当前是否选中 | Boolean    | false    |
| defaultChecked | 初始是否选中 | Boolean  | false |
| onChange | 变化时回调函数 | Function(checked:Boolean) |   |
| checkedChildren | 选中时的内容 | React Node |   |
| unCheckedChildren | 非选中时的内容 | React Node |  |
| size | 开关大小，可选值：`default` `small` | String  | default |