# 一、作用意义 在低代码平台中，"表单设计"是一项非常重要的功能，旨在简化和加快表单的创建和定制过程。 "表单设计"是平台提供的一种可视化工具，它使开发人员能够轻松创建和自定义各种类型的表单，通过直观的拖放界面，开发人员可以快速构建表单并定义其中的字段、验证规则和布局。 可用于数据上报、申请、积分管理、销售客户与订单管理等场景。通过配置表单基本属性，使表单更符合主题。 # 二、操作流程 ## 1. 表单设计页面功能区域 功能说明：表单设计页面分为三个区域，分别是容器区，字段区，组件设置区，通过这些区域的结合使用，能够在表单设计页面上轻松创建、布局和设置自定义表单。容器区用于划分表单布局的不同部分，组件设置区则提供了配置每个组件的灵活性，而字段选择区则可以更加方便的添加和选择所需的字段。 功能页面操作路径：开发 > 实体管理 第一步：点击【表单设计】按钮，打开表单设计页面；  第二步：在表单设计页面中，区域说明如下：  标注的区域分别为： 1.容器区： 容器区是表单设计页面的主要工作区域，它允许创建和布局表单的各个部分。可以通过拖放和调整容器来创建行和列，以在表单中划分不同的区域。这使用户能够以自定义方式组织表单的布局，并以更直观的方式设置表单的结构。 2.字段区： 字段选择区是选择实体现有字段的功能（字段添加可在 字段管理 中查看详细内容）。可以在此区域中查看所有可用的字段选项，并将它们拖放到容器区域中。这些字段可以是文本输入字段、日期选择器、下拉列表等。通过字段选择区，您可以方便地向表单添加不同类型的字段并对其进行调整。 3.组件设置区： 组件设置区是用于配置每个表单组件的属性和行为的区域。当将表单组件添加到容器区时，可以在组件设置区中对其进行详细配置。包括设置组件的标签、样式、验证规则、默认值等。还可以根据需要自定义每个组件的外观和行为，以满足表单的特定要求。 ## 2. 表单设计步骤 功能说明：表单设计主要分为三个步骤，分别是添加字段、组件设置、全局设置。 功能页面操作路径：开发 > 实体管理 第一步：在表单设计页面中，添加已有的数据库字段，从页面左侧选择需要的容器及已有字段拖动到页面中间区域，并可自定义字段位置及排版。  第二步：组件设置（设置字段属性），选择已添加的字段，在页面右侧区域 - 组件设置栏可设置字段的属性。包括字段的验证规则、是否必填、默认值、大小样式等。通过设置字段属性，确保用户输入的数据符合规范，并提供更好的用户体验。  第三步：全局设置（设置表单属性），除了设置字段属性之外，还可以在页面右侧区域 - 全局设置中设置整个表单的属性。包括表单的样式、布局等。通过设置表单属性，可调整表单的外观和布局，以满足特定的设计需求，并提供更好的用户导航和交互体验。  ## 三、表单字段属性 功能说明：对于各种类型的字段属性进行详细说明。 功能页面操作路径：开发 > 实体管理 ## 1. 文本 功能说明：文本是最基础的字段，在表单中具有广泛的应用，可以用来收集文字、数字、编号等信息。 应用场景：文本可用于录入内容较短的文本类信息，如姓名、产品名称、公司名称、规格、型号等；还可以用于录入不需要、不适合加减乘除计算的数字类信息，如手机号码、身份证号、员工编号、银行卡号、会员号等 字段属性说明： 常见属性（其他类型字段部分一样的属性与此相同）  组件设置字段说明如下： 1. 唯一名称：数据库标识符，可进行修改，但请谨慎修改，与实体内其他字段名称不可重复； 2. 标签：该字段label标签展示的名称标题；  3. 标签对齐：在表单上标签的对齐方式，支持居左、居中、居右对齐；  4. 显示类型：显示类型可切换文本/密码，选中密码password类型支持输入后展示为******来防止密码泄露；  5. 默认值：设置后，用户新建表单时，该字段展示默认值内容，但是支持用户清除后重新输入；  6. 占位内容：为字段提供占位符提示信息，指示用户应该在字段中输入什么内容，它可以帮助用户明确输入的预期；  7. 组件大小：可设置组件在表单中的大小（default：默认大小； large：大； small：小） 8. 标签宽度：支持输入数字，对表单上展示的标题的宽度进行调整，label标题越长需要的宽度越大； 9. 隐藏字段标签：隐藏后，表单上该字段将不再展示标题名称； 10. 必填字段：若添加字段的时候选择字段必填，则此开关不生效（此字段为必填字段），否则此处可以控制字段是否必填； 11. 必填提示校验：开启必填字段后，未填写该字段时可自定义设置提示语； 12. 字段校验：字段输入值的规则校验，比如仅允许输入数字、字母、数字字母、手机号码、邮箱、网址、非中文字符、仅中文字符； 13. 校验失败提示：开启字段校验后，校验失败时可自定义设置提示语； 14. 只读：开启后只可查看不可编辑删除； 15. 禁用：开启后不可编辑该字段内容； 16. 隐藏：新建编辑时该字段隐藏不展示； 17. 可清除：清除字段内容； 高级属性  1. 最小长度：字段所允许的最小字符数； 2. 最大长度：字段所允许的最大字符数，如果用户输入的内容超出最大长度限制，会自动进行截断； 3. 显示字数统计：在字段旁显示当前已输入的字数统计，帮助用户实时了解已输入的字数； 4. 头部icon / 尾部icon / 标签icon ：用于设置字段上展示的图标； 5. 标签文字提示：对该字段的标签（名称）进行提示说明； 6. 添加后置按钮：在字段的末尾添加一个按钮。这个按钮可以用于触发特定的操作，如清空字段内容、执行验证、执行其他操作等； 7. 后置按钮禁用：允许在某些情况下禁用后置按钮。可以根据需要设置按钮的禁用状态； 8. 后置按钮icon：添加后置按钮后，按钮的icon标识； ## 2. 长文本 功能说明：长文本类型字段通常用于收集用户输入的较长或详细的信息。 应用场景：通常用于收集用户的意见、描述、备注等内容。 字段属性说明： 常见属性  行数：若无需自动适应高度，则可自定义设置字段的显示行数，可以根据需要显示的文本行数，例如设置为3行或5行等。根据指定的行数，文本字段将自动进行高度调整，以容纳输入的文本。 其他属性内容设置同 [文本字段属性] ## 3. 整数 / 精度小数/金额 整数：用于接收整数数值的字段类型。适用于需要收集数量、计数或年龄等整数值的场景。 精度小数：用于接收带有小数点的数值，可以设置精确度和小数位数。数字字段录入的数字，可以进行计算、统计、汇总等。例如商品单价、请假天数等。 金额：用于接收货币金额的字段类型。适用于需要收集金额、成本或价格等与货币有关的信息的场景。 字段属性说明： 高级属性 1. 控制按钮位置：如果选择显示控制按钮，该属性用于指定控制按钮的位置。default为默认位置，控制按钮增减居于字段不同侧，right居于字段尾部，如下图：  2. 最大值：该属性用于设置整数字段所允许的最大值。用户无法输入大于该数值的整数； 3. 最小值：该属性用于设置整数字段所允许的最小值。用户无法输入小于该数值的整数； 4. 精度：精度属性用于控制整数字段的小数位数。对于整数类型的字段，精度通常设置为0，表示不允许包含小数； 5.增减步长：该属性定义了在使用控制按钮（如增加按钮或减少按钮）调整数值时，每次增加或减少的数值。例如，增长步长设置为1时，每次点击增加按钮或减少按钮，数值将增加或减少1； 其他属性内容设置同 [文本字段属性] ## 4. 百分比 百分比：用于表示百分比值的字段类型，适用于需要收集百分比比例或指标的场景，如利润率、完成度等。 字段属性说明： 高级属性  1. 最大值：该属性用于设置整数字段所允许的最大值。用户无法输入大于该数值的整数； 2. 最小值：该属性用于设置整数字段所允许的最小值。用户无法输入小于该数值的整数； 3. 增减步长：该属性定义了在使用控制按钮（如增加按钮或减少按钮）调整数值时，每次增加或减少的数值。例如，增长步长设置为1时，每次点击增加按钮或减少按钮，数值将增加或减少1； 4. 是否范围选择：开启之后，百分比数值只能根据增减步长成倍选中，不支持选中其他数值； 其他属性内容设置同 [文本字段属性] ## 5. 单选项 功能说明：用于提供单选选项的字段类型。适用于需要用户从多个选项中选择一个的场景，如性别、类别等。 字段属性说明： 常见属性  1. 选项设置：支持设置默认选中的选项； 2. 显示样式：行内、块，支持切换单选框的布局样式； 3. 显示为按钮、带有边框：这是单选按钮组的展示样式； 其他属性内容设置同 [文本字段属性] ## 6. 级联单选 功能说明：用于提供单选选项的字段类型。适用于需要用户从多个选项中选择一个的场景，如状态、类别等，区分于单选按钮组的是级联单选可以层级选择。 字段属性说明： 常见属性  1. 可搜索选项：开启后，允许用户在单选项字段中搜索匹配的选项。输入关键词，系统会自动过滤选项并显示匹配的结果，方便用户快速选择所需选项； 2. 任意节点可选：未开启时，多层级联选项，只能选到最末级节点的选项；开启之后，所有节点均可被选中； 3. 显示完整路径：未开启时，只展示被选中的节点名称；开启之后，展示选中节点的路径，例如：陕西省/西安市/西咸新区； 其他属性内容设置同 [文本字段属性] ## 7. 复选项 功能说明：用于提供多选选项的字段类型。适用于需要用户从多个选项中选择一个或多个的场景，如兴趣爱好、标签等。 字段属性说明： 常见属性  所有属性内容设置同 [单选框字段属性] ## 8. 级联复选 功能说明：用于提供多选选项的字段类型。适用于需要用户从多个选项中选择一个或多个的场景，如兴趣爱好、标签等，区分于复选框的是级联复选支持层级选择。 字段属性说明： 常见属性  所有属性内容设置同 [级联单选字段属性] ## 9. 日期/日期时间 功能说明：用于接收日期和时间值的字段类型。适用于需要收集特定日期的场景，如出生日期、项目截止日期、会议时间、活动开始时间等。 字段属性说明： 常见属性  1. 可输入：开启后，允许用户输入日期或日期时间的值。可以通过点击或手动输入来选择日期或日期时间； 2. 显示格式：设置不同的显示格式，如年-月-日 (YYYY-MM-DD)、月/日/年 (MM/DD/YYYY) 或者其他格式。显示格式对应于用户在界面上看到的日期或日期时间的展示方式。 3. 绑定值格式：绑定值格式定义了该字段在提交表单时所使用的日期或日期时间的格式。不同的系统和后台处理程序需要不同的日期或日期时间格式。 其他属性内容设置同 [文本字段属性] ## 10. 图片/文件 图片：用于上传和显示图像的字段类型。适用于需要用户上传图片或显示相关图像的场景，如头像、产品图片等。 文件：用于上传和处理文件的字段类型。适用于需要用户上传和管理文件（如文档、音频、视频等）的场景。 字段属性说明： 常见属性   1. 发送cookie凭证：如果应用程序需要验证用户身份或对上传的文件进行权限控制，则可以选择在上传请求中发送Cookie凭证，以确保只有经过身份验证的用户才能成功上传文件。 2.最大上传数量：限制一次上传的文件数量。可根据业务需求设置最大允许的上传数量，确保用户不会一次上传过多的文件。 3.文件大小限制：设置图片上传的文件大小限制，以确保用户上传的文件不超过规定的大小，例如可设置为最大允许上传10MB大小的文件。 4.上传文件类型：规定用户只能上传特定类型的图片文件，例如doc、xls等。这可以防止用户上传不支持的文件类型，从而保证上传的文件格式符合需求。 其他属性内容设置同[文本字段属性] ## 11. 一对一引用 功能说明：用于建立数据之间一对一关系的字段类型。适用于需要建立和管理不同数据记录之间关系的场景，如员工与部门的关系等。 引用字段回填配置可将您选中数据的某些字段回填到当前表单的对应字段上。（注：回填与被回填字段类型需一致！） 字段属性说明：同[文本字段属性]  ## 12. 布尔 功能说明：布尔类型的字段通常用于表示一个是或否的逻辑值，即只有两个可能的取值：是（True）或否（False）。该类型字段主要用于条件判断、开关和选择性信息等。 字段属性说明： 高级属性  1. 开关宽度：用于设置布尔开关的宽度值，一般根据开关上的文字长短设置； 2. 开启时文字描述：用于设置开关开启时，开关上展示的文字； 3. 关闭时文字描述：用于设置开关关闭时，开关上展示的文字； 4. 开启时背景：用于设置开关开启时，开关的背景颜色； 5. 关闭时背景：用于设置开关关闭时，开关的背景颜色； 其他属性同[文本字段属性] # 四、表单属性设置 功能说明：在页面右侧区域 - 全局设置中设置整个表单的属性。包括表单的样式、布局等。通过设置表单属性，可调整表单的外观和布局，以满足特定的设计需求，并提供更好的用户导航和交互体验。  1.全局组件大小：设置表单中组件（字段）的整体大小。 2.字段标签位置：定义字段标签的位置，可以选择放置在字段的左边或顶部。 3.字段标签对齐：指定标签在字段内的对齐方式，可以选择左对齐、居中或右对齐。 4.标签宽度：设置字段标签的宽度。