Jst UI

# Switch 开关

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

# 基本用法

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

<j-switch
  v-model="value"
  active-color="#13ce66"
  inactive-color="#ff4949">
</j-switch>

<script>
  export default {
    data() {
      return {
        value: true
      }
    }
  };
</script>
显示代码 复制代码

# 文字描述

按月付费
按月付费

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

<j-switch
  style="display: block"
  v-model="value1"
  active-text="按月付费"
  inactive-text="按年付费">
</j-switch>
<j-switch
  style="display: block;margin-top:10px"
  v-model="value2"
  active-color="#13ce66"
  inactive-color="#ff4949"
  active-text="按月付费"
  inactive-text="按年付费">
</j-switch>

<script>
  export default {
    data() {
      return {
        value1: true,
        value2: true
      }
    }
  };
</script>
显示代码 复制代码

# 扩展的 value 类型

设置active-value和inactive-value属性，接受Boolean, String或Number类型的值。

<j-switch
    v-model="value"
    active-color="#13ce66"
    inactive-color="#ff4949"
    active-value="100"
    inactive-value="0">
  </j-switch>

<script>
  export default {
    data() {
      return {
        value: '100'
      }
    }
  };
</script>
显示代码 复制代码

# 禁用状态

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

<j-switch
  v-model="value1"
  disabled>
</j-switch>
<j-switch
  v-model="value2"
  disabled>
</j-switch>
<script>
  export default {
    data() {
      return {
        value1: true,
        value2: false
      }
    }
  };
</script>
显示代码 复制代码

# Attributes

参数 说明 类型 可选值 默认值
value / v-model 绑定值 boolean / string / number — —
disabled 是否禁用 boolean — false
width switch 的宽度（像素） number — 40
active-icon-class switch 打开时所显示图标的类名，设置此项会忽略 active-text string — —
inactive-icon-class switch 关闭时所显示图标的类名，设置此项会忽略 inactive-text string — —
active-text switch 打开时的文字描述 string — —
inactive-text switch 关闭时的文字描述 string — —
active-value switch 打开时的值 boolean / string / number — true
inactive-value switch 关闭时的值 boolean / string / number — false
active-color switch 打开时的背景色 string — #409EFF
inactive-color switch 关闭时的背景色 string — #C0CCDA
name switch 对应的 name 属性 string — —
validate-event 改变 switch 状态时是否触发表单的校验 boolean - true

# Events

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

# Methods

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

← MessageBox 弹框 →