Une zone de la page sur laquelle on clique

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 zone sur laquelle on clique dans un document affiché à l'écran. Elle est invisible : elle se pose par-dessus ce qui est déjà dessiné, en général sur un texte que vous avez mis en bleu pour qu'on voie qu'il est cliquable. Vous choisissez ce qui arrive au clic : ouvrir une adresse de site, ou sauter à une autre page du même document, comme dans un sommaire. Sur papier, la feuille reste telle quelle ; à l'écran, elle transforme votre document en quelque chose qui se parcourt.

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 lien est un rectangle d'annotation posé au-dessus des articles déjà dessinés : il se contente des pages que ces articles ont créées, si bien qu'un lien nommé au-delà de la dernière page reste simplement de côté. Sa destination s'écrit de deux façons : la forme courte, qui dit une adresse ou un numéro de page, ou l'action complète, qui dit en plus la vue à laquelle la page s'ouvre, un repère nommé, une partie du document, un déplacement de lecture, ou l'envoi et la remise à zéro d'un formulaire. Chaque lien dit l'une ou l'autre, ce qui garde une seule lecture possible.

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é obligatoire : rect. Exactement une clé de destination : to, valant {"uri": "address"} ou {"page": n} avec n ≥ 1 ; ou action, valant {"uri": …} (une chaîne, ou un objet à uri obligatoire et track_pointer, défaut false), {"page": …} (un entier ≥ 1, ou un objet à page obligatoire et fit, défaut "whole_page"), {"destination": "name"}, {"part": n} avec n ≥ 1, {"menu_item": …} valant next_page, previous_page, first_page ou last_page, {"reset_fields": {"fields": …}}, {"submit_fields": {…}} avec url obligatoire, fields facultatif et format (défaut {"fdf": {"with_no_value": false}}, aussi {"html": {"get": …, "with_click": …}}, "xfdf" et {"whole_document": {"get": …}}), ou {"import_fields": {"file": "name"}}. Un jeu de champs se dit {"only": …} ou {"all_but": …} ; absent, il désigne tout le formulaire. Facultatif : pages, tableau d'entiers en base 1, défaut vide. Refus croisés : to et action ensemble ; ni l'un ni l'autre ; une page hors du document.

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",
      "rect": {"llx": 72, "lly": 740, "urx": 300, "ury": 760},
      "content": ["Visit hqf-pdf.com"],
      "font": "sans",
      "font_size": 14,
      "color": [0.11, 0.31, 0.55]
    },
    {
      "type": "link",
      "rect": {"llx": 72, "lly": 740, "urx": 300, "ury": 760},
      "to": {"uri": "https://hqf-pdf.com/"}
    }
  ]
}

La ligne qui l'envoie, en trois langages

Glossaire

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