# 开关 Switch

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

# 基础用法

基础用法

绑定v-model到一个Boolean类型的变量, size可设置开关的大小

<title>基础用法</title>
<describe>绑定v-model到一个Boolean类型的变量, size可设置开关的大小</describe>
<template>
  <hc-switch v-model="value"> </hc-switch>
  <span style="margin-right: 10px"></span>
  <hc-switch v-model="value" size="mini"> </hc-switch>
</template>
<script>
  export default {
    data() {
      return {
        value: true,
      };
    },
  };
</script>

# 自定义选中颜色

自定义选中颜色

可以使用checked-color属性与unchecked-color属性来设置开关的背景色设置打开和关闭的颜色

<title>自定义选中颜色</title>
<describe>可以使用checked-color属性与unchecked-color属性来设置开关的背景色设置打开和关闭的颜色</describe>
<template>
  <hc-switch v-model="value" checked-color="#13ce66" unchecked-color="#ff4949"> </hc-switch>
</template>
<script>
  export default {
    data() {
      return {
        value: true,
      };
    },
  };
</script>

# 扩展的 value 类型

扩展的 value 类型

设置checked-value和unchecked-value属性,接受Boolean, String或Number类型的值。

<title>扩展的 value 类型</title>
<describe>设置checked-value和unchecked-value属性,接受Boolean, String或Number类型的值。</describe>
<template>
  <hc-switch 
    v-model="value1" 
    :checked-value="1"
    :unchecked-value="0"
    @change="handleChange"
  >
  </hc-switch>
</template>
<script>
  export default {
    data() {
      return {
        value1: 1,
        value2: 'off'
      };
    },
    methods: {
      handleChange: function(e) {
        console.log(e)
      }
    }
  };
</script>

# 禁用状态

禁用

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

<title>禁用</title>
<describe>设置disabled属性,接受一个Boolean,设置true即可禁用。</describe>
<template>
  <hc-switch v-model="value" disabled> </hc-switch>
  <span style="margin-right: 10px"></span>
  <hc-switch v-model="value1" disabled> </hc-switch>
</template>
<script>
  export default {
    data() {
      return {
        value: true,
        value1: false
      };
    },
  };
</script>

# 属性及事件

# HcSwitch 属性

属性 说明 类型 可选值 默认值
value 当前输入的值,可配合 v-model 使用 string / number / boolean -- --
size 开关的大小 string mini / small small
checked-value 选中时的值 string / number / boolean -- true
unchecked-value 未选中时的值 string / number / boolean -- false
checked-color 选中时的开关颜色 string -- --
unchecked-color 未选中时的开关颜色 string -- --
disabled 是否禁用 boolean -- false

# HcSwitch 事件

事件 说明 回调参数
change 值改变事件 event.value:当前输入值
focus 获取焦点时触发事件 event
blur 失去焦点时触发事件 event