文字標籤 - 基礎和語法

了解文字標籤所需的確切結構，以便正確識別您的欄位，並讓欄位如預期般運作。

文字標籤讓您可直接在文件中輸入結構化預留位置，以建立表單欄位。其快速且功能強大，但只有在語法確切準確時才能運作。

本頁面說明文字標籤的必要結構、各部分的功能，以及為了正確識別標籤所必須遵循的規則。

必要的標籤圍繞符號 (大括弧)

每個文字標籤都必須使用兩個大括弧括住：

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

大括弧是必要的，且可滿足兩個用途：

• 告知 Acrobat Sign 文字標籤的開始和結束位置。
• 定義產生欄位的初始寬度和高度。
  • 第一個大括弧的大小 (字型) 決定了欄位高度。 
    • 若第一個大括弧的字型較大，會建立較高的欄位。
    • 標籤的其餘部分可以是不同的字型大小，但必須為 2 點或更大。
  • 大括弧 (包括大括弧本身) 之間的空間決定了欄位的整體寬度。 
    • 若大括弧之間的間距較寬，會建立較寬的欄位
    • 空格也計算在內。

如果缺少大括弧或格式錯誤，則會將文字視為純文字，不會建立欄位，且在上傳表單後，您會看到表單上顯示出標籤文字。

如需文字標籤的更廣泛說明及使用時機，請參閱文字標籤概觀。

文字標籤的必要結構

在大括弧內，每個文字標籤都必須遵循此結構：

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)}}

此標籤：

• 使用大括弧來定義欄位邊界和大小
• 建立文字欄位
• 將其指派給第一個簽署者
• 將其設為必要
• 對簽署者顯示工具提示

如需其他簡單和複合範例，請參閱文字標籤範例。

需要及早了解的重要規則

文字標籤在設計上十分嚴格。請謹記這些規則：

• 標籤會在文件上傳時處理。
• 沒有撰寫時驗證。
• 錯誤不會產生警告。
• 會將格式錯誤的標籤視為純文字。

如果某些部分無法運作，請先假設是語法問題，並查看文字標籤疑難排解。