Plusieurs boutons, une seule réponse
Poser des boutons dont un seul reste choisi à la fois, chacun à sa place sur la page, tous rattachés à la même question.
Demandé avec
"type": "radio_group"
En mots de tous les jours
Écrit pour tout le monde. Il dit ce que cela pose sur une feuille de papier, et ne vous demande rien de plus.
Ce sont les petits ronds à choisir : monsieur ou madame, oui ou non, matin ou après-midi. Ils vont par groupe, et un seul reste marqué à la fois : quand le lecteur en choisit un autre, le premier se libère tout seul. Vous placez chaque bouton où vous voulez sur la feuille, en face de son intitulé, et vous les rattachez tous à la même question. Vous pouvez décider que, une fois un bouton choisi, le lecteur garde toujours une réponse.
Pour un développeur
Écrit pour celui qui écrit le programme appelant : le modèle, les unités, et les réglages qui portent le poids.
Le groupe est un seul champ nommé ; chaque bouton est un emplacement de la page qui tourne ce champ vers sa propre valeur. Chaque bouton porte donc son rectangle et sa valeur, et l'encadrement, le fond et les autres réglages communs valent pour le groupe entier. La valeur de départ et celle que rétablit une remise à zéro se disent par le nom du bouton. La marque affichée se choisit parmi cinq symboles, le disque plein par défaut. Un verrou facultatif garde une réponse en place une fois qu'un bouton est choisi.
Chaque clé, avec son défaut
La référence : quelles clés sont obligatoires, lesquelles sont facultatives, ce que vaut chacune par défaut et quelles combinaisons le serveur décline.
Clés obligatoires : name, chaîne ; options, tableau d'objets à value (chaîne, distincte de celle des autres boutons et de Off) et rect, tous deux obligatoires. Facultatives propres au groupe : selected, valeur du bouton retenu au départ ; default_selected, valeur du bouton que rétablit une remise à zéro ; symbol, valant check, cross, circle, diamond ou square (absent : le disque plein) ; no_toggle_to_off, booléen à false, qui garde une réponse une fois un bouton choisi. Facultatives communes à tous les champs : read_only, required, no_export, booléens à false ; background ; border (width obligatoire, color en lumière, style) ; pages, défaut vide ; relative_to. Refus croisé : une couleur CMJN ou d'un espace nommé dans border.color. Le groupe porte ses rectangles dans ses options : il n'a pas de rect à lui.
Une requête entière qui le dessine
Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.
{
"items": [
{
"type": "radio_group",
"name": "delivery",
"options": [
{"value": "morning", "rect": {"llx": 72, "lly": 700, "urx": 86, "ury": 714}},
{"value": "afternoon", "rect": {"llx": 72, "lly": 676, "urx": 86, "ury": 690}}
],
"border": {"width": 0.75}
}
]
}Champs de formulaire
Une case dans laquelle le lecteur écrit Une case que le lecteur coche Une liste dans laquelle le lecteur choisit L'emplacement réservé à une signature Un bouton sur lequel le lecteur appuie
Où aller ensuite
Chaque clé d'une requête, en une page Les vingt autres choses que l'on peut dessiner
Glossaire
- CMJN
- Les quatre encres d'une imprimerie : le cyan (un bleu), le magenta (un rose), le jaune et le noir. Un écran, lui, fabrique ses couleurs avec de la lumière. Un document qui part à l'impression dit donc ses couleurs en encres, et non en couleurs d'écran.