• Switch 开关
    • 基本用法
    • 文字描述
    • 扩展的 value 类型
    • 禁用状态
    • Attributes
    • Events
    • Methods

    Switch 开关

    表示两种相互对立的状态间的切换,多用于触发「开/关」。

    基本用法

    Switch 开关 - 图1

    绑定v-model到一个Boolean类型的变量。可以使用active-color属性与inactive-color属性来设置开关的背景色。

    1. <el-switch
    2. v-model="value"
    3. active-color="#13ce66"
    4. inactive-color="#ff4949">
    5. </el-switch>
    6. <script>
    7. export default {
    8. data() {
    9. return {
    10. value: true
    11. }
    12. }
    13. };
    14. </script>

    文字描述

    Switch 开关 - 图2

    使用active-text属性与inactive-text属性来设置开关的文字描述。

    1. <el-switch
    2. v-model="value1"
    3. active-text="按月付费"
    4. inactive-text="按年付费">
    5. </el-switch>
    6. <el-switch
    7. style="display: block"
    8. v-model="value2"
    9. active-color="#13ce66"
    10. inactive-color="#ff4949"
    11. active-text="按月付费"
    12. inactive-text="按年付费">
    13. </el-switch>
    14. <script>
    15. export default {
    16. data() {
    17. return {
    18. value1: true,
    19. value2: true
    20. }
    21. }
    22. };
    23. </script>

    扩展的 value 类型

    Switch 开关 - 图3

    设置active-valueinactive-value属性,接受Boolean, StringNumber类型的值。

    <el-tooltip :content="'Switch value: ' + value" placement="top">
      <el-switch
        v-model="value"
        active-color="#13ce66"
        inactive-color="#ff4949"
        active-value="100"
        inactive-value="0">
      </el-switch>
    </el-tooltip>
    
    <script>
      export default {
        data() {
          return {
            value: '100'
          }
        }
      };
    </script>
    

    禁用状态

    Switch 开关 - 图4

    设置disabled属性,接受一个Boolean,设置true即可禁用。

    <el-switch
      v-model="value1"
      disabled>
    </el-switch>
    <el-switch
      v-model="value2"
      disabled>
    </el-switch>
    <script>
      export default {
        data() {
          return {
            value1: true,
            value2: false
          }
        }
      };
    </script>
    

    Attributes

    参数说明类型可选值默认值
    value / v-model绑定值boolean / string / number
    disabled是否禁用booleanfalse
    widthswitch 的宽度(像素)number40
    active-icon-classswitch 打开时所显示图标的类名,设置此项会忽略 active-textstring
    inactive-icon-classswitch 关闭时所显示图标的类名,设置此项会忽略 inactive-textstring
    active-textswitch 打开时的文字描述string
    inactive-textswitch 关闭时的文字描述string
    active-valueswitch 打开时的值boolean / string / numbertrue
    inactive-valueswitch 关闭时的值boolean / string / numberfalse
    active-colorswitch 打开时的背景色string#409EFF
    inactive-colorswitch 关闭时的背景色string#C0CCDA
    nameswitch 对应的 name 属性string
    validate-event改变 switch 状态时是否触发表单的校验boolean-true

    Events

    事件名称说明回调参数
    changeswitch 状态发生变化时的回调函数新状态的值

    Methods

    方法名说明参数
    focus使 Switch 获取焦点-