vant/src/switch/README.zh-CN.md
2020-01-10 21:06:05 +08:00

2.3 KiB

Switch 开关

引入

import Vue from 'vue';
import { Switch } from 'vant';

Vue.use(Switch);

代码演示

基础用法

通过v-model绑定开关的选中状态,true表示开,false表示关

<van-switch v-model="checked" />
export default {
  data() {
    return {
      checked: true
    };
  }
};  

禁用状态

通过disabled属性来禁用开关,禁用状态下开关不可点击

<van-switch v-model="checked" disabled />

加载状态

通过loading属性设置开关为加载状态,加载状态下开关不可点击

<van-switch v-model="checked" loading />

自定义大小

通过size属性自定义开关的大小

<van-switch v-model="checked" size="24px" />

自定义颜色

active-color属性表示打开时的背景色,inactive-color表示关闭时的背景色

<van-switch v-model="checked" active-color="#07c160" inactive-color="#ee0a24" />

异步控制

需要异步控制开关时,可以使用value属性和input事件代替v-model,并在input事件回调函数中手动处理开关状态

<van-switch :value="checked" @input="onInput" />
export default {
  data() {
    return {
      checked: true
    };
  },

  methods: {
    onInput(checked) {
      Dialog.confirm({
        title: '提醒',
        message: '是否切换开关?'
      }).then(() => {
        this.checked = checked;
      });
    }
  }
}; 

API

Props

参数 说明 类型 默认值
v-model 开关选中状态 any false
loading 是否为加载状态 boolean false
disabled 是否为禁用状态 boolean false
size v2.2.11 开关尺寸,默认单位为px string | number 30px
active-color 打开时的背景色 string #1989fa
inactive-color 关闭时的背景色 string #fff
active-value 打开时的值 any true
inactive-value 关闭时的值 any false

Events

事件名 说明 回调参数
change 开关状态切换回调 checked: 是否选中开关
click v2.2.11 点击时触发 event: Event