## Switch 开关 ### 使用指南 如果你已经按照[快速上手](/vue/component/quickstart)中引入了整个`ZanUI`,以下**组件注册**就可以忽略了,因为你已经全局注册了`ZanUI`中的全部组件。 #### 全局注册 你可以在全局注册`Switch`组件,比如页面的主文件(`index.js`,`main.js`),这样页面任何地方都可以直接使用`Switch`组件了: ```js import Vue from 'vue'; import { Switch } from '@youzan/zanui-vue'; import '@youzan/zanui-vue/lib/zanui-css/switch.css'; Vue.component(Switch.name, Switch); ``` #### 局部注册 如果你只是想在某个组件中使用,你可以在对应组件中注册`Switch`组件,这样只能在你注册的组件中使用`Switch`: ```js import { Switch } from '@youzan/zanui-vue'; export default { components: { 'zan-switch': Switch } }; ``` ### 代码演示 #### 基础用法 :::demo 基础用法 ```html
{{ switchState1 ? ' ON' : 'OFF' }}
``` ::: :::demo 基础用法 ```html
{{ switchState2 ? ' ON' : 'OFF' }}
``` ::: #### 禁用状态 设置`disabled`属性为`true`,此时开关不可点击。 :::demo ```html
ON, DISABLED
OFF, DISABLED
``` ::: #### loading状态 设置`loading`属性为`true`,此时开关为加载状态,一般用于点击开关时正在向后端发送请求,此时正在loading,请求成功后,结束loading。 :::demo ```html
ON, LOADING
OFF, LOADING
``` ::: ### API | 参数 | 说明 | 类型 | 默认值 | 可选值 | |-----------|-----------|-----------|-------------|-------------| | v-model | 开关状态 | `boolean` | `false` | `true`, `false` | | loading | loading状态 | `boolean` | `false` | `true`, `false` | | disabled | 禁用状态 | `boolean` | `false` | `true`, `false` | | onChange | 开关状态切换回调(默认则改变开关状态) | `function` | - | - |