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

    Switch 开关

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

    基本用法

    Switch 开关 - 图1

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

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

    文字描述

    Switch 开关 - 图2

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

    1. <el-switch
    2. v-model="value3"
    3. active-text="按月付费"
    4. inactive-text="按年付费">
    5. </el-switch>
    6. <el-switch
    7. style="display: block"
    8. v-model="value4"
    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. value3: true,
    19. value4: true
    20. }
    21. }
    22. };
    23. </script>

    扩展的 value 类型

    Switch 开关 - 图3

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

    1. <el-tooltip :content="'Switch value: ' + value5" placement="top">
    2. <el-switch
    3. v-model="value5"
    4. active-color="#13ce66"
    5. inactive-color="#ff4949"
    6. active-value="100"
    7. inactive-value="0">
    8. </el-switch>
    9. </el-tooltip>
    10. <script>
    11. export default {
    12. data() {
    13. return {
    14. value5: '100'
    15. }
    16. }
    17. };
    18. </script>

    禁用状态

    Switch 开关 - 图4

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

    1. <el-switch
    2. v-model="value6"
    3. disabled>
    4. </el-switch>
    5. <el-switch
    6. v-model="value7"
    7. disabled>
    8. </el-switch>
    9. <script>
    10. export default {
    11. data() {
    12. return {
    13. value6: true,
    14. value7: false
    15. }
    16. }
    17. };
    18. </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 获取焦点-