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.
Résumé
C'est le bouton sur lequel on appuie dans un document affiché à l'écran : « Envoyer », « Effacer », « Page suivante ». 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.
Techniquement
Demandé avec
"type": "push_button"
Un bouton est un champ /FT /Btn avec le bit bouton-poussoir posé, le seul champ qui n'a aucune valeur : appuyer agit, et ce qu'il fait est l'action que la requête lui accroche. /MK contient les trois libellés, qui correspondent aux trois états — /CA au repos, /RC sous le pointeur, /AC 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 dictionnaire d'ajustement /IF, 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.
Schéma de la requête
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 dix 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) ; 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 le bouton ; flags, les indicateurs décrits sur la page du champ de texte, leur absence imprimant le bouton 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é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 crée un PDF
{
"standard_fonts": [{"name": "sans", "face": "helvetica"}],
"drawings": [
{
"name": "arrow",
"box": {"llx": 0, "lly": 0, "urx": 16, "ury": 16},
"items": [
{
"type": "line",
"from": {"x": 2, "y": 8},
"to": {"x": 14, "y": 8},
"stroke": {"width": 2, "color": [0.11, 0.31, 0.55]}
},
{
"type": "line",
"from": {"x": 9, "y": 3},
"to": {"x": 14, "y": 8},
"stroke": {"width": 2, "color": [0.11, 0.31, 0.55]}
}
]
}
],
"items": [
{
"type": "text_field",
"name": "order",
"rect": {"llx": 72, "lly": 740, "urx": 300, "ury": 762},
"font": "sans",
"font_size": 11
},
{
"type": "text_field",
"name": "notes",
"rect": {"llx": 72, "lly": 764, "urx": 300, "ury": 786},
"font": "sans",
"font_size": 11
},
{
"type": "push_button",
"name": "reset",
"rect": {"llx": 72, "lly": 700, "urx": 172, "ury": 722},
"font": "sans",
"font_size": 11,
"caption": "Clear the notes",
"border": {"width": 0.75},
"action": {"reset_fields": {"fields": {"only": ["notes"]}}}
},
{
"type": "push_button",
"name": "send",
"rect": {"llx": 184, "lly": 700, "urx": 300, "ury": 722},
"font": "sans",
"font_size": 11,
"caption": "Send the order",
"layout": "caption_left_of_icon",
"icon": "arrow",
"icon_fit": {
"scale": "when_bigger",
"stretch": "proportional",
"leftover_left": 0.5,
"leftover_bottom": 0.5
},
"border": {"width": 0.75},
"action": {
"submit_fields": {
"url": "https://hqf-pdf.com/orders/",
"fields": {"all_but": ["notes"]},
"format": {"html": {"get": false, "with_click": true}}
}
}
}
]
}Champs de formulaire
Un champ que le lecteur remplit 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
Toutes les clés JSON d'une requête, en une page Les vingt-deux autres choses que l'on peut dessiner