Logikai szerkezet

Logikai szerkezet

A címkézett PDF-ek tartalmaznak egy logikai struktúra fáját, amely meghatározza a dokumentum szemantikus hierarchiája bekezdés, címsor, táblázat, szám és listák. Célkitűzés.PDF A .NET-hez használt FOSS a következőket adja: TaggedContent Építés és ellenőrzés API-ja a PDF/UA hozzáférhetőségének megfelelőségéhez elengedhetetlen.


Megjelölésű tartalom elérése

using var doc = new Document();
var tagged = doc.TaggedContent;
tagged.SetTitle("Accessible Document");
tagged.SetLanguage("en-US");

A szerkezeti elemek létrehozása

ITaggedContent minden szabványos szerkezeti elemre vonatkozó gyármódszert tartalmazza. Az elemek egy faba kerülnek összeállítva, a következők segítségével: AppendChild.

var root = tagged.RootElement;

var heading = tagged.CreateHeaderElement(1);
heading.SetText("Chapter 1");
root.AppendChild(heading);

var paragraph = tagged.CreateParagraphElement();
paragraph.SetText("This is the first paragraph.");
root.AppendChild(paragraph);

Strukturált táblázatok

TableElement hozzáférhető táblázatokat hoz létre, fejedelemmel, testtel és lábjegyzővel.

var table = tagged.CreateTableElement();
root.AppendChild(table);

var thead = table.CreateTHead();
var headerRow = thead.CreateTR();
headerRow.CreateTH().SetText("Name");
headerRow.CreateTH().SetText("Value");

var tbody = table.CreateTBody();
var dataRow = tbody.CreateTR();
dataRow.CreateTD().SetText("Width");
dataRow.CreateTD().SetText("612");

Színképek és ábrák

IllustrationElement A képeket a struktúra fába csomagolja.

var figure = tagged.CreateFigureElement();
figure.SetImage("chart.png");
figure.SetAlternativeText("Sales chart for Q4");
root.AppendChild(figure);

Szerkezeti elemtípusok

Az API támogatja a PDF struktúra elemtípusok teljes sorát:

  • Blokkos szint: bekezdés, cím (H1-H6), lista, listatétel, táblázat, blokkokotáció, kód
  • Inline-számú: Hosszabb, kapcsolatos, megjegyzés, képlet, formula.
  • Részletcsoportok: Rész, cikk, szakasz, rész

Tippek és legjobb gyakorlatok

  • Mindig beállítva. Title és a következők: Language a következő napon: TaggedContent a PDF/UA megfelelés tekintetében.
  • A struktúra fáját felülről lefelé építjük: alkotunk elemeket, majd hozzátesszük a gyerekeket.
  • Használat SetAlternativeText a képernyőolvasó hozzáférhetőségének számeleinek eleméről.
  • A táblázatokat a következőkkel kell címkézni: THead, TBody, TFoot a megfelelő táblázat semantika.
  • A PDF/UA megfelelésének hitelesítése a következőkkel: PdfFormatConversionOptions (lásd a konverziós útmutatót).

Általános kérdések

A kérdésOkokMegjavítani.
PDF/UA hitelesítés nem sikerültA szerkezetfa hiányzó szükséges elemekBiztosítsuk, hogy minden tartalom megfelelő szerkezeti elemeket tartalmazjon.
A cím sorrend rossz.A H2 a H1 előtt jelenik meg.Követni a sorrendben lévő címsor hierarchiáját.
A kép nem tartalmaz alternatív szöveget.SetAlternativeText nem hívott fel.Az ábrákhoz mindig alternatív szöveget kell adni.
A táblázat nem ismert a képernyőolvasó általHiányzó THead/TBody szerkezetHasználja a teljes táblázat-szerkezet API-t

FAQ

Mi az a címkézett PDF?

A címkézett PDF tartalmaz egy logikai struktúra fáját, amely a vizuális tartalmat szemantikus elemekre (címek, bekezdések és táblázatok) mutatja be, lehetővé téve az hozzáférhetőségeszközök és a tartalom visszaáramlását.

A PDF azonos a PDF/UA címkével?

A PDF/UA egy olyan szabvány, amely a címkézést és további hozzáférhetőségszabályokat írja elő. A címkésített PDF-ek az PDF / UA megfelelésének előfeltételei.

Megjegyezhetem egy PDF-t?

A Bizottság TaggedContent Az API a legjobban működik az új dokumentumokkal. a meglévő PDF-ek, ellenőrizze a struktúra fa keresztül Document.TaggedContent.


API-referencia összefoglaló

Rendszer / módszerLeírás
TaggedContentA logikai struktúra műveleteinek belépési pontja
TaggedContent.SetTitleA dokumentum címét a hozzáférhetőségre állítsa be
TaggedContent.SetLanguageA dokumentum nyelve beállításához:
ITaggedContentA gyártói módszerekkel való kapcsolat minden elemtípusra vonatkozóan
StructureElementAz összes szerkezeti elem alaposztálya
StructureElement.AppendChildEgy gyermek elem hozzáadása a fához.
StructureElement.SetTextAz elem szövegtartalmának beállítását .
TableElementA hozzáférhető táblázat szerkezetének eleme
TableElement.CreateTHeadA táblázat fejléseinek létrehozása .
TableElement.CreateTBodyA táblázat test részének létrehozása
TableTRElementTáblázat soreleme
TableTRElement.CreateTDAdatcellát hozzáadni
TableTRElement.CreateTHCélcím hozzáadása
IllustrationElementSzámkép/színtörténet szerkezeti eleme
IllustrationElement.SetImageCsatlakozzon a képhez.

Lásd még:

 Magyar