Une liste dans laquelle le lecteur choisit

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 liste de réponses toutes prêtes : le pays, la taille d'un vêtement, le motif d'une demande. Le lecteur choisit dans ce que vous proposez, ce qui évite les fautes de frappe et les réponses fantaisistes. Vous montrez la liste entière, ou un menu qui s'ouvre au clic, ou encore un menu dans lequel le lecteur peut taper une réponse à lui si la sienne n'y est pas. Ce que le lecteur lit et ce que le formulaire retient peuvent être deux choses différentes : il voit « France », le formulaire garde « FR ».

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.

Chaque option s'écrit d'une chaîne unique, valeur et libellé confondus, ou d'une paire qui sépare la valeur rapportée du libellé affiché. La présentation choisit entre la liste que l'on fait défiler, le menu déroulant et le menu ouvert à la saisie. La sélection de départ et celle que rétablit une remise à zéro se disent par la valeur rapportée, et se disent séparément. Le choix multiple laisse le lecteur retenir plusieurs options à la fois. L'indicateur d'ordre alphabétique déclare que la liste est triée, tandis que le lecteur affiche les options dans l'ordre où la requête les donne : le tri appartient donc à la requête.

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 ; options, tableau dont chaque entrée est une chaîne nue, ou un objet à value et label tous deux obligatoires. Facultatives propres au champ : selected, valeur rapportée de l'option retenue au départ ; default_selected, valeur rapportée de l'option que rétablit une remise à zéro ; presentation, valant list (défaut), dropdown ou editable ; multi_select et sorted, booléens à false ; align, valant left (défaut), center ou right. 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é.

{
  "standard_fonts": [{"name": "sans", "face": "helvetica"}],
  "items": [
    {
      "type": "choice_field",
      "name": "country",
      "rect": {"llx": 72, "lly": 700, "urx": 260, "ury": 718},
      "font": "sans",
      "font_size": 11,
      "options": [
        {"value": "FR", "label": "France"},
        {"value": "GB", "label": "United Kingdom"}
      ],
      "presentation": "dropdown",
      "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.

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é.

Tous les mots que le site explique