Switch 开关

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

基础用法

绑定 v-model 到一个 Boolean 类型的变量。

<script setup>
import { ref } from 'vue'
import PfSwitch from '@/components/lib/Switch/src/Switch.vue'
const isOn = ref(false)
</script>
<template>
  <pf-switch v-model="isOn" />
</template>

尺寸

<script setup>
import { ref } from 'vue'
import PfSwitch from '@/components/lib/Switch/src/Switch.vue'
const isOn = ref(false)
</script>
<template>
  <pf-switch v-model="isOn" size="large" />
  <pf-switch v-model="isOn" />
  <pf-switch v-model="isOn" size="small" />
</template>

文字描述

OFF

<script setup>
import { ref } from 'vue'
import PfSwitch from '@/components/lib/Switch/src/Switch.vue'
const isOn = ref(false)
</script>
<template>
  <pf-switch v-model="isOn" activeText="ON" inactiveText="OFF" />
</template>

扩展的 value 类型

你可以设置 active-value 和 inactive-value 属性， 它们接受 boolean | string | number 类型的值。

model-value: right

<script setup>
import { ref } from 'vue'
import PfSwitch from '@/components/lib/Switch/src/Switch.vue'
const isOn = ref('right')
</script>
<template>
  <pf-switch v-model="isOn" activeValue="right" inactiveValue="wrong" />
  <h4>model-value: {{ isOn }}</h4>
</template>

禁用状态

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

<script setup>
import { ref } from 'vue'
import PfSwitch from '@/components/lib/Switch/src/Switch.vue'
const isOn = ref(false)
</script>
<template>
  <pf-switch v-model="isOn" />
  <pf-switch v-model="isOn" disabled />
</template>

Switch 属性

Name	Description	Type	Default
model-value / v-model	绑定值	'string' | 'boolean' | 'number'	false
disabled	是否禁用	boolean	false
active-text	switch 打开时的文字描述	string
inactive-text	switch 的状态为 off 时的文字描述	'large' | 'small'
active-value	switch 状态为 on 时的值	'string' | 'boolean' | 'number'	true
inactive-value	switch 状态为 off 时的值	'string' | 'boolean' | 'number'	false
name	switch 对应的 name 属性	string
id	input 的 id	string

Switch 事件

Name	Description	Type
change	switch 状态发生变化时的回调函数	(e: 'string' | 'boolean' | 'number' ) => void