Un bouton sur lequel le lecteur appuie
Poser un bouton qui agit au lieu de répondre : ouvrir une adresse, aller à une page, envoyer le formulaire ou le remettre à zéro.
Demandé avec
"type": "push_button"
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 le bouton sur lequel on appuie dans un document affiché à l'écran : « Envoyer », « Effacer », « Page suivante ». Il agit au lieu de recueillir une réponse. Vous écrivez le mot qui s'affiche dessus, et vous pouvez en prévoir un autre quand la souris passe au-dessus, et un troisième pendant l'appui. Vous pouvez aussi y mettre un petit dessin, seul ou à côté du mot, au-dessus, en dessous, à gauche ou à droite.
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.
Un bouton est le seul champ qui ne porte pas de valeur : appuyer agit, et ce qu'il fait est l'action que la requête lui accroche. Les trois libellés correspondent aux trois états — au repos, sous le pointeur, enfoncé — et les deux derniers, laissés de côté, reprennent celui du repos. L'icône est le nom d'un dessin déclaré par la requête ; sa mise en boîte se règle par un objet dédié, qui dit quand redimensionner, s'il faut garder les proportions et où l'icône se pose dans la place restante. La disposition choisit entre le mot seul, l'icône seule et les cinq façons de les associer.
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 ; font ; font_size. Facultatives propres au bouton : caption, rollover_caption, down_caption, chaînes (les deux dernières, absentes, reprennent caption) ; layout, valant caption_only (défaut), icon_only, caption_below_icon, caption_above_icon, caption_right_of_icon, caption_left_of_icon ou caption_over_icon ; icon, rollover_icon, down_icon, noms de dessins déclarés ; icon_fit, objet à scale (always, when_bigger, when_smaller, never), stretch (proportional, anamorphic), leftover_left et leftover_bottom (nombres de 0 à 1, les deux ensemble) et ignore_border (booléen à false) ; action, une des huit actions décrites sur la page du lien. 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és : leftover_left sans leftover_bottom, et l'inverse ; 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é.
{
"standard_fonts": [{"name": "sans", "face": "helvetica"}],
"items": [
{
"type": "push_button",
"name": "reset",
"rect": {"llx": 72, "lly": 700, "urx": 172, "ury": 722},
"font": "sans",
"font_size": 11,
"caption": "Clear the form",
"border": {"width": 0.75},
"action": {"reset_fields": {}}
}
]
}Champs de formulaire
Une case dans laquelle le lecteur écrit Une case que le lecteur coche Une liste dans laquelle le lecteur choisit Plusieurs boutons, une seule réponse L'emplacement réservé à une signature
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.
- requête
- Un appel au service : vous envoyez ce que le document doit dire, et vous recevez le document. Votre facture compte ces appels, un par document. Le nombre de pages d'un document n'est jamais compté.