跳到主要内容

开关

适用场景#

用于控制布尔值的是/否

基础能力说明#

绑定「布尔值」字段#

表单容器绑定数据模型后,模型中的「布尔值」字段会自动渲染为开关组件

常见场景实践说明#

  1. 表单组件隐藏时,提交对应表单数据 查阅文档

属性介绍#

组件接收的外部传入的属性

属性名
属性标识
类型
属性分组
默认值
说明
绑定字段namestring基础属性"formSwitch"表单字段的Key值,用于提交数据时,匹配数据模型字段标识。页面内需保证唯一。
字段标题labelstring基础属性"开关"组件标题位置的显示内容
显示标题labelVisibleboolean基础属性true显示组件的标题
开关状态valueboolean基础属性false开关的默认开关状态
必填requiredboolean基础属性false启用后该组件强制必填,值不可为空
必填标识requiredFlagboolean基础属性true启用后,组件若要求必填,则会显示必填星号标记
必填校验提示requiredMsgstring基础属性"该项为必填项"启用必填,但组件值为空时的提示信息
布局方式layout{"label":"自动","value":""}|{"label":"水平","value":"horizontal"}|{"label":"垂直","value":"vertical"}高级属性""设置当前组件的标题和输入选择区域为左右布局或上下布局,如选择“自动”,则跟随父级表单容器的配置
禁用disabledboolean高级属性false是否禁用输入/选择,启用后组件强制显示为只读效果

事件介绍#

组件暴露的事件,可以监听组件的事件来触发一些外部的动作

事件名
事件code
事件出参 event.detail
适用情况
说明
值改变change兼容三端-