Émettre une figure accessible avec une légende via Connect

En bref

Envoie une <figure> HTML contenant une <img> et une <figcaption> via les transports Connect. Le pipeline émet un élément de structure standard Figure, imbrique la légende comme enfant Caption et utilise l’attribut alt pour renseigner /Alt. L’étape de vérification s’appuie sur l’outil d’accessibilité de l’offre Pro. NextPDF détecte cet outil via class_exists() et ne l’enregistre que lorsque nextpdf/premium est installé aux côtés du serveur. La création du document et l’ingestion HTML s’appuient sur les outils du cœur.

Un résultat positif de l’outil d’accessibilité correspond à un contrôle d’accessibilité, pas à une certification de conformité indépendante.

Installation

composer require nextpdf/server

Vérifie la présence de l’outil d’accessibilité Pro avec un appel tools/list. Voir /connect/tool-catalog/.

Vue d’ensemble conceptuelle

Une description de remplacement fournit du texte pour un contenu non textuel tel qu’une figure (ISO 32000-2 §14.8). L’élément de structure conserve cette description dans son entrée /Alt (ISO 32000-2 §14.8). L’attribut HTML alt renseigne /Alt sur la Figure émise. Le pipeline émet la <figcaption> comme enfant Caption imbriqué plutôt que comme paragraphe frère, afin que la légende reste accessible en tant que partie de la figure (PDF/UA-2 §8.2.4).

Surface d’API

Vérifie les noms d’outils dans le registre en cours d’exécution avec tools/list. Le catalogue de référence est /connect/tool-catalog/. Cette recette utilise les outils de document et HTML du cœur ainsi que le contrôle d’accessibilité Pro. Elle ne reprend pas le nombre d’outils.

Exemple de code — Démarrage rapide

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "create_pdf",
    "arguments": { "page_size": "A4", "title": "Architecture Reference", "language": "en" }
  }
}

Exemple de code — Production

Ajoute le balisage de la figure. L’attribut alt est obligatoire pour que la figure soit accessible :

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "add_html",
    "arguments": {
      "document_id": "<id from create_pdf>",
      "html": "<figure><img src=\"diagrams/architecture.png\" alt=\"Three-tier deployment: web frontend, REST API, datastore\" /><figcaption>Figure 1 — Deployment topology.</figcaption></figure>"
    }
  }
}

Exécute le contrôle d’accessibilité et inspecte l’arbre de structure rapporté. Il affiche une seule Figure dotée de /Alt, avec exactement un enfant Caption.

Cas limites et pièges

<img> sans alt. Le contrôle signale un échec figure-alternate-text. Fournis un alt descriptif, ou marque une image purement décorative comme artefact (voir /cookbook/connect/page-artifacts/).
<figcaption> vide. Le pipeline émet un avertissement. Fournis un texte de légende ou supprime l’élément.
<figcaption> en dehors de toute <figure>. Le pipeline l’émet comme légende orpheline. Encapsule-la dans une <figure>.
Outil absent. Sans nextpdf/premium, l’outil d’accessibilité Pro n’est pas enregistré, et la vérification échoue avec une erreur d’outil inconnu.

Performance

Le budget du front-matter est un plafond indiqué à titre documentaire. Le traitement des figures s’exécute dans le cadre de la passe de mise en page normale.

Notes de sécurité

Sans objet au-delà des recommandations générales sur le transport Connect.

Conformité

Correspondance PDF/UA-2

Affirmation	Clause	reference_id
Description de remplacement pour un contenu non textuel	ISO 32000-2 §14.8
Description de remplacement conservée dans `/Alt`	ISO 32000-2 §14.8
Légende accessible via l’arbre de structure	PDF/UA-2 §8.2.4

Correspondance balise → ISO 32000-2 §14.9

Figure et Caption sont des types de structure standard. Imbriquer la <figcaption> en tant que Caption est le contrat attendu pour une figure accessible.

Correspondance WCAG 2.2

Une figure dotée d’un texte alt et d’une légende associée prend en charge les critères WCAG 2.2 SC 1.1.1 (Non-text Content) et SC 1.3.1 (Info and Relationships) au niveau du contenu.

Un résultat positif de l’outil d’accessibilité correspond à un contrôle d’accessibilité, pas à une certification de conformité. Cette détermination relève d’un vérificateur indépendant.

Contexte commercial

L’outil de contrôle d’accessibilité relève de l’offre Pro et n’est enregistré que lorsque nextpdf/premium est installé aux côtés du serveur.

Spécificités de Connect

Disponibilité des transports (MCP / REST / gRPC)

Tu invoques create_pdf, add_html et le contrôle d’accessibilité de façon identique via MCP, REST et gRPC au moyen de l’exécuteur d’outils partagé.

Niveau de risque HITL

La création du document et l’ingestion HTML sont de niveau prudence. Le contrôle d’accessibilité est en lecture seule. Aucun d’eux n’est approval_required par défaut. Voir /connect/hitl-risk-tiers/.

Enveloppe JSON de la barrière de confirmation

Ces outils ne déclenchent pas la barrière, sauf si un forçage de l’opérateur élève l’un d’eux au niveau approval_required. L’enveloppe et le contrat de jeton à usage unique se trouvent dans /connect/hitl-risk-tiers/.

Voir aussi

/cookbook/connect/aria-tagged-pdf/ — correspondance des rôles de repère.
/cookbook/connect/aria-noteref-pattern/ — rôles de référence de note de bas de page et de corps.
/cookbook/connect/page-artifacts/ — marquer les images décoratives comme artefacts.
/connect/tool-catalog/ — calcul de l’ensemble d’outils par offre.