跳到主要内容

文本和长文本

文本和长文本都用于保存用户输入的文本。文本 适合保持单行展示的短内容。长文本 适合备注、说明或多行输入。

两者的大部分配置相同。长文本额外提供文本区域可见高度的行数控制。

基础配置​

配置项说明
名称展示给用户的字段标签，必填；名称应清楚表达字段的业务含义
API 名称数据接口、脚本、公式、导入和集成使用的稳定技术名称，必填
必填保存记录前必须填写该字段
只读字段可见，但用户不能编辑
停用字段不参与常规使用
隐藏字段会保存，但不在常规表单页面展示

基础标记之间会互相影响。例如，字段不能同时设置为必填和隐藏；只读字段也不能同时设置为必填、停用或隐藏。

通用文本配置​

配置项说明
占位提示用户输入前显示在输入框中的提示文案；可以用来说明输入格式或给出简短示例
最小长度允许提交的最少字符数；不需要限制时可以留空
最大长度允许提交的最多字符数；用于限制过长内容
正则规则用于格式校验的正则表达式；适合固定编码、限定字符范围等严格格式
最小长度提示内容短于最小长度时显示的自定义校验提示
正则提示内容不符合正则规则时显示的自定义校验提示
裁剪模式控制保存前是否去除首尾空格
输入状态给输入框添加警告或错误等视觉状态，用于让字段在页面中更明显
大小写转换控制保存前的字母大小写处理：保持原样、转大写或转小写
校验时机控制什么时候执行校验：值变更时、失焦时或提交记录时
显示字数在输入框中显示当前字符数量；字段有最大长度限制时更常用
颜色设置字段展示颜色
帮助文案展示在字段附近的辅助说明；适合填写用户需要持续看到的简短业务提示

正则示例​

当文本必须符合固定格式时，可以使用 正则规则。只有输入值匹配规则时，记录才能保存。

场景正则规则可以通过不能通过
只允许字母和数字^[A-Za-z0-9]+$A123、Order9A-123、Order 9
小写编码和下划线^[a-z][a-z0-9_]*$customer_code、order2CustomerCode、2order
固定 6 位数字编码^\d{6}$12345612345、ABC123
类手机号数字^\+?[0-9]{7,15}$13800138000、+14155552671138-0013-8000、phone123
以 SO- 开头后接数字^SO-\d+$SO-1001so-1001、SO-ABC

常用正则符号：

符号含义
^从输入值开头开始匹配
$匹配到输入值结尾
\d一个数字
+出现一次或多次
*出现零次或多次
{6}正好出现 6 次
[A-Za-z0-9]任意大写字母、小写字母或数字

建议同时填写 正则提示，让用户知道输入不符合规则时该怎么修改。

长文本行数配置​

配置项说明
最小行数文本区域最少显示行数
最大行数文本区域最多显示行数