Switch 开关组件

开关控制能切换单个设置的开/关两个状态。

开关组件是在移动设备上调整设置的首选方式。 The option that the switch controls, as well as the state it's in, should be made clear from the corresponding inline label.

基本的开关

标签

得益于 FormControlLabel 组件，您可以为 Switch 提供标签。

Size 大小

使用 size 属性来改变开关的大小。

Color 颜色

Controlled

You can control the switch with the checked and onChange props:

带有 FormGroup 的开关

FormGroup is a helpful wrapper used to group selection controls components that provides an easier API. However, you are encouraged to use Checkboxes instead if multiple related controls are required. (参见: 何时使用)。

自定义样式开关

你可以参考以下一些例子来自定义组件。 You can learn more about this in the overrides documentation page.

🎨 If you are looking for inspiration, you can check MUI Treasury's customization examples.

Label placement

You can change the placement of the label:

When to use

• 多选框 对比 Switches（开关控件）

Accessibility

• 它将渲染一个带有 checkbox 而不是 switch 角色的元素，鉴于该属性尚未得到广泛支持。 请首先测试目标受众的辅助技术 (assistive technology) 是否正确支持此 role 属性。 或者您可以使用 <Switch inputProps={{ role: 'switch' }}> 来更改 role 属性。
• 所有表单控件都应该带有标签，而这包括了单选按钮，复选框和开关。 In most cases, this is done by using the <label> element (FormControlLabel).
• 如果无法使用标签，您则必须在输入组件中直接添加属性。 在这种情况下，您可以通过 inputProps 属性来应用附加的属性（例如 aria-label, aria-labelledby, title）。

<Switch value="checkedA" inputProps={{ 'aria-label': 'Switch A' }} />

Unstyled

API

See the documentation below for a complete reference to all of the props and classes available to the components mentioned here.

• <FormControl />
• <FormControlLabel />
• <FormGroup />
• <FormLabel />
• <Switch />