表单项
表单项用于在表单或表单容器中进行具体字段的数据录入。
一、何时使用
- 在表单或表单容器中，需输入结构化字段时使用
- 在表格上方实现搜索或筛选功能时使用
二、属性配置
1. 数据绑定
- 数据项：绑定模型字段，用于数据收集与表单验证。
- 校验规则生效的前提：表单项的数据绑定字段需与容器绑定模型字段一致。
示例：文本输入框设置“必填”规则：
2. 功能项配置
- 标签（Label）：表示字段名称，用于展示在输入框前的文字说明。
示例：
3. 校验配置
表单项支持添加多条校验规则，用于限制用户输入内容，提高数据准确性。
常见校验包括：
- 必填（不能为空）
- 字符串长度限制
- 正则表达式格式匹配（如手机号、邮箱）
💡 一个表单项可绑定多个校验规则。
点击规则输入框 → 选择 新建视图规则，将弹出配置界面：
校验规则说明：
| 配置项 | 说明 |
|---|---|
| 标题 | 规则的标识名，便于管理 |
| 错误信息 | 通用错误提示，应用于多个表单项 |
| 应用组件 | 可批量选择表单项进行应用，可设置每个组件独立的错误信息 |
| 必填 | 不可为空，可选“空格是否视为非法”选项 |
| 长度 | 字符串长度限制（最小/最大） |
| 正则表达式 | 用于校验格式的表达式，如邮箱、手机号码等 |
示例：
-
必填规则配置
-
长度限制配置
-
正则表达式配置
常用表达式示例：
-
手机号码（中国）：
^((\+?86)|(\(\+86\)))?((((13[^4])|(14[5-9])|147|(15[^4])|166|(17\d)|(18\d)|(19[12589]))\d{8})|((134[^9]|1410|1440)\d{7}))$ -
电子邮箱：
^\w+([-+.]\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$
-
4. 外观设置
4.1 标签对齐方式
支持以下对齐方式：
- 左对齐（默认）
- 右对齐
- 居中
- 上对齐
- 无标签
示例：
4.2 标签宽度
- 可自定义设置标签宽度，单位支持像素（px）或百分比（%）
示例：
4.3 垂直居中
- 控制标签与输入框是否垂直居中排列，适用于表单布局优化
三、常见使用场景
示例：设置新增小组名称的校验规则
- 必填
- 最小长度：2
- 最大长度：10
示例图：
