amis2/docs/zh-CN/components/form/input-array.md

3.1 KiB
Executable File

title description type group menuName icon order
InputArray 数组输入框 0 null InputArray 数组输入框 3

InputArray 是一种简化的 Combo,用于输入多个某种类型的表单项,提交的时将以数组的形式提交。

基本用法

[
  {
    "name": "array",
    "label": "颜色集合",
    "type": "input-array",
    "value": ["red"],
    "inline": true,
    "items": {
      "type": "input-color",
      "clearable": false
    }
  }
]

新增成员默认值

部分情况下,期望新增元素时使用默认值,这时可以通过设置scaffold属性配置新增成员的默认值。

{
  "type": "form",
  "debug": true,
  "debugConfig": {
    "levelExpand": 2
  },
  "body": [
    {
      "name": "array",
      "label": "整数集合",
      "mode": "horizontal",
      "type": "input-array",
      "value": [123, 456],
      "scaffold": 0,
      "inline": true,
      "items": {
        "type": "input-number",
        "clearable": false
      }
    }
  ]
}

属性表

除了支持 普通表单项属性表 中的配置以外,还支持下面一些配置

属性名 类型 默认值 说明
type string "input-array" 指明为array组件
items SchemaNode 配置单项表单类型
addable boolean 是否可新增。
removable boolean 是否可删除
draggable boolean false 是否可以拖动排序, 需要注意的是当启用拖动排序的时候,会多一个$id 字段
draggableTip string 可拖拽的提示文字,默认为:"可通过拖动每行中的【交换】按钮进行顺序调整"
addButtonText string "新增" 新增按钮文字
minLength number 限制最小长度
maxLength number 限制最大长度
scaffold any 新增成员时的默认值,一般根据items的数据类型指定需要的默认值