Switch 开关


开关用于表示两种状态之间的切换,跟单独使用的 checkbox 有点类似,但 switch 开关更多的是触发即可改变状态,而 checkbox 更多的是用于表格,一般都需要配合表单的提交操作

基础用法

基础用法,状态切换会触发事件

Switch开关 - 图1

  1. <at-switch v-model="check" @change="changeStatus"></at-switch>
  2. <span>{{check}}</span>

内嵌文字或图标

开关内部内容可自定义,例如插入文字或图标,增强视觉效果。通过 slot="checkedText"slot="unCheckedText" 完成

Switch开关 - 图2

  1. <at-switch>
  2. <span slot="checkedText"></span>
  3. <span slot="unCheckedText"></span>
  4. </at-switch>
  5. <at-switch>
  6. <span slot="checkedText"><i class="icon icon-left-arrow"></i></span>
  7. <span slot="unCheckedText"><i class="icon icon-right-arrow"></i></span>
  8. </at-switch>

不可用开关

添加属性 disabled 禁用开关按钮

Switch开关 - 图3

<at-switch disabled :value="true">
  <span slot="checkedText">开</span>
  <span slot="unCheckedText">关</span>
</at-switch>
<at-switch disabled>
  <span slot="checkedText">开</span>
  <span slot="unCheckedText">关</span>
</at-switch>
<at-switch disabled></at-switch>

不同尺寸

添加属性 size 可设置按钮的尺寸大小,默认提供三种尺寸:smallnormallarge

Switch开关 - 图4

<div>
  <at-switch size="small"></at-switch>
  <at-switch size="small">
    <span slot="checkedText">开</span>
    <span slot="unCheckedText">关</span>
  </at-switch>
  <at-switch size="small" disabled></at-switch>
</div>
<div style="margin-top: 8px;">
  <at-switch></at-switch>
  <at-switch>
    <span slot="checkedText">开</span>
    <span slot="unCheckedText">关</span>
  </at-switch>
  <at-switch disabled></at-switch>
</div>
<div style="margin-top: 8px;">
  <at-switch size="large"></at-switch>
  <at-switch size="large">
    <span slot="checkedText">开</span>
    <span slot="unCheckedText">关</span>
  </at-switch size="large">
  <at-switch size="large" disabled></at-switch>
</div>

Switch 参数

参数说明类型可选值默认值
valueSwitch 状态值Boolean-false
size开关的尺寸大小Stringsmall, normal, largenormal
disabled是否禁用按钮Booleanfalse

Switch Slots

名称说明
checkedText自定义打开时的内容
unCheckedText自定义关闭时的内容

Switch 事件

事件名称说明返回值
change开关状态变化时触发开关的状态