- Switch 开关
- 何时使用
- 代码演示
- 基本用法
- 不可用
- 文字和图标
- 两种大小
- 加载中
- API
- 事件
- 方法
Switch 开关
开关选择器。
何时使用
- 需要表示开关状态/两种状态之间的切换时;
- 和
checkbox的区别是,切换switch会直接触发状态改变,而checkbox一般用于状态标记,需要和提交操作配合。
代码演示

基本用法
最简单的用法。
<template><div><a-switch defaultChecked @change='onChange'/></div></template><script>export default {data () {return {}},methods: {onChange(checked){console.log(`a-switch to ${checked}`);}},}</script>

不可用
Switch 失效状态。
<template><div><a-switch defaultChecked :disabled="disabled" style="margin-bottom:5px"/><br/><a-button type="primary" @click='onToggle'>Toggle disabled</a-button></div></template><script>export default {data () {return {disabled: true,}},methods: {onToggle(){this.disabled = !this.disabled}},}</script>

文字和图标
带有文字和图标。
<template><div><a-switch checkedChildren="开" unCheckedChildren="关" defaultChecked/><br><a-switch checkedChildren="1" unCheckedChildren="0"/><br><a-switch defaultChecked ><a-icon type="check" slot="checkedChildren"/><a-icon type="close" slot="unCheckedChildren"/></a-switch></div></template>

两种大小
size="small" 表示小号开关。
<template><div><a-switch defaultChecked/><br><a-switch size="small" defaultChecked/></div></template>

加载中
标识开关操作仍在执行中。
<template><div><a-switch loading defaultChecked/><br><a-switch size="small" loading/></div></template>
API
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| autoFocus | 组件自动获取焦点 | boolean | false |
| checked(v-model) | 指定当前是否选中 | boolean | false |
| checkedChildren | 选中时的内容 | string|slot | |
| defaultChecked | 初始是否选中 | boolean | false |
| disabled | 是否禁用 | boolean | false |
| loading | 加载中的开关 | boolean | false |
| size | 开关大小,可选值:default small | string | default |
| unCheckedChildren | 非选中时的内容 | string|slot |
事件
| 事件名称 | 说明 | 回调参数 |
|---|---|---|
| change | 变化时回调函数 | Function(checked:Boolean) |
方法
| 名称 | 描述 |
|---|---|
| blur() | 移除焦点 |
| focus() | 获取焦点 |
