Tout ce qu’on peut dessiner sur une page

La seule clé obligatoire : la liste de ce qui est dessiné, dans l’ordre du tracé. Vingt-cinq sortes en tout.

Le résultat dans un vrai PDF

Des listes faites d’un retrait et d’un taquet

Des listes à puces, numérotées et imbriquées, bâties chacune sur un retrait négatif et un taquet de tabulation plutôt que sur un objet de liste dédié : la marque se place dans l’espace que le retrait ouvre, et chaque ligne après la première commence là où la tabulation a posé le texte.

Ouvrir le PDF Voir l’exemple complet

Également dans les exemples : Un tableau de facture sur plusieurs pages · Des cellules fusionnées sur la hauteur · Des images dans les cellules d’un tableau

Résumé

Tout le reste règle le document ; celle-ci le remplit. Du texte, un tableau, une photo, un code-barres, un trait, une case à cocher : chaque chose dit ce qu’elle est et où elle se met. La dernière écrite passe par-dessus les précédentes, comme des feuilles empilées sur un bureau, et c’est ainsi qu’un tampon se retrouve au-dessus de la page qu’il traverse.

Techniquement

Écrit au premier niveau d’une requête, sous "items"

items est un tableau, dans l’ordre de dessin, dont chaque entrée a une clé type qui indique auquel des vingt-cinq types elle appartient ; cet ordre est l’ordre de superposition : un élément placé plus loin recouvre ceux qui le précèdent. La plupart des types partagent un socle commun de réglages : le rectangle qu’ils occupent, les pages où ils apparaissent, le calque auquel ils appartiennent, une rotation ou une transformation. Chaque type a sa propre page de détail.

Schéma de la requête

  • items — tableau, facultatif, vide par défaut. Une requête qui n’en contient pas ne dessine rien par elle-même : des pages blanches, ou les pages sur lesquelles s’ouvre sa source.
  • Chaque entrée est un objet muni d’une clé type, ou un tableau dont le premier élément est l’étiquette. Un objet sans type est refusé ; un objet qui contient deux clés type aussi.
  • Vingt-cinq valeurs de type, chacune avec sa page, listées plus bas.
  • Réglages que la plupart des sortes ont en commun : pages, soit un tableau d’entiers comptés à partir de 1, vide par défaut et valant alors toutes les pages, soit une règle : every, valant page (par défaut), odd_page ou even_page ; from et to, numéros de page comptés à partir de 1, bornes comprises ; absents, ils partent de la première page et vont jusqu’à la dernière ; but, un tableau des pages laissées de côté, chacune un nombre ou une expression, si bien que "{page_of_headline}" laisse de côté la page où un élément s’est ouvert. layer (le nom d’un calque déclaré), id et relative_to (pose par rapport à un autre élément), transform (six nombres) ou rotate (degrés) — les deux ensemble sont refusés.

Les vingt-cinq choses qu’un élément peut être

Chacune a sa page : ce qu’elle est, ce qu’elle fait techniquement, le schéma de la requête qu’elle prend, et une requête entière qui la montre.

Texte

Les tableaux

Images et pages importées

Les codes-barres et les codes carrés

Formes

Champs de formulaire

  • Un champ que le lecteur remplit text_field Ajouter un champ à remplir : un nom, une adresse, un commentaire sur plusieurs lignes, un mot de passe caché, ou un numéro à raison d’une case par chiffre.
  • Une case que le lecteur coche check_box Ajouter une case à cocher : accepter des conditions, choisir une option, avec la marque de votre choix et la valeur que le formulaire renvoie.
  • Une liste dans laquelle le lecteur choisit choice_field Proposez une liste de réponses : une liste toujours visible, un menu déroulant, ou un menu dans lequel le lecteur peut aussi taper sa propre réponse.
  • Plusieurs boutons, une seule réponse radio_group Mettre des boutons dont un seul reste choisi à la fois, chacun à sa place sur la page, tous rattachés à la même question.
  • L’emplacement réservé à une signature signature_field Réserver sur la page l’endroit où une signature électronique viendra se poser, avec son nom et son encadrement.
  • Un bouton sur lequel le lecteur appuie push_button Mettre un bouton qui agit au lieu de répondre : ouvrir une adresse, aller à une page, envoyer le formulaire ou le remettre à zéro.

Navigation

Une requête entière qui crée un PDF

{
  "standard_fonts": [{ "name": "sans", "face": "helvetica" }],
  "items": [
    {
      "type": "rect",
      "rect": { "llx": 60, "lly": 700, "urx": 535, "ury": 780 },
      "fill": [0.93, 0.95, 0.98]
    },
    {
      "type": "text",
      "id": "headline",
      "rect": { "llx": 72, "lly": 730, "urx": 523, "ury": 760 },
      "content": ["Drawn second, so it sits on top"],
      "font": "sans",
      "font_size": 16
    },
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 690, "urx": 523, "ury": 712 },
      "relative_to": { "id": "headline", "edge": "bottom", "offset": -18 },
      "content": ["Placed under the line above, wherever that one landed"],
      "font": "sans",
      "font_size": 11
    },
    {
      "type": "text",
      "rect": { "llx": 72, "lly": 60, "urx": 523, "ury": 76 },
      "pages": { "every": "even_page", "from": 3, "but": [7] },
      "content": ["On the even pages from page three, page seven excepted"],
      "font": "sans",
      "font_size": 9
    }
  ]
}

La ligne qui l’envoie, en trois langages

Ce qui est dessiné, et ce que cela donne

Le poids du fichier et le temps de calcul La première page, montrée pendant que le reste arrive Les calques que le logiciel de lecture montre ou cache Un nom qui vaut pour plusieurs calques à la fois Un dessin fait une fois, montré par un bouton Dessins lus dans des fichiers SVG Les jeux de calques que le logiciel de lecture propose Les calques dont le logiciel ne montre qu’un à la fois

Où aller ensuite

Toutes les clés JSON d’une requête, en une page Les quarante et un autres réglages d’une requête

Voir les prix Voir les exemples