Toggle 开关

开关选择器,用于两个值之间的选择。

获取组件

import { Toggle } from 'rsuite';

// or
import Toggle from 'rsuite/Toggle';

演示

默认

开关尺寸

size 属性设置开关尺寸, 值包括: lgmdsm

文字和图标

可以通过 checkedChildren,unCheckedChildren 两个属性分别设置开关两种状态下显示的内容

禁用与只读

加载中

无障碍设计

  • Toggle 具有 switch role 。
  • 当处于 on 状态时,Togglearia-checked 设置为 true
  • 当处于 off 状态时,Togglearia-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 非选中显示的内容
Vercel banner