Toggle 开关
开关选择器,用于两个值之间的选择。
获取组件
import { Toggle } from 'rsuite';
// or
import Toggle from 'rsuite/Toggle';演示
默认
开关尺寸
size 属性设置开关尺寸, 值包括: lg、md、sm
文字和图标
可以通过 checkedChildren,unCheckedChildren 两个属性分别设置开关两种状态下显示的内容
禁用与只读
加载中
无障碍设计
Toggle具有switchrole 。- 当处于
on状态时,Toggle将aria-checked设置为true。 - 当处于
off状态时,Toggle将aria-checked设置为false。 - 所有表单控件都应该带有标签,在表单中可以通过
Form.ControlLabel实现。如果您需要独立使用则需要直接添加属性 (arial-label,aria-labelledby)。
<Toggle arial-label="Switch" />Props
<Toggle>
| 属性名称 | 类型 (默认值) |
描述 |
|---|---|---|
| checked | boolean | 指定当前是否选中 |
| checkedChildren | ReactNode | 选中显示的内容 |
| classPrefix | string ('toggle') |
组件 CSS 类的前缀 |
| defaultChecked | boolean | 初始是否选中 |
| disabled | boolean | 禁用 |
| loading | boolean | 是否展示一个圈圈表示选中状态正在获取/更新 |
| locale | ToggleLocaleType | 本地化的文本 |
| onChange | (checked: boolean, event) => void | 状态改变时的回调函数 |
| size | 'lg' | 'md' | 'sm' | 开关尺寸 |
| unCheckedChildren | ReactNode | 非选中显示的内容 |