amis/docs/zh-CN/components/form/radios.md
2022-03-18 13:54:30 +08:00

4.1 KiB

title description type group menuName icon order
Radios 单选框 0 null Radios 单选框 36

用于实现单选。

基本用法

{
  "type": "form",
  "body": [
    {
      "name": "radios",
      "type": "radios",
      "label": "radios",
      "options": [
        {
          "label": "OptionA",
          "value": "a"
        },
        {
          "label": "OptionB",
          "value": "b"
        },
        {
          "label": "OptionC",
          "value": "c"
        },
        {
          "label": "OptionD",
          "value": "d"
        }
      ]
    }
  ]
}

列显示

设置 inline 可以纵向显示,用于显示列很多的情况

{
  "type": "form",
  "body": [
    {
      "name": "radios",
      "type": "radios",
      "label": "radios",
      "inline": false,
      "options": [
        {
          "label": "OptionA",
          "value": "a"
        },
        {
          "label": "OptionB",
          "value": "b"
        },
        {
          "label": "OptionC",
          "value": "c"
        },
        {
          "label": "OptionD",
          "value": "d"
        }
      ]
    }
  ]
}

控制列显示的分裂

通过 columnsCount 来设置列显示的列数,比如下面例子是两列。

{
  "type": "form",
  "body": [
    {
      "name": "radios",
      "type": "radios",
      "label": "radios",
      "inline": false,
      "columnsCount": 2,
      "options": [
        {
          "label": "OptionA",
          "value": "a"
        },
        {
          "label": "OptionB",
          "value": "b"
        },
        {
          "label": "OptionC",
          "value": "c"
        },
        {
          "label": "OptionD",
          "value": "d"
        }
      ]
    }
  ]
}

属性表

当做选择器表单项使用时,除了支持 普通表单项属性表 中的配置以外,还支持下面一些配置

属性名 类型 默认值 说明
options Array<object>Array<string> 选项组
source stringAPI 动态选项组
labelField boolean "label" 选项标签字段
valueField boolean "value" 选项值字段
columnsCount number 1 选项按几列显示,默认为一列
inline boolean true 是否显示为一行
autoFill object 自动填充

事件表

事件名称 事件参数 说明
change value: string | Option 选中值 选中值发生变化时触发

动作表

动作名称 动作配置 说明
clear - 清空
reset - 重置