Une case dans laquelle le lecteur écrit

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 case vide d'un formulaire, celle dans laquelle le lecteur tape sa réponse directement à l'écran, sans imprimer. Vous choisissez où elle se trouve, quelle écriture elle utilise, et si le texte se range à gauche, au milieu ou à droite. Elle peut tenir sur une ligne ou sur plusieurs, comme un cadre à commentaires. Elle peut aussi masquer ce qu'on tape, à la manière d'un mot de passe, ou découper la case en petits carrés, un par caractère, comme sur les formulaires administratifs.

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 champ de saisie est une annotation posée par-dessus ce que les autres articles ont dessiné : il se contente des pages déjà là, et un champ vide laisse voir la page telle quelle, l'encadrement lui donnant sa silhouette. La valeur de départ et la valeur de remise à zéro se disent séparément, si bien qu'un formulaire peut démarrer rempli et se vider à la remise à zéro. Le mode case par case suppose une longueur maximale, puisque c'est elle qui découpe la boîte. Le nom du champ est ce qu'un formulaire rempli rapporte, et il sert aussi de cible aux actions d'envoi et de remise à zéro.

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 champ : value, valeur de départ ; default_value, valeur que la remise à zéro rétablit ; multiline, password et comb, booléens à false ; max_length, entier ; align, valant left (défaut), center ou right. Facultatives communes à tous les champs : read_only, required, no_export, booléens à false ; background, couleur du fond du champ ; border, objet à width obligatoire, color (défaut noir, exprimée en lumière : gris ou RVB) et style valant "solid" (défaut), {"dashed": {"lengths": …}}, "beveled", "inset" ou "underline" ; pages, tableau d'entiers en base 1, défaut vide ; relative_to, objet à id, edge, offset et part facultatif. Refus croisés : comb sans max_length ; 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": "text_field",
      "name": "customer",
      "rect": {"llx": 72, "lly": 700, "urx": 300, "ury": 718},
      "font": "sans",
      "font_size": 11,
      "border": {"width": 0.75}
    }
  ]
}

La ligne qui l'envoie, en trois langages

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.

RVB

Les trois lumières qu'un écran mélange pour faire une couleur : le rouge, le vert et le bleu. Les trois à fond donnent du blanc, les trois éteintes du noir. C'est la façon de dire une couleur pour tout ce qui est éclairé par derrière, et la mauvaise façon de la dire pour une presse, qui pose de l'encre sur du papier blanc.

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.

Tous les mots que le site explique