- 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, event: Event) |
click | 点击时回调函数 | Function(checked: boolean, event: Event) |
方法
名称 | 描述 |
---|---|
blur() | 移除焦点 |
focus() | 获取焦点 |