switch什么属性:控制组件状态与样式切换
switch核心属性包含checked、disabled、size、color,你可通过这几项属性直接控制开关组件的选中状态、禁用状态、尺寸和主题色,适配移动端、后台系统绝大多数UI交互场景,该属性体系适用于微信小程序、Vue、React主流前端框架,仅原生HTMLswitch组件部分属性不兼容。
switch核心基础属性
checked属性是switch组件的核心控制属性,为布尔值类型,true代表开关开启、false代表开关关闭,是实现开关状态双向绑定的关键。你在开发时可通过数据绑定动态修改该属性值,实现点击切换、代码自动切换开关状态的效果,所有主流前端框架的switch组件均兼容该属性。
disabled属性用于控制switch开关的可交互状态,同样为布尔值。设置为true时,开关会变为灰色静止状态,用户无法点击切换;设置为false时,开关恢复正常点击交互,常用来适配权限控制、数据加载未完成的页面场景。
可直接修改开关基础展示形态。
switch样式定制属性
size属性专门用于调整switch开关的整体尺寸,主流组件库提供small、default、large三种固定参数值,分别对应迷你、默认、加大尺寸。适配表单紧凑布局、弹窗精简布局、详情页醒目布局等不同页面排版需求,修改后无需额外调整宽高样式。
color属性用于自定义switch开启状态的主题颜色,支持十六进制色值、RGB色值、预设颜色单词三种格式。关闭状态的颜色多为组件库默认浅灰色,无法通过该属性修改,仅能自定义开启后的底色,可快速适配项目整体UI配色规范。
switch拓展交互属性
activeValue与inactiveValue属性是进阶赋值属性,可自定义开关开启、关闭时对应的后台提交数值,默认开启为true、关闭为false。你可按需设置为数字1和0、字符开和关,适配后端接口的参数接收规则,避免数据格式不匹配的问题。
loading属性为布尔值拓展属性,开启后switch开关会显示加载动画,同时锁定点击交互。多用于开关操作后需要请求接口、等待数据响应的场景,能有效避免用户重复点击触发多次请求,提升交互稳定性。
原生HTMLinput[type="switch"]不支持size、loading自定义属性,仅基础状态属性可生效。
| 属性名称 | 数据类型 | 核心作用 | 兼容范围 |
|---|---|---|---|
| checked | 布尔值 | 控制开关选中状态 | 全平台兼容 |
| disabled | 布尔值 | 锁定开关交互权限 | 全平台兼容 |
| size | 字符串 | 调整开关尺寸大小 | 框架组件库兼容、原生不兼容 |
| color | 色值字符串 | 自定义开启状态颜色 | 框架组件库兼容、原生不兼容 |
