Een toegankelijke Figure met Caption via Connect uitsturen

In het kort

Stuur een HTML-<figure> met een <img> en een <figcaption> via de Connect-transports. De pijplijn stuurt een standaard Figure-structuurelement uit, nestelt het bijschrift als Caption-kind en gebruikt het alt-attribuut om /Alt te vullen. Verifieer het resultaat met de toegankelijkheidstool op Pro-niveau. NextPDF ontdekt die tool via class_exists() en registreert deze alleen wanneer nextpdf/premium naast de server is geïnstalleerd. Core-tools verzorgen het aanmaken van documenten en het inlezen van HTML.

Een geslaagd resultaat van de toegankelijkheidstool is een toegankelijkheidscontrole, geen onafhankelijke conformiteitscertificering.

Installeren

composer require nextpdf/server

Controleer met een tools/list-aanroep of de Pro-toegankelijkheidstool aanwezig is. Zie /connect/tool-catalog/.

Conceptueel overzicht

Een alternatieve beschrijving levert tekst voor niet-tekstuele inhoud, zoals een figuur (ISO 32000-2 §14.8). Het structuurelement bewaart die beschrijving in zijn /Alt-vermelding (ISO 32000-2 §14.8). Het HTML-alt-attribuut vult /Alt in de uitgestuurde Figure. De pijplijn stuurt de <figcaption> uit als een genest Caption-kind in plaats van als een losstaande alinea, zodat het bijschrift als onderdeel van de figuur bereikbaar blijft (PDF/UA-2 §8.2.4).

API-oppervlak

Verifieer toolnamen aan de hand van het actieve register met tools/list. De gezaghebbende catalogus is /connect/tool-catalog/. Dit recipe gebruikt de core-document- en HTML-tools, plus de Pro-toegankelijkheidscontrole. Het noemt geen exact aantal tools.

Codevoorbeeld — Snelstart

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

Codevoorbeeld — Productie

Voeg de figuurmarkup toe. Het alt-attribuut is vereist om de figuur toegankelijk te maken:

{
  "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>"
    }
  }
}

Voer de toegankelijkheidscontrole uit en inspecteer vervolgens de gerapporteerde structuurboom. Deze toont één enkele Figure met /Alt en precies één Caption-kind.

Randgevallen en valkuilen

<img> zonder alt. De controle meldt een figure-alternate-text-fout. Geef een beschrijvend alt-attribuut op, of markeer een puur decoratieve afbeelding als artefact (zie /cookbook/connect/page-artifacts/).
Lege <figcaption>. De pijplijn geeft een waarschuwing. Geef bijschrifttekst op of verwijder het element.
<figcaption> buiten elke <figure>. De pijplijn stuurt het uit als een verweesd bijschrift. Plaats het in een <figure>.
Tool afwezig. Zonder nextpdf/premium wordt de Pro-toegankelijkheidstool niet geregistreerd en mislukt de verificatie met een unknown-tool-fout.

Prestaties

Het budget in de frontmatter is een documentatieplafond. De verwerking van figuren verloopt als onderdeel van de normale lay-outfase.

Beveiligingsnotities

Er gelden geen extra richtlijnen naast de algemene richtlijnen voor het Connect-transport.

Conformiteit

PDF/UA-2-toewijzing

Bewering	Clausule	reference_id
Alternatieve beschrijving voor niet-tekstuele inhoud	ISO 32000-2 §14.8
Alternatieve beschrijving bewaard in `/Alt`	ISO 32000-2 §14.8
Caption bereikbaar via de structuurboom	PDF/UA-2 §8.2.4

Tag → ISO 32000-2 §14.9-kruisverwijzing

Figure en Caption zijn standaardstructuurtypen. Het nesten van de <figcaption> als Caption bepaalt het contract voor een toegankelijke figuur.

WCAG 2.2-toewijzing

Een figuur met alt-tekst en een bijbehorend bijschrift ondersteunt Web Content Accessibility Guidelines (WCAG) 2.2 SC 1.1.1 (Non-text Content) en SC 1.3.1 (Info and Relationships) op contentniveau.

Een geslaagd resultaat van de toegankelijkheidstool is een toegankelijkheidscontrole, geen conformiteitscertificering. Die beoordeling gebeurt door een onafhankelijke checker.

Commerciële context

De toegankelijkheidscontroletool valt onder het Pro-niveau en registreert zich alleen wanneer nextpdf/premium naast de server is geïnstalleerd.

Connect-specifieke details

Beschikbaarheid van transports (MCP / REST / gRPC)

Roep create_pdf, add_html en de toegankelijkheidscontrole op dezelfde manier aan via Model Context Protocol (MCP), REST en gRPC, via de gedeelde tool-executor.

HITL-risiconiveau

Het aanmaken van documenten en het inlezen van HTML vallen onder caution-level. De toegankelijkheidscontrole is alleen-lezen. Geen daarvan is standaard approval_required. Zie /connect/hitl-risk-niveaus/.

JSON-envelop van de bevestigingspoort

Deze tools activeren de poort niet, tenzij een operator-override een ervan verhoogt naar approval_required. De envelop en het contract voor eenmalig te gebruiken tokens staan in /connect/hitl-risk-niveaus/.

Zie ook

/cookbook/connect/aria-tagged-pdf/ — toewijzing van landmark-rollen.
/cookbook/connect/aria-noteref-pattern/ — voetnootverwijzing en body-rollen.
/cookbook/connect/page-artifacts/ — decoratieve afbeeldingen als artefacten markeren.
/connect/tool-catalog/ — berekening van de toolset per niveau.