Une case que le lecteur coche
Ajouter une case à cocher : accepter des conditions, choisir une option, avec la marque de votre choix et la valeur que le formulaire renvoie.
Le résultat dans un vrai PDF
Un formulaire PDF/A-3 archivable
Un formulaire qui est aussi un fichier PDF/A-3 : chaque champ déjà tracé, avec un cadre visible, n’attendant rien du logiciel de lecture.
Ouvrir le PDF Voir l’exemple complet
Également dans les exemples : Un formulaire interactif
Résumé
La petite case carrée que l’on coche à l’écran, celle qui suit « j’accepte les conditions » ou « je souhaite recevoir la lettre d’information ». Au clic, la marque apparaît : une coche, une croix, un rond, un losange ou un carré plein, à votre goût. Vous pouvez la faire démarrer déjà cochée. Et c’est vous qui choisissez le mot qu’elle renvoie une fois cochée, ce qui est utile quand la réponse part vers un autre logiciel.
Techniquement
Demandé avec
"type": "check_box"
La case est une annotation /Widget et un champ /FT /Btn à deux états d’apparence, /Off et l’état coché, posés par-dessus ce que les autres éléments ont dessiné ; /AS dit lequel est montré, la bordure donne à la case son contour visible et le fond sa couleur. L’état de départ, /V, et l’état qu’une remise à zéro rétablit, /DV, se disent séparément : une case peut partir vide et devenir cochée à la remise à zéro. La valeur rapportée est le nom de l’état coché, ce que l’envoi du formulaire transmet ; en son absence, c’est Yes. La marque montrée se choisit parmi cinq symboles ; en son absence, c’est une coche pour une case et un disque pour un bouton radio.
Schéma de la requête
Clés obligatoires : name, chaîne ; rect. Facultatives propres à la case : checked, booléen à false, état de départ ; checked_by_default, booléen à false, état que rétablit une remise à zéro ; symbol, valant check, cross, circle, diamond ou square (absent : la coche) ; export_value, chaîne rapportée quand la case est cochée (absent : Yes). Facultatives communes à tous les champs : read_only, required, no_export, booléens à false ; background ; border (width obligatoire, color en lumière, style) ; tooltip et description, chaînes, absentes n’écrivant aucune entrée de ce genre ; mapping_name, chaîne, nom sous lequel un formulaire envoyé rapporte la réponse ; flags, les indicateurs décrits sur la page du champ de texte, leur absence imprimant la case sans rien dire d’autre ; triggers, une action par moment, les dix étant énumérés sur la page du champ de texte ; pages, défaut vide ; relative_to. Refus croisé : une couleur CMJN ou d’un espace nommé dans border.color. symbol accepte aussi star, une étoile pleine à cinq branches. Chaque champ prend aussi mark, l’étiquette sous laquelle l’arbre de structure le réclame, par les annotations d’un nœud.
Une requête entière qui crée un PDF
{
"items": [
{
"type": "check_box",
"name": "terms",
"symbol": "check",
"rect": {"llx": 72, "lly": 700, "urx": 86, "ury": 714},
"border": {"width": 0.75}
}
]
}
Champs de formulaire
Un champ que le lecteur remplit Une liste dans laquelle le lecteur choisit Plusieurs boutons, une seule réponse L’emplacement réservé à une signature Un bouton sur lequel le lecteur appuie
Où aller ensuite
Toutes les clés JSON d’une requête, en une page Les vingt-deux autres choses que l’on peut dessiner