文本标记 - 基础知识和语法

了解文本标记所需的确切结构，以便正确识别您的字段并按预期运行。

文本标记让您可以通过直接在文档中键入结构化占位符来创建表单字段。它们快速而强大，但只有在语法完全正确时才能正常工作。

本页面说明了文本标记的必需结构、各部分的作用，以及为了正确识别标记而必须遵循的规则。

必需的标记封装（花括号）

每个文本标记都必须用双花括号括起来：

{field-name_es_:signer-role:field-type:directive1:directive2}}

花括号是必需的，有两个用途：

• 它们告诉 Acrobat Sign 文本标记的开始和结束位置。
• 它们定义生成字段的初始宽度和高度。
  • 第一个括号的大小（字体）决定字段高度。 
    • 第一个括号的字体越大，创建的字段就越高。
    • 标记的其余部分可以使用不同的字体大小，但必须是 2pt 或更大。
  • 括号之间的空间（包括括号本身）决定字段的整体宽度。 
    • 括号之间的间距越宽，创建的字段就越宽
    • 空白字符也计算在内。

如果缺少花括号或花括号格式错误，文本将被视为纯文本，不会创建字段，您将在表单上传后看到标记的文本打印在表单上。

有关文本标记的更广泛介绍以及何时使用它们，请参阅文本标记概述。

文本标记的必需结构

在花括号内，每个文本标记都必须遵循以下结构：

field-name_es_:signer-role:field-type:directive1:directive2

此结构是严格的。重新排序元素或省略必需部分可能会导致静默失败或意外行为。

必需元素（按顺序）

字段名称

字段名称标识 Acrobat Sign 中的表单字段。

• 在文档内必须是唯一的。
• 不应包含空格。
• 用于报告和数据提取。

_es_ 标识符

_es_ 标识符告诉 Acrobat Sign 文本代表文本标记。

• _es_ 为必需。
• 没有它，标记将被视为纯文本。

签名者角色

签名者角色定义了字段所属的收件人。

• 始终包含签名者角色。
• 签名者角色必须包含一个数字，以指示该字段针对哪个收件人。 

支持的签名者角色

文本标记使用位置签名者角色将字段分配给收件人。

支持的签名者角色格式为：

:signerN

其中 N 是从 1 开始的数字，对应收件人在签名顺序中的位置。

示例：

• :signer1 — 第一个收件人
• :signer2 — 第二个收件人
• :signer3 — 第三个收件人

文本标签本身没有设置上限。签署者角色必须对应协议中的实际收件人，字段才能被分配。

文本标签不支持命名角色或语义角色。只识别位置签署者角色。

该规则的例外是 :prefill 角色：

• :prefill — 分配给协议发送者的字段，必须在发送协议后但在通知第一个签署者之前填写。
  • 不使用数字，因为此位置发生在实际签署周期之前。

字段类型

字段类型决定创建的表单字段类型。

常见示例包括：

• :text
• :signature
• :date
• :checkbox

只识别支持的字段类型。不支持的字段类型将被忽略。

有关完整列表和字段特定行为，请参阅文本标签支持的字段类型。

指令（可选）

指令修改字段的行为方式。

示例包括：

• :required
• :tooltip()
• :readOnly
• :calc()
• :format()

指令必须出现在字段类型之后，并且必须遵循正确的语法。

对于复杂的指令交互，请参阅文本标记高级行为。

示例：完整、有效的文本标记

{full_name_es_:signer1:text:required:tooltip(Enter your full legal name)}}

此标记：

• 使用大括号定义字段边界和大小
• 创建文本字段
• 将字段分配给第一位签名者
• 将其设为必填
• 向签名者显示工具提示

有关其他简单和复合示例，请参阅文本标记示例。

需要尽早了解的重要规则

文本标记在设计上要求严格。请牢记以下规则：

• 标记在文档上传时进行处理。
• 不提供编辑时的实时验证。
• 错误不会生成警告。
• 格式错误的标记将被视为纯文本。

如果某些功能无法正常工作，请首先假设是语法问题，并参阅文本标记故障排除。