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 rapportée voulue.
Demandé avec
"type": "check_box"
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.
C'est la petite case carrée que l'on coche à l'écran, celle du « j'accepte les conditions » ou du « je souhaite recevoir la lettre d'information ». Vous choisissez où elle se trouve, sa taille, et la marque qui apparaît quand on clique : une coche, une croix, un rond, un losange ou un carré plein. Vous pouvez la faire démarrer déjà cochée. Et vous décidez du mot que le formulaire rapportera lorsqu'elle est cochée, ce qui est utile quand la réponse part vers un autre logiciel.
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.
La case est une annotation posée par-dessus le dessin ; l'encadrement lui donne sa silhouette visible et le fond lui donne sa couleur. L'état de départ et l'état que rétablit une remise à zéro se disent séparément : une case peut démarrer vide et se cocher à la remise à zéro. La valeur rapportée est celle que l'envoi du formulaire transmet ; sans indication, c'est Yes. La marque affichée se choisit parmi cinq symboles ; sans indication, c'est une coche pour une case et un disque pour un bouton radio.
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 ; 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) ; 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 le dessine
Envoyez ceci tel quel et un PDF revient. Rien n'en a été retiré.
{
"items": [
{
"type": "check_box",
"name": "terms",
"rect": {"llx": 72, "lly": 700, "urx": 86, "ury": 714},
"border": {"width": 0.75}
}
]
}Champs de formulaire
Une case dans laquelle le lecteur écrit 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
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.
- annotation
- Quelque chose posé sur une page plutôt que dessiné dedans : un rectangle cliquable, une case où taper, un bouton. Cela occupe sa propre place sur la feuille et c'est ce qui fait qu'un PDF répond à un clic.