Emitowanie dostępnego elementu Figure z elementem Caption przez Connect

W skrócie

Prześlij element HTML <figure> z elementami <img> i <figcaption> przez transporty Connect. Potok emituje standardowy element struktury Figure, zagnieżdża podpis jako element podrzędny Caption i wykorzystuje atrybut alt do wypełnienia wpisu /Alt. Zweryfikuj wynik narzędziem dostępności w wersji Pro. NextPDF wykrywa to narzędzie za pomocą class_exists() i rejestruje je tylko wtedy, gdy nextpdf/premium jest zainstalowany razem z serwerem. Narzędzia Core obsługują tworzenie dokumentu i wczytywanie HTML.

Pozytywny wynik narzędzia dostępności oznacza kontrolę dostępności, a nie niezależną certyfikację zgodności.

Instalacja

composer require nextpdf/server

Upewnij się, że narzędzie dostępności w wersji Pro jest dostępne, wywołując tools/list. Zobacz /connect/tool-catalog/.

Przegląd koncepcyjny

Opis alternatywny zapewnia tekst dla treści nietekstowej, takiej jak figura (ISO 32000-2 §14.8). Element struktury przechowuje ten opis we wpisie /Alt (ISO 32000-2 §14.8). Atrybut HTML alt wypełnia /Alt w wyemitowanym elemencie Figure. Potok emituje <figcaption> jako zagnieżdżony element podrzędny Caption, a nie jako równorzędny akapit, dzięki czemu podpis pozostaje osiągalny jako część figury (PDF/UA-2 §8.2.4).

Powierzchnia API

Sprawdź nazwy narzędzi w działającym rejestrze za pomocą tools/list. Wiążącym katalogiem jest /connect/tool-catalog/. Ten przepis korzysta z podstawowych narzędzi dokumentowych i HTML oraz z kontroli dostępności w wersji Pro. Nie powiela liczby narzędzi.

Przykład kodu — szybki start

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

Przykład kodu — środowisko produkcyjne

Dodaj znaczniki figury. Atrybut alt jest wymagany, aby figura była dostępna:

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

Uruchom kontrolę dostępności, a następnie sprawdź drzewo struktury zwrócone w raporcie. Pokazuje ono pojedynczy element Figure z /Alt oraz dokładnie jednym elementem podrzędnym Caption.

Przypadki brzegowe i pułapki

<img> bez atrybutu alt. Kontrola zgłasza błąd braku tekstu alternatywnego figury. Podaj opisowy atrybut alt albo oznacz obraz wyłącznie dekoracyjny jako artefakt (zobacz /cookbook/connect/page-artifacts/).
Pusty element <figcaption>. Potok zgłasza ostrzeżenie. Podaj tekst podpisu albo usuń element.
<figcaption> poza jakimkolwiek <figure>. Potok emituje go jako osierocony podpis. Umieść go w <figure>.
Brak narzędzia. Bez nextpdf/premium narzędzie dostępności w wersji Pro nie jest zarejestrowane, a weryfikacja kończy się błędem nieznanego narzędzia.

Wydajność

Budżet określony we front matter jest limitem dokumentacyjnym. Obsługa figur odbywa się w ramach normalnego przebiegu układu.

Uwagi dotyczące bezpieczeństwa

Poza ogólnymi wskazówkami dotyczącymi transportu Connect nie obowiązują żadne dodatkowe wytyczne.

Zgodność

Mapowanie PDF/UA-2

Deklaracja	Klauzula	reference_id
Opis alternatywny dla treści nietekstowej	ISO 32000-2 §14.8
Opis alternatywny przechowywany w `/Alt`	ISO 32000-2 §14.8
Podpis osiągalny w drzewie struktury	PDF/UA-2 §8.2.4

Odwołanie znacznika → ISO 32000-2 §14.9

Figure i Caption to standardowe typy struktury. Zagnieżdżenie <figcaption> jako Caption określa kontrakt dostępnej figury.

Mapowanie WCAG 2.2

Figura z tekstem alternatywnym i powiązanym podpisem na poziomie treści wspiera kryteria sukcesu Web Content Accessibility Guidelines (WCAG) 2.2 SC 1.1.1 (Non-text Content) oraz SC 1.3.1 (Info and Relationships).

Pozytywny wynik narzędzia dostępności to kontrola dostępności, a nie certyfikacja zgodności. Takiego rozstrzygnięcia dokonuje niezależny weryfikator.

Kontekst komercyjny

Narzędzie kontroli dostępności jest częścią wersji Pro i rejestruje się tylko wtedy, gdy nextpdf/premium jest zainstalowany razem z serwerem.

Szczegóły dotyczące Connect

Dostępność transportu (MCP / REST / gRPC)

Wywołaj create_pdf, add_html oraz kontrolę dostępności w ten sam sposób przez Model Context Protocol (MCP), REST i gRPC za pośrednictwem współdzielonego wykonawcy narzędzi.

Poziom ryzyka HITL

Tworzenie dokumentu i wczytywanie HTML należą do poziomu ostrożności. Kontrola dostępności działa tylko do odczytu. Żadne z nich nie ma domyślnie ustawienia approval_required. Zobacz /connect/hitl-risk-tiers/.

Koperta JSON bramki potwierdzenia

Te narzędzia nie uruchamiają bramki, chyba że nadpisanie przez operatora podniesie któreś z nich do approval_required. Koperta i kontrakt tokena jednorazowego znajdują się w /connect/hitl-risk-tiers/.

Zobacz także

/cookbook/connect/aria-tagged-pdf/ — mapowanie ról punktów orientacyjnych.
/cookbook/connect/aria-noteref-pattern/ — odwołanie do przypisu i role treści.
/cookbook/connect/page-artifacts/ — oznaczanie obrazów dekoracyjnych jako artefaktów.
/connect/tool-catalog/ — obliczanie zestawu narzędzi dla danej wersji.