> ## 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.

# 单行文字 & 多行文字

> 当需要收集文字信息（如姓名、公司名、建议）时，可使用单行/多行文字字段，支持格式验证和字数限制。

## 字段区别

「单行文字」适合收集字数较少的内容，比如：公司名、学校名。输入框为一行，最多可填写 300 个字

「多行文字」适合收集字数较多的内容，如：需求建议、反馈详情、备注信息等。输入框可调整高度，最多可填写 10,000 个字。

文本框支持切换字段类型，在单行文字和多行文字间进行切换。

***

## 填写设置

这两个字段，虽然简单，但是能量不可小觑。接下来我们一起了解它们的设置项和使用场景，看看如何提升它们的战斗力。

![PC|字段设置|单行文字字段右侧设置区域显示「默认值」「占位符」「校验」选项](https://help-assets.jinshuju.net/assets/file/14065/%E6%96%87%E6%9C%AC%E7%B1%BB-%E5%A1%AB%E5%86%99%E8%AE%BE%E7%BD%AE.png)

以下多数场景会搭配 [自定义出错文案](/v4/articles/customize-texts#表单填写时的出错文案) 功能，当填表者在提交不符合校验规则的数据时，会显示预先设置的提示文案。

## 默认值/占位符

### **默认值**

是展示在输入框中的占位文字，可以用来补充说明。

比如：准考证前几位数字一般是相同的， 因此可提前将准考证前几位相同内容设置为默认值，填表者只需要在后续输入其他内容。

![PC|字段设置|单行文字字段设置「默认值」预填准考证前几位相同内容](https://help-assets.jinshuju.net/assets/file/14066/%E9%BB%98%E8%AE%A4%E5%80%BC.png)

### 占位符

用来提示表单填写者在文本框输入的内容和格式，当填写者填写内容时，占位符内容会自动消失。

![PC|字段设置|单行文字字段设置「占位符」提示填写内容和格式](https://help-assets.jinshuju.net/assets/file/14067/%E5%8D%A0%E4%BD%8D%E7%AC%A6.png)

⚠️注意：“占位符”和“默认值”不能同时启用，只能选其一。

## 白名单/黑名单

[白名单](/v4/articles/whitelist) 开启后，可限制只有在白名单内的数据才能正常提交。通常适用于设置指定人群可填写、每人凭自己的密码填写等场景。

如：指定填表人群，只有被官方正式邀请的企业才可以填写。

![PC|字段设置|单行文字字段开启「白名单」限制指定人群填写表单](https://help-assets.jinshuju.net/assets/file/14069/%E7%99%BD%E5%90%8D%E5%8D%95.png)

[黑名单](/v4/articles/blacklist)—— 企业基础版及以上套餐支持。开启后，可限制黑名单内的数据不能提交。

如：某个报名活动，被拉入公司黑名单人员无报名资格。

![PC|字段设置|单行文字字段开启「黑名单」限制黑名单内数据提交](https://help-assets.jinshuju.net/assets/file/14070/%E9%BB%91%E5%90%8D%E5%8D%95.png)

⚠️注意：白名单和黑名单数量上限为 5,000 个。

## 微信扫码录入

在物流单号登记场景中，「单行文字」字段支持在微信中打开使用扫码录入功能，扫码后会自动提取二维码/条形码信息填入字段内，避免手动录入过程中的人为失误。另外你也可以根据需要，选择在一串字符中截取部分信息录入。 [点击查看详细介绍](/v4/articles/scan-code)

![移动端|表单填写|单行文字字段使用「微信扫码录入」功能扫描二维码填入](https://help-assets.jinshuju.net/assets/file/14072/%E6%89%AB%E7%A0%81%E5%BD%95%E5%85%A5.gif)

## 不能和已有数据重复

如：身份证是每个人进行多种报名程序的唯一认证方式，开启**不能和已有数据重复**后，可以确保收集到的每条数据都是独一无二的。

![PC|字段设置|单行文字字段开启「不能和已有数据重复」确保数据唯一](https://help-assets.jinshuju.net/assets/file/14073/%E4%B8%8D%E8%83%BD%E9%87%8D%E5%A4%8D.png)

## 字数限制

你可以限制允许输入的字符数，如最大值与最小值。限制字数会展示在字段名称旁提示填表人，系统会在输入内容完成后根据规则校验是否满足限制，不合规会以红色文字提示。

汉字、英文、数字、特殊符号和空格均算一个字。

![PC|字段设置|单行文字字段设置「最少填写字数」「最多填写字数」限制](https://help-assets.jinshuju.net/assets/file/14074/%E5%AD%97%E6%95%B0%E9%99%90%E5%88%B6.png)

## 数据格式校验

对数据设置格式校验，可避免填表人提交的数据格式错误、不规范，减轻后期处理数据的时间成本。

如：校验常规车牌号和新能源车牌号格式是否正确（无法验证车牌号真伪）。支持 7 位「常规车牌号」与 8 位「新能源车牌号」的格式校验；可用于以下车牌号的校验：普通车牌号，教练车牌号，警等车牌号，部分部队车牌号。 若需了解更多格式校验类型，[点此查看详细介绍](/v4/articles/verification)。

![PC|字段设置|单行文字字段选择「数据格式校验」验证车牌号格式正确性](https://help-assets.jinshuju.net/assets/file/14076/%E6%A0%BC%E5%BC%8F%E6%A0%A1%E9%AA%8C.png)

⚠️注意：如果需要给收集到的手机号或邮箱号者发短信或邮件，请添加「手机」或「邮箱」字段。

## 体验表单

以下是单行文字和多行文字示例表单：[点击填写](https://jinshuju.net/f/IEGMhA)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.