Switch 开关

概述

在两种状态间切换时用到的开关选择器。

注意:没有使用 iview-loader 时,必须使用 i-switch 标签。

代码示例

Switch 开关 - 图1

基本

基本用法,状态切换时会触发事件。

  1. <template>
  2. <Switch v-model="switch1" @on-change="change" />
  3. </template>
  4. <script>
  5. export default {
  6. data () {
  7. return {
  8. switch1: false
  9. }
  10. },
  11. methods: {
  12. change (status) {
  13. this.$Message.info('开关状态:' + status);
  14. }
  15. }
  16. }
  17. </script>

Switch 开关 - 图2

尺寸

设置sizelargesmall 使用大号和小号的开关。

  1. <template>
  2. <Switch size="large" />
  3. <Switch />
  4. <Switch size="small" />
  5. </template>
  6. <script>
  7. export default {
  8. }
  9. </script>

Switch 开关 - 图3

文字和图标

自定义内容,建议如果使用2个汉字,将开关尺寸设置为 large。

  1. <template>
  2. <Switch>
  3. <span slot="open"></span>
  4. <span slot="close"></span>
  5. </Switch>
  6. <Switch>
  7. <Icon type="md-checkmark" slot="open"></Icon>
  8. <Icon type="md-close" slot="close"></Icon>
  9. </Switch>
  10. <br><br>
  11. <Switch size="large">
  12. <span slot="open">开启</span>
  13. <span slot="close">关闭</span>
  14. </Switch>
  15. <Switch size="large">
  16. <span slot="open">ON</span>
  17. <span slot="close">OFF</span>
  18. </Switch>
  19. </template>
  20. <script>
  21. export default {
  22. }
  23. </script>

Switch 开关 - 图4

不可用

禁用开关。

  1. <template>
  2. <Switch :disabled="disabled" />
  3. <Button type="primary" @click="disabled = !disabled">Toggle Disabled</Button>
  4. </template>
  5. <script>
  6. export default {
  7. data () {
  8. return {
  9. disabled: true
  10. }
  11. },
  12. }
  13. </script>

Switch 开关 - 图5

加载中

标识开关操作仍在执行中。

  1. <template>
  2. <Switch loading :value="true" />
  3. <Switch loading :value="false" size="small" />
  4. </template>
  5. <script>
  6. export default {
  7. }
  8. </script>

API

Switch props

属性说明类型默认值
value指定当前是否选中,可以使用 v-model 双向绑定数据Booleanfalse
size开关的尺寸,可选值为largesmalldefault或者不写。建议开关如果使用了2个汉字的文字,使用 large。String-
disabled禁用开关Booleanfalse
true-value选中时的值,当使用类似 1 和 0 来判断是否选中时会很有用String, Number, Booleantrue
false-value没有选中时的值,当使用类似 1 和 0 来判断是否选中时会很有用String, Number, Booleanfalse
loading加载中的开关Booleanfalse

Switch events

事件名说明返回值
on-change开关变化时触发,返回当前的状态true | false

Switch slot

名称说明
open自定义显示打开时的内容
close自定义显示关闭时的内容