Une liste dans laquelle le lecteur choisit
Offrir une liste de réponses : liste déroulée, menu qui s'ouvre, ou menu dans lequel le lecteur tape aussi sa propre réponse.
Résumé
Le pays, la taille d'un vêtement, le motif d'une demande : des réponses préparées à l'avance. Le lecteur choisit dans ce que vous proposez, ce qui évite les fautes de frappe et les réponses fantaisistes. Ce que le lecteur lit et ce que le formulaire retient peuvent être deux choses différentes : il voit « France », le formulaire garde « FR ».
Techniquement
Demandé avec
"type": "choice_field"
Le champ est un champ /FT /Ch dont le tableau /Opt tient chaque option soit comme une seule chaîne, valeur et étiquette confondues, soit comme un couple qui sépare la valeur rapportée de l'étiquette montrée. Les bits de /Ff choisissent la présentation — la liste qu'on fait défiler, le menu déroulant, le menu ouvert à la saisie — et la sélection multiple, qui laisse le lecteur choisir plusieurs options à la fois. La sélection de départ et celle qu'une remise à zéro rétablit sont données par valeur rapportée, et se disent séparément. Le drapeau de tri déclare que la liste est dans l'ordre alphabétique, tandis que le logiciel de lecture montre les options dans l'ordre où la requête les donne : le tri est donc à la charge de la requête.
Schéma de la requête
Clés obligatoires : name, chaîne ; rect ; font ; font_size ; options, tableau dont chaque entrée est une chaîne nue, ou un objet à value et label tous deux obligatoires. Facultatives propres au champ : selected, valeur rapportée de l'option retenue au départ ; default_selected, valeur rapportée de l'option que rétablit une remise à zéro ; presentation, valant list (défaut), dropdown ou editable ; multi_select et sorted, booléens à false ; align, valant left (défaut), center ou right. 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 le champ 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.
Une requête entière qui crée un PDF
{
"standard_fonts": [{"name": "sans", "face": "helvetica"}],
"items": [
{
"type": "choice_field",
"name": "country",
"rect": {"llx": 72, "lly": 700, "urx": 260, "ury": 718},
"font": "sans",
"font_size": 11,
"options": [
{"value": "FR", "label": "France"},
{"value": "GB", "label": "United Kingdom"}
],
"presentation": "dropdown",
"border": {"width": 0.75}
}
]
}Champs de formulaire
Un champ que le lecteur remplit Une case que le lecteur coche 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