uniapp中组件库丰富的Switch 开关选择器使用方法

目录

#平台差异说明

#基础使用

#加载中

#禁用switch

#自定义尺寸

#自定义颜色

#自定义样式

#异步控制

API

[#Switch Props](#Switch Props)

[#Switch Event](#Switch Event)


选择开关用于在打开和关闭状态之间进行切换。

#平台差异说明

App(vue) App(nvue) H5 小程序
√ √ √ √

#基础使用

通过v-model绑定一个布尔值变量,这个变量是双向绑定的,当用户开或关选择器的时候,在父组件的该值也会相应的变为true或者false,也就是说, 您不用监听change事件,也能知道选择器当前处于开 或者关的状态。

我们为其提供了加载中 禁用 自定义尺寸 自定义颜色 自定义样式 异步控制等六种能力,并在以下案例中为您展示

复制代码
<u-switch v-model="value" @change="change"></u-switch>
<!-- methods -->
change(e) {
	console.log('change', e);
},

#加载中

设置loading属性,默认为true,可以让switch处于加载中的状态,这时switch是不可操作的,您可以通过:loading='loading'以动态设置加载状态

复制代码
<u-switch v-model="value3" loading ></u-switch>
<u-switch v-model="value4" loading ></u-switch>
<!-- data -->
value3: false,
value4: true,

#禁用switch

设置disabled属性,默认为true,即可禁用某个组件,让用户无法点击,禁用分为两种状态:

  • 一是关闭情况下的禁用,这时只显示一个白色的区域。

  • 二是打开后再禁用,这时会在原有的颜色上加一个opacity透明度,但此时依然是不可操作的。

#自定义尺寸

设置size属性,可以让您自定义switch的尺寸,单位为px

复制代码
<u-switch v-model="value3" size="28" ></u-switch>
<u-switch v-model="value4" size="20" ></u-switch>
<!-- data -->
value3: false,
value4: true,

#自定义颜色

设置activeColor属性,可以让您自定义switch的颜色,支持多种设置方式,如:activeColor="#f56c6c" activeColor="red" activeColor="rgb(0,0,0)"

复制代码
<u-switch v-model="value" activeColor="#f56c6c" loading ></u-switch>
<u-switch v-model="value1" activeColor="#5ac725" loading ></u-switch>
<!-- data -->
value: true,
value1: true,

#自定义样式

同时设置activeColor和inactiveColor属性,可以让您自定义switch的样式,同样支持多种设置方式

复制代码
<u-switch
	space="2" v-model="value11" activeColor="#f9ae3d" 
	inactiveColor="rgb(230, 230, 230)">
</u-switch>
<u-switch
	space="2" v-model="value12" activeColor="#f9ae3d"
	inactiveColor="rgb(230, 230, 230)">
</u-switch>
<!-- data -->
value11: false,
value12: true,

#异步控制

异步控制场景,一般发生在用户打开或者关闭选择器时,需要本地或者向后端请求判断,是否允许用户打开或者关闭的场景。

同时您也可以组合使用,例如根据接口结果添加disabled,loading属性等

注意

请添加asyncChange属性来支持异步控制操作,否则您将先操作v-model绑定的值,并失去控制效果

复制代码
<template>
	<u-switch v-model="value13" asyncChange @change="asyncChange" ></u-switch>
</template>

<script>
	export default {
		data() {
			return {
				value13:true
			};
		},
		methods: {
			asyncChange(e) {
				uni.showModal({
					content: e ? '确定要打开吗' : '确定要关闭吗',
					success: (res) => {
						if (res.confirm) {
							this.value13 = e
						}
					}
				})
			}
		}
	};
</script>

API

#Switch Props

注意:需要给switch组件通过v-model绑定一个布尔值,来初始化switch的状态,随后该值被双向绑定, 当用打开选择器时,该值在switch组件内部被修改为true,并反映到父组件,否则为false,换言之,您无需监听switch的change事件,也能 知道某一个switch是否被选中的状态

参数 说明 类型 默认值 可选值
loading 是否处于加载中 Boolean false true
disabled 是否禁用 Boolean false true
size 开关尺寸,单位rpx String | Number 25 -
activeColor 打开时的背景色 String #2979ff -
inactiveColor 关闭时的背景色 String #ffffff -
value 通过v-model双向绑定的值 Boolean | String | Number false -
activeValue switch打开时的值 Boolean | String | Number true -
inactiveValue switch关闭时的值 Boolean | String | Number false -
asyncChange 是否开启异步变更,开启后需要手动控制输入值 Boolean false true
space 圆点与外边框的距离 String | Number 0 -

#Switch Event

事件名 说明 回调参数
change 在switch打开或关闭时触发 value:打开时为activeValue值,关闭时为inactiveValue值
input 在switch打开或关闭时触发(没开启异步) value:打开时为activeValue值,关闭时为inactiveValue值
相关推荐
wuxianda10303 天前
uniapp 与跨端打包项目:壳子和框架层默认特征,相似是从哪里来的
uni-app
码间留白3 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
wuxianda10304 天前
苹果 App 上架 4.3(a) 问题解决方案(适用 uniapp、Objective-C、Swift、Flutter 等项目)
uni-app·objective-c·swift
码间留白5 天前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
anyup5 天前
自带 uni-app x 页面级能力,uView Pro X 8 个开箱即用的工具函数
前端·vue.js·uni-app
码间留白10 天前
六轮真机实验后,我把鸿蒙直播推流的 UI 全逼成了原生——uni-app 适配 HarmonyOS NEXT 完整复盘
uni-app·鸿蒙·harmonyos next·直播推流·arkts/arkui
wuxianda103012 天前
2026 苹果审核 4.3 (a) 被拒全解析|Guideline 4.3a spam 马甲包拒审原因 + 避坑方案
flutter·uni-app·苹果上架
头发还在的女程序员14 天前
基于 Spring Boot + Vue 3 + uni-app 的灵活用工系统:四端架构与业务流程设计
vue.js·spring boot·uni-app·灵活用工·灵工系统
Dumbness15 天前
订阅消息弹窗必须在用户点击里调:联调实验室里 timing 和 Mock 支付通知踩的坑
javascript·uni-app
码间留白16 天前
uni-app 鸿蒙离线打包:一个改动从源码到真机要穿过几条链
uni-app·鸿蒙·deveco·离线打包·uts插件