mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-04 08:59:40 +08:00
27 lines
928 B
Markdown
27 lines
928 B
Markdown
---
|
|
category: Components
|
|
chinese: 开关
|
|
type: Form Control
|
|
english: Switch
|
|
---
|
|
|
|
开关选择器。
|
|
|
|
## 何时使用
|
|
|
|
- 需要表示开关状态/两种状态之间的切换时；
|
|
- 和 `checkbox `的区别是，切换 `switch` 会直接触发状态改变，而 `checkbox` 一般用于状态标记，需要和提交操作配合。
|
|
|
|
## API
|
|
|
|
### Switch
|
|
|
|
| 参数 | 说明 | 类型 | 可选值 |默认值 |
|
|
|-----------|------------------------------------------|------------|-------|--------|
|
|
| checked | 指定当前是否选中 | boolean | | false |
|
|
| defaultChecked | 初始是否选中 | boolean | | false |
|
|
| onChange | 变化时回调函数 | Function(checked:boolean) | | |
|
|
| checkedChildren | 选中时的内容 | React Node | | |
|
|
| unCheckedChildren | 非选中时的内容 | React Node | | |
|
|
| size | 开关大小 | string | 'default' or 'small' | 'default' |
|