> ## Documentation Index
> Fetch the complete documentation index at: https://jinshuju-20a27453.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 字段属性设置介绍
> 字段属性设置是表单设计的核心功能模块，通过配置不同的属性参数，你可以精确控制表单字段的展示样式、填写规则、数据校验、权限管理等行为，从而提升数据收集的准确性、安全性和用户填写体验。
**核心价值**：
* 🎯 **数据质量保障** - 通过格式校验、去重设置、正则表达式确保数据准确规范；
* 👥 **用户体验优化** - 通过默认值、占位符、自动填充减少填写负担；
* 🔒 **权限精准控制** - 通过黑白名单、字段隐藏实现定向数据收集；
* 📊 **灵活布局设计** - 通过宽度、序号、折叠等设置美化表单界面；
* ⚡ **效率工具集成** - 通过扫码录入、字数限制提高填写效率。
***
## 一、设置「字段默认值」介绍
**「字段默认值」场景：** 当表单中某些字段有固定或常用值时使用。
**「字段默认值」功能说明**：
* 预先填充在输入框中的实际内容；
* 用户可以直接使用或修改默认值；
* 提交时会将默认值作为实际数据保存。
**「字段默认值」可用字段**：
* 文本类：单行文字、多行文字、网址；
* 选择类：单项选择、多项选择、图片单选、图片多选、下拉框、多级下拉框；
* 信息类：姓名、手机、地址；
* 时间类：日期、时间。
**「字段默认值」配置方法**：
1. 进入表单编辑页面；
2. 点击需要设置的字段；
3. 在右侧属性面板找到「默认值」；
4. 输入或选择默认内容；
5. 保存设置。
**「字段默认值」应用案例**：
```示例1：批量录入场景 theme={null}
示例1：补充其他信息
字段：准考证号
默认值：「2024010000」
说明：所有考生准考证号前 10 位相同，填表人只需输入后 4 位个人编号
```
`示例2：地址填写场景`\
`字段：公司地址`\
`默认值：「北京市朝阳区望京 SOHO T1 栋」`\
`说明：内部员工填写时自动带入公司地址`
`示例3：时间记录场景`\
`字段：填写日期`\
`默认值：今天`\
`说明：自动填充当天日期，减少手动选择`
**「字段默认值」使用注意事项**：
* ⚠️ 默认值与占位符互斥，只能选择其一；
* ⚠️ 默认值会被统计为实际数据；
* ⚠️ 修改默认值不影响已提交的数据。
***
## 二、设置「字段占位符」介绍
**「字段占位符」场景：** 需要提示用户输入格式或内容要求时使用。
**「字段占位符」功能说明**：
* 显示在空白输入框内的灰色提示文字；
* 用户开始输入时自动消失；
* 不会作为数据被提交。
**「字段占位符」可用字段**：
* 文本类：单行文字、多行文字、网址；
* 信息类：姓名、手机、邮箱、身份证。
**「字段占位符」应用案例**：
| 字段类型 | 占位符示例 | 作用说明 |
| - | - | - |
| 手机号 | 「请输入 11 位手机号码」 | 提示格式要求 |
| 邮箱 | 「[example@company.com](mailto:example@company.com)」 | 展示标准格式 |
| 身份证 | 「请输入 18 位身份证号码」 | 明确位数要求 |
| 网址 | 「[https://www.example.com](https://www.example.com)[」](https://www.example.xn--com-k03b/) | 提示完整 URL 格式 |
| 姓名 | 「请输入真实姓名」 | 强调真实性要求 |
| 多行文字 | 「请详细描述您的建议（不少于 50 字）」 | 说明内容和字数要求 |
**「字段占位符」与「字段默认值」的区别**：
| 对比维度 | 默认值 | 占位符 |
| - | - | - |
| 显示效果 | 黑色实际文字 | 灰色提示文字 |
| 是否可编辑 | 可直接修改 | 输入时消失 |
| 是否提交 | 作为数据提交 | 不会提交 |
| 使用场景 | 有常用固定值 | 仅需格式提示 |
| 可否共存 | 不可以 | 不可以 |
***
## 三、「字段展示宽度」设置介绍
**「字段展示宽度」场景：** 优化表单布局，提升视觉体验；只能在电脑端生效，移动端展示为一题一行。
**「字段展示宽度」功能说明**： 控制字段在页面中占据的宽度比例，实现灵活的表单布局设计。
**「字段展示宽度」支持字段**： 单行文字、多行文字、单项选择、多项选择、数字、时间、日期、下拉框、网址、评分、两级下拉框、表单关联、地址、姓名、手机、邮箱、电话。
**「字段展示宽度」设置选项说明**：
* **1/4 宽度（25%）** - 适合短文本和选项；
* **2/4 宽度（50%）** - 适合中等长度内容；
* **3/4 宽度（75%）** - 适合较长内容；
* **4/4 宽度（100%）** - 占满整行。
***
## 四、设置「展示字段序号」介绍
**「展示字段序号」场景：** 问卷调查、考试测评等需要题号的场景。
**「展示字段序号」序号概述功能说明**： 为字段自动添加序号标记，便于用户定位和引用。
**「展示字段序号」支持字段**：所有字段。
**「展示字段序号」序号概述配置说明**：
1. 全局开启：表单设置中统一控制；
2. 单独控制：每个字段可独立设置是否显示序号。
***
## 五、设置「字段描述折叠展示」介绍
**「字段描述折叠展示」场景：** 字段说明内容较多，影响表单整体布局。
**「字段描述折叠展示」展示功能说明**： 当字段描述超过 300px 高度时自动折叠，保持表单简洁。
**「字段描述折叠展示」支持字段**：所有字段。
**「字段描述折叠展示」触发条件**：
* 描述内容高度 > 300px；
* 自动显示「展开/收起」按钮。
***
## 六、字段设置「不能和已有数据重复」介绍
**「不能和已有数据重复」场景：** 需要确保数据唯一性的场景。
**「不能和已有数据重复」功能说明**： 确保每条提交的数据在指定字段上保持唯一，防止重复提交。
**「不能和已有数据重复」支持字段**：单行文字、姓名、手机、身份证、固话、网址、邮箱、表单关联。
**「不能和已有数据重复」应用案例**：
| 应用场景 | 设置字段 | 业务价值 |
| - | - | - |
| 活动报名 | 手机号 | 防止一人多次报名占用名额 |
| 账号注册 | 邮箱 | 确保一个邮箱对应一个账号 |
| 资格认证 | 身份证 | 防止重复认证和资源浪费 |
| 订单编号 | 单行文字 | 确保订单号全局唯一 |
| 员工入职 | 工号 | 避免工号冲突 |
**「不能和已有数据重复」触发提示文案**：
* 默认提示：「该 \[填写内容] 已被使用」；
* 自定义示例：「此手机号已报名成功，无需重复提交」。
**「不能和已有数据重复」注意事项**：
* ⚠️ 开启后历史数据也会参与重复检查；
* ⚠️ 删除的数据不再占用唯一性；
* ⚠️ 区分大小写和空格。
***
## 七、「字段格式校验」设置介绍
**「字段格式校验」场景：** 需要验证特定格式的数据。
**「字段格式校验」功能说明**： 验证输入内容是否符合预设的格式规则，确保数据规范性。
**「字段格式校验」支持字段**：单行文字。
### 「字段格式校验」内置校验类型介绍
| 校验类型 | 格式说明 | 示例 |
| - | - | - |
| 车牌号 | 7 位常规/8 位新能源 | 京A12345、京AD12345 |
| 手机号 | 11 位数字 | 13812345678 |
| 邮箱 | 标准邮箱格式 | [user@domain.com](mailto:user@domain.com) |
| 身份证 | 18 位身份证 | 110101199001011234 |
| 网址 | URL 格式 | [https://www.example.com](https://www.example.com) |
### 「字段格式校验：正则表达式校验」设置介绍
**「字段正则表达式校验」套餐要求**：企业基础版及以上。
### 「字段格式校验」注意事项
* Excel 导入数据时，不做「数据格式校验」。
* 「数据格式校验」功能支持与其他校验功能同时启用，如：「必填项」「白名单」「不能和已有数据重复」「自定义出错文案」等功能。
* 「正则表达式」自定义输入内容长度不能超出 1,215 个字符。
* 填写正则表达式报错提示「正则表达式格式不对」，需要检查输入正则表达式前后是否都包含了「/」,以输入 10 位纯数字正则表达式为例： `^[0-9]{10}$` 在正则表达式填写的时需要在前后加上「/」例如：
/^\[0-9]\{10}\$/ 。
***
## 八、「字段字数限制」设置介绍
**「字段数字限制」场景：** 控制输入内容的长度。
**「字段数字限制」功能说明**： 限制字段允许输入的字符数量，包括最小值和最大值限制。
**「字段数字限制」适用范围**：单行文字、多行文字、姓名。
**「字段数字限制」计数规则**：
* 汉字、英文、数字、特殊符号、空格均算一个字符；
* 换行符算一个字符；
* 表情符号算 2 个字符。
**「字段数字限制」设置方式**：
| 限制类型 | 设置示例 | 应用场景 |
| - | - | - |
| 仅最小值 | 最少 50 字 | 意见反馈、详细描述 |
| 仅最大值 | 最多 140 字 | 简短评论、标题输入 |
| 区间限制 | 10-200 字 | 个人简介、产品描述 |
| 精确限制 | 必须 11 字 | 手机号、固定编码 |
***
## 九、「字段白名单」设置介绍
**「字段白名单」场景：** 限定特定人群填写表单、仅名单内的人员可提交。
**「字段白名单」功能说明**： 仅允许白名单内的数据通过校验并提交表单，实现精准的访问控制。
**「字段白名单」支持字段**：单行文字、姓名、手机、身份证。
**「字段白名单」配置方法**：
* 点击「添加白名单」；
* 对话框中输入允许的值，一行一个；
* 系统会自动去重。
**「字段白名单」应用案例**：
| 场景 | 白名单字段 | 名单内容 | 效果 |
| - | - | - | - |
| 员工内部调研 | 工号 | 全体员工工号列表 | 仅员工可参与 |
| VIP 专享活动 | 手机号 | VIP 会员手机号 | 精准营销 |
| 定向邀请报名 | 身份证 | 受邀人员身份证 | 防止名额占用 |
| 学生选课系统 | 学号 | 符合条件的学号 | 控制选课资格 |
***
## 十、「字段黑名单」设置介绍
**「字段黑名单」场景：** 限制特定数据不能提交。
**「字段黑名单」功能说明**： 禁止黑名单内的数据提交表单，用于风险控制和访问限制。
**「字段黑名单」套餐要求**：企业基础版及以上。
**「字段黑名单」支持字段**：单行文字、姓名、手机、身份证。
**「字段黑名单」应用案例**：
| 场景类型 | 黑名单内容 | 业务目的 |
| - | - | - |
| 风险控制 | 恶意用户手机号 | 防止恶意提交 |
| 资格限制 | 违规人员身份证 | 限制参与资格 |
| 防刷单 | 异常订单编号 | 防止重复刷单 |
| 合规管理 | 限制区域代码 | 地域访问控制 |
**字段「黑/白名单」对比**：
| 对比维度 | 白名单 | 黑名单 |
| - | - | - |
| 控制逻辑 | 仅允许名单内 | 仅禁止名单内 |
| 适用场景 | 少数人可访问 | 多数人可访问 |
| 维护成本 | 需频繁更新 | 按需添加 |
| 套餐要求 | 所有版本 | 企业基础版+ |
**「字段黑/白名单」注意事项**：
* ⚠️ 黑白名单不能同时启用；
* ⚠️ 支持通配符匹配（\*）；
* ⚠️ 区分大小写。
***
## 十一、「字段隐藏」设置介绍
**「字段隐藏」场景：** 临时停用或分阶段展示字段。
**「字段隐藏」功能说明**： 将字段设置为隐藏状态，仅管理员和数据维护员可见，普通填写者无法看到。
**「字段隐藏」不同身份权限介绍**：
| 角色 | 查看字段权限 | 编辑字段权限 | 数据填写权限 |
| - | - | - | - |
| 普通填写者 | ❌ | ❌ | ❌ |
| 数据维护员 | ✅ | ❌ | ✅ |
| 管理员 | ✅ | ✅ | ✅ |
***
## 十二、字段「自动填写上次提交内容」设置介绍
**「自动填写上次提交内容」场景：** 需要多次重复填写相似内容。
**「自动填写上次提交内容」功能说明**： 系统自动记忆并回填用户上次提交的内容，减少重复输入。
**「自动填写上次提交内容」工作机制**：
1. **用户识别**：通过 Cookie、登录账号 识别；
2. **数据读取**：获取该用户最近一次成功提交的数据；
3. **智能回填**：自动填充到对应字段（用户可修改）；
4. **隐私保护**：仅回填该用户自己的数据。
**「自动填写上次提交内容」适用场景详解**：
| 场景 | 自动回填字段 |
| - | - |
| 每日健康打卡 | 姓名、部门、常规健康状态 |
| 周报提交 | 姓名、部门、项目名称 |
| 物流下单 | 发货地址、联系方式 |
| 重复申请 | 基本信息、资质证明 |
***
## 十三、单行文字字段「微信扫码录入」设置介绍
**「微信扫码录入」场景：** 移动端快速录入条码/二维码信息。
**「微信扫码录入」功能说明**： 通过微信内置扫码功能，快速识别并录入条形码、二维码内容。
**「微信扫码录入」技术要求**：
* ✅ 必须在微信环境中使用；
* ✅ 仅支持单行文字字段；
* ❌ 不支持自定义域名（需使用 [jinshuju.net](http://jinshuju.net) 原始链接）。
**「微信扫码录入」支持的码制类型**：
* 条形码：Code128、Code39、EAN13、EAN8、UPC 等；
* 二维码：QR Code、Data Matrix、PDF417 等。
**「微信扫码录入」实际应用案例**：
| 应用场景 | 扫描内容 | 截取规则 | 最终录入 |
| - | - | - | - |
| 快递单号 | SF1234567890123 | 从第 3 位截取 12 位 | 1234567890123 |
| 商品条码 | 6901234567890 | 完整录入 | 6901234567890 |
| 员工工牌 | EMP-2024-001-DEPT | 截取第 5-12 位 | 2024-001 |
| 设备编号 | SN:ABC123XYZ | 从第 4 位开始 | ABC123XYZ |
**「微信扫码录入」故障排查**：
| 问题现象 | 可能原因 | 解决方案 |
| - | - | - |
| 提示「扫描失败」 | 使用了自定义域名 | 改用原始 jinshuju 链接 |
| 无法调起相机 | 未授权相机权限 | 在微信设置中开启权限 |
| 扫码按钮不显示 | 非微信环境 | 需在微信中打开表单 |
| 内容录入错误 | 截取规则设置错误 | 检查起始位置和长度 |
## 十四、字段「自定义出错提示」设置
**「自定义出错提示」场景：** 优化错误提示的友好性和指导性。
**「自定义出错提示」功能说明**： 为每个字段定制个性化的错误提示文案，提升用户体验和问题解决效率。
***
## 十五、字段属性相关功能套餐功能对照表
| 字段属性 | 免费版 | 基础版 | 企业基础版 | 企业协作版 | 企业高级版 |
| - | - | - | - | - | - |
| 字段默认值 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 字段占位符 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 字段宽度 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 字段不能和已有数据重复 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 字段白名单 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 字段黑名单 | ❌ | ❌ | ✅ | ✅ | ✅ |
| 字段格式校验 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 字段格式校验：正则表达式 | ❌ | ❌ | ✅ | ✅ | ✅ |
| 字段字数限制 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 字段隐藏 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 自动填写上一次提交内容 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 单行文字微信扫码 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 字段自定义出错提示 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 字段描述折叠 | ✅ | ✅ | ✅ | ✅ | ✅ |
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.