Balises de texte - Principes de base et syntaxe

Comprenez la structure exacte requise par les balises de texte pour que vos champs soient reconnus correctement et se comportent comme prévu.

Les balises de texte vous permettent de créer des champs de formulaire en saisissant des espaces réservés structurés directement dans votre document. Elles sont rapides et puissantes, mais ne fonctionnent que lorsque la syntaxe est exacte.

Cette page explique la structure requise d'une balise de texte, le rôle de chaque partie et les règles à respecter pour que les balises soient reconnues correctement.

Encadrement de balise requis (accolades)

Chaque balise de texte doit être encadrée par des accolades doubles :

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

Les accolades sont requises et servent deux objectifs :

• Elles indiquent à Acrobat Sign où la balise de texte commence et où elle se termine.
• Elles définissent la largeur et la hauteur initiales du champ généré.
  • La taille (police) de la première accolade détermine la hauteur du champ. 
    • Une taille de police plus grande sur la première accolade crée des champs plus hauts.
    • Le reste de la balise peut avoir une taille de police différente, mais doit faire 2 pt ou plus.
  • L'espace entre les accolades (y compris les accolades elles-mêmes) détermine la largeur globale du champ. 
    • Un espacement plus large entre les accolades crée des champs plus larges
    • Les espaces comptent.

Si les accolades sont manquantes ou mal formées, le texte est traité comme du texte brut, aucun champ n'est créé et vous verrez le texte de la balise affiché sur votre formulaire après son téléchargement.

Pour une orientation plus large sur les balises de texte et quand les utiliser, consultez Présentation des balises de texte.

Structure requise d’une balise de texte

À l'intérieur des accolades, chaque balise de texte doit suivre cette structure :

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

Cette structure est stricte. Réorganiser les éléments ou omettre les parties requises peut entraîner un échec silencieux ou un comportement non souhaité.

Éléments requis (dans l'ordre)

Nom du champ

Le nom du champ identifie le champ de formulaire dans Acrobat Sign.

• Doit être unique dans le document.
• Ne doit pas contenir d'espaces.
• Est utilisé pour la création de rapports et l'extraction des données.

Identifiant _es_

L'identifiant _es_ indique à Acrobat Sign que le texte représente une balise de texte.

• _es_ est requis.
• Sans lui, la balise est traitée comme du texte brut.

Rôle du signataire

Le rôle du signataire définit à quel destinataire appartient le champ.

• Incluez toujours un rôle de signataire.
• Le rôle du signataire doit inclure un numéro pour indiquer à quel destinataire le champ est destiné. 

Rôles de signataire pris en charge

Les balises de texte attribuent des champs aux destinataires en utilisant des rôles de signataire positionnels.

Le format de rôle de signataire pris en charge est :

:signerN

Où N est un nombre commençant à 1 qui correspond à la position du destinataire dans l’ordre de signature.

Exemples :

• :signer1 — premier destinataire
• :signer2 — deuxième destinataire
• :signer3 — troisième destinataire

Les balises de texte n’imposent aucune limite supérieure. Un rôle de signataire doit correspondre à un destinataire réel dans l’accord pour que le champ soit attribué.

Les balises de texte ne prennent pas en charge les rôles nommés ou sémantiques. Seuls les rôles de signataire positionnels sont reconnus.

L'exception à la règle est le rôle :prefill :

• :prefill : champs attribués à l’expéditeur de l’accord et qui doivent être remplis après l’envoi de l’accord, mais avant la notification du premier signataire.
  • Aucun nombre n’est utilisé car cette position intervient avant le cycle de signature proprement dit.

Type de champ

Le type de champ détermine le type de champ de formulaire créé.

Voici des exemples courants :

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

Seuls les types de champs pris en charge sont reconnus. Les types de champs non pris en charge sont ignorés.

Pour la liste complète et le comportement spécifique aux champs, consultez Types de champs pris en charge par les balises de texte.

Directives (facultatif)

Les directives modifient le comportement du champ.

Les exemples incluent :

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

Les directives doivent apparaître après le type de champ et doivent suivre la syntaxe correcte.

Pour les interactions de directives complexes, consultez Comportements avancés des balises de texte.

Exemple : une balise de texte complète et valide

{Full_name_es_:signer1:text:required:tooltip(saisissez votre nom légal complet)}}

Cette balise :

• Utilise des accolades pour définir la limite et la taille du champ
• Crée un champ de texte
• L’attribue au premier signataire
• Le rend obligatoire
• Affiche une infobulle au signataire

Pour des exemples simples et composés supplémentaires, consultez Exemples de balises de texte.

Règles importantes à comprendre dès le début

Les balises de texte sont impitoyables par conception. Gardez ces règles à l’esprit :

• Les balises sont traitées lors du téléchargement du document.
• Il n'y a pas de validation au moment de la création.
• Les erreurs ne génèrent pas d'avertissements.
• Les balises mal formées sont traitées comme du texte brut.

Si quelque chose ne fonctionne pas, supposez d'abord un problème de syntaxe et vérifiez Dépannage des balises de texte.