Skip to content

表单设计

本文档描述表单设计页面的数据结构,即发布时 formDesign 部分的内容。

json
{
  "formItems": [
    {
      "id": "field_001",
      "type": "input",
      "label": "请假原因",
      "placeholder": "请输入",
      "required": true,
      "defaultValue": ""
    },
    {
      "id": "field_002",
      "type": "daterange",
      "label": "请假时间",
      "startLabel": "开始时间",
      "endLabel": "结束时间",
      "dateType": "date",
      "required": true
    }
  ]
}

formItems 数组

formItems 是表单项的一维数组,每个元素代表一个表单字段。字段结构因 type 不同而有所差异。

通用字段(所有组件共有):

字段类型说明
idString字段唯一标识,前端自动生成
typeString组件类型,见下方各组件特有字段表
labelString字段标签
requiredBoolean是否必填

各组件特有字段

组件类型名称特有字段说明
columns分栏容器childrenlayoutValue子组件数组、布局比例(如 1:11:2
input单行文本placeholderdefaultValue占位提示、默认值(字符串)
textarea多行文本placeholderdefaultValue占位提示、默认值(字符串)
number数字输入框placeholderdefaultValueminmaxprecision占位提示、默认值、最小值、最大值、小数位数限制
text说明文字content说明文字内容
radio单选框placeholderoptionsdefaultValueoptionTile占位提示、选项列表、默认选中值、是否选项平铺
checkbox多选框placeholderoptionsdefaultValueoptionTile占位提示、选项列表、默认选中值数组、是否选项平铺
date日期选择placeholderdateTypedefaultValue占位提示、日期类型(如 date)、默认值
daterange日期区间startLabelendLabeldateTypeplaceholder起始/结束标签、日期类型、占位提示
idcard身份证placeholder占位提示
phone手机号placeholder占位提示
upload文件上传无额外字段
image图片上传无额外字段

鄂ICP备2022006250号-5