# Switch 开关

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

# 基本用法

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

<tu-switch v-model="value"> </tu-switch>

<script>
	export default {
		data() {
			return {
				value: false,
			};
		},
	};
</script>
Expand Copy

# 禁用状态

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

<template>
	<div class="demo-switch">
		<tu-switch
			v-model="value1"
			disabled
		>
		</tu-switch>
		<tu-switch
			v-model="value2"
			disabled
		>
		</tu-switch>
	</div>
</template>

<script>
	export default {
		data() {
			return {
				value1: false,
				value2: true,
			};
		},
	};
</script>
Expand Copy

# 文字描述

使用activeLabel属性与inactiveLabel属性来设置开关的文字描述。

<template>
	<div class="demo-switch">
		<tu-switch
			v-model="value1"
			activeLabel=""
			inactiveLabel=""
		>
		</tu-switch>
		<tu-switch v-model="value2">
			<i
				slot="activeLabel"
				class="tu-icon-check"
			></i>
			<i
				slot="inactiveLabel"
				class="tu-icon-close"
			></i>
		</tu-switch>
	</div>
</template>

<script>
	export default {
		data() {
			return {
				value1: false,
				value2: false,
			};
		},
	};
</script>
Expand Copy

# 扩展的 value 类型

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

<tu-switch
	v-model="value"
	active-value="100"
	inactive-value="0"
>
</tu-switch>

<script>
	export default {
		data() {
			return {
				value: "0",
			};
		},
	};
</script>
Expand Copy

# 尺寸

可通过 size 属性指定输入框的尺寸,除了默认的大小外,还提供了 large、medium 和 mini 三种尺寸。

<div class="demo-switch">
	<tu-switch
		size="small"
		v-model="value1"
	>
	</tu-switch>
	<tu-switch
		size="medium"
		v-model="value2"
	>
	</tu-switch>
	<tu-switch
		size="large"
		v-model="value3"
	>
	</tu-switch>
</div>

<script>
	export default {
		data() {
			return {
				value1: false,
				value2: false,
				value3: false,
			};
		},
	};
</script>
Expand Copy

# Attributes

参数 说明 类型 可选值 默认值
value / v-model 绑定值 boolean / string / number
disabled 是否禁用 boolean false
width switch 的宽度(像素) number 40
active-label switch 打开时的文字描述 string
inactive-label switch 关闭时的文字描述 string
active-value switch 打开时的值 boolean / string / number true
inactive-value switch 关闭时的值 boolean / string / number false
name switch 对应的 name 属性 string
validate-event 改变 switch 状态时是否触发表单的校验 boolean - true

# Events

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

# Methods

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