Connect üzerinden Caption içeren erişilebilir bir Figure öğesi yayımlama

Connect üzerinden Caption içeren erişilebilir bir Figure öğesi yayımlama

Genel bakış

HTML <figure> öğesini — içinde bir <img> ve bir <figcaption> ile — Connect taşıyıcıları üzerinden gönderin. İşlem hattı standart bir Figure yapı öğesi yayımlar, başlığı bir Caption alt öğesi olarak iç içe yerleştirir ve alt özniteliğini kullanarak /Alt değerini doldurur. Sonucu Pro katmanı erişilebilirlik aracıyla doğrulayın. NextPDF bu aracı class_exists() aracılığıyla keşfeder ve yalnızca sunucuyla birlikte nextpdf/premium kurulu olduğunda kaydeder. Belge oluşturma ve HTML alımı Core araçları tarafından gerçekleştirilir.

Erişilebilirlik aracından alınan başarılı sonuç yalnızca bir erişilebilirlik denetimidir, bağımsız bir uygunluk belgelendirmesi değildir.

Kurulum

composer require nextpdf/server

Pro erişilebilirlik aracının kullanılabilir olduğunu bir tools/list çağrısıyla doğrulayın. Bkz. /connect/tool-catalog/.

Kavramsal genel bakış

Alternatif açıklama, şekil gibi metin olmayan içerik için metin sağlar (ISO 32000-2 §14.8). Yapı öğesi bu açıklamayı kendi /Alt girdisinde saklar (ISO 32000-2 §14.8). HTML alt özniteliği, /Alt değerini, yayımlanan Figure öğesinde doldurur. İşlem hattı, <figcaption> öğesini kardeş bir paragraf olarak değil, iç içe yerleştirilmiş bir Caption alt öğesi olarak yayımlar; böylece başlık, şeklin bir parçası olarak erişilebilir kalır (PDF/UA-2 §8.2.4).

API yüzeyi

Araç adlarını çalışan kayıt defterine göre tools/list ile doğrulayın. Güncel katalog kaynağı /connect/tool-catalog/. Bu tarif, Core belge ve HTML araçlarının yanı sıra Pro erişilebilirlik denetimini kullanır. Araç sayısını burada yinelemez.

Kod örneği — hızlı başlangıç

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

Kod örneği — üretim

Şekil işaretlemesini ekleyin. Şeklin erişilebilir olması için alt gereklidir:

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

Erişilebilirlik denetimini çalıştırın, ardından raporlanan yapı ağacını inceleyin. Tek bir Figure öğesi gösterir; bu öğenin /Alt değeri ve tam olarak bir Caption alt öğesi vardır.

Sınır durumları ve dikkat edilecek noktalar

• Hiç alt içermeyen <img>. Denetim, şekil için alternatif metin hatası bildirir. Açıklayıcı bir alt sağlayın veya salt dekoratif bir görseli yapıt olarak işaretleyin (bkz. /cookbook/connect/page-artifacts/).
• Boş <figcaption>. İşlem hattı uyarı üretir. Başlık metni sağlayın veya öğeyi kaldırın.
• Herhangi bir <figure> öğesinin dışındaki <figcaption>. İşlem hattı bunu sahipsiz bir başlık olarak yayımlar. Bunu bir <figure> öğesinin içine sarın.
• Araç mevcut değil. nextpdf/premium olmadan Pro erişilebilirlik aracı kaydedilmez ve doğrulama, bilinmeyen araç hatasıyla başarısız olur.

Performans

Öngörülen bütçe, belgelendirme için üst sınırdır. Şekil işleme, normal yerleşim geçişinin bir parçası olarak çalışır.

Güvenlik notları

Genel Connect taşıyıcı yönergeleri dışında ek bir yönerge geçerli değildir.

Uygunluk

PDF/UA-2 eşlemesi

Beyan	Madde	reference_id
Metin olmayan içerik için alternatif açıklama	ISO 32000-2 §14.8
Alternatif açıklamayı tutan /Alt	ISO 32000-2 §14.8
Yapı ağacı üzerinden erişilebilen Caption	PDF/UA-2 §8.2.4

Etiket → ISO 32000-2 §14.9 çapraz başvurusu

Figure ve Caption standart yapı türleridir. <figcaption> öğesinin Caption olarak iç içe yerleştirilmesi, erişilebilir şekil sözleşmesini tanımlar.

WCAG 2.2 eşlemesi

Alternatif metni ve ilişkili bir başlığı olan bir şekil, içerik düzeyinde Web Content Accessibility Guidelines (WCAG) 2.2 SC 1.1.1 (Non-text Content) ve SC 1.3.1 (Info and Relationships) ölçütlerini destekler.

Erişilebilirlik aracından alınan başarılı sonuç yalnızca bir erişilebilirlik denetimidir, bir uygunluk belgelendirmesi değildir. Bu tespiti bağımsız bir denetleyici yapar.

Ticari bağlam

Erişilebilirlik denetimi aracı Pro katmanındadır ve yalnızca sunucuyla birlikte nextpdf/premium kurulu olduğunda kaydedilir.

Connect ayrıntıları

Taşıyıcı kullanılabilirliği (MCP / REST / gRPC)

Aynı şekilde create_pdf, add_html ve erişilebilirlik denetimini, paylaşılan araç yürütücüsü aracılığıyla Model Context Protocol (MCP), REST ve gRPC üzerinden çağırın.

HITL risk katmanı

Belge oluşturma ve HTML alımı dikkat düzeyine girer. Erişilebilirlik denetimi salt okunurdur. Bunların hiçbiri varsayılan olarak approval_required değildir. Bkz. /connect/hitl-risk-tiers/.

Onay geçidi JSON zarfı

Bir operatör geçersiz kılma işlemi bunlardan birini approval_required düzeyine yükseltmediği sürece bu araçlar geçidi tetiklemez. Zarf ve tek kullanımlık belirteç sözleşmesi şurada yer alır: /connect/hitl-risk-tiers/.

Ayrıca bkz.

• /cookbook/connect/aria-tagged-pdf/ — yer imi rolü eşlemesi.
• /cookbook/connect/aria-noteref-pattern/ — dipnot başvurusu ve gövde rolleri.
• /cookbook/connect/page-artifacts/ — dekoratif görselleri yapıt olarak işaretleme.
• /connect/tool-catalog/ — katman başına araç kümesi hesaplaması.