跳到主要内容

单选

适用场景#

页面中平铺选项,用户可进行单选操作

基础能力说明#

绑定「文本」字段#

表单容器绑定数据模型后,在表单容器的字段属性中,可将文本字段映射生成的组件切换为单选

选项配置说明#

支持手动配置选项列表,选项配置中,选项名称为页面中展示的选项业务名称,选项值为表单提交保存时向接口传参、落库保存的实际存储值

选中值属性说明#

  1. 选中值属性表示组件的默认表单值,可绑定变量或表达式实现选中值的动态变更

  2. 选中值需填入对应的选项值;填入选项名称无效

常见场景实践说明#

  1. 实现通过变量获取和改变表单值 查阅文档
  2. 清空表单内容 查阅文档
  3. 单选组件控制其他组件的显隐 查阅文档
  4. 表单组件隐藏时,提交对应表单数据 查阅文档
  5. 利用表单组件搭建列表的筛选或搜索功能 查阅文档

属性介绍#

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

属性名
属性标识
类型
属性分组
默认值
说明
绑定字段namestring基础属性"formRadio"提交表单时会将组件值提交保存到所配置的字段中
字段标题labelstring基础属性"单选"组件标题位置的显示内容
显示标题labelVisibleboolean基础属性true显示组件的标题
选中值valuestring基础属性""默认选中的选项
必填requiredboolean基础属性false启用后该组件强制必填,值不可为空
必填标识requiredFlagboolean基础属性true启用后,组件若要求必填,则会显示必填星号标记
必填校验提示requiredMsgstring基础属性"该项为必填项"启用必填,但组件值为空时的提示信息
选项rangearray基础属性[{"label":"单选-选项1","value":"1"},{"label":"单选-选项2","value":"2"}]供用户进行选择的选项列表
选项tipBlockstring基础属性""-
布局方式layout{"label":"自动","value":""}|{"label":"水平","value":"horizontal"}|{"label":"垂直","value":"vertical"}高级属性""-
禁用disabledboolean高级属性false是否禁用输入/选择,启用后组件强制显示为只读效果
组件宽度(PC端)size{"label":"大","value":"l"}|{"label":"中","value":"m"}|{"label":"小","value":"s"}|{"label":"占满","value":"full"}高级属性"full"-

事件介绍#

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

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