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:Languagea következő napon:TaggedContenta 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
SetAlternativeTexta 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,TFoota 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és | Okok | Megjavítani. |
|---|---|---|
| PDF/UA hitelesítés nem sikerült | A szerkezetfa hiányzó szükséges elemek | Biztosí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ó által | Hiányzó THead/TBody szerkezet | Haszná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ódszer | Leírás |
|---|---|
TaggedContent | A logikai struktúra műveleteinek belépési pontja |
TaggedContent.SetTitle | A dokumentum címét a hozzáférhetőségre állítsa be |
TaggedContent.SetLanguage | A dokumentum nyelve beállításához: |
ITaggedContent | A gyártói módszerekkel való kapcsolat minden elemtípusra vonatkozóan |
StructureElement | Az összes szerkezeti elem alaposztálya |
StructureElement.AppendChild | Egy gyermek elem hozzáadása a fához. |
StructureElement.SetText | Az elem szövegtartalmának beállítását . |
TableElement | A hozzáférhető táblázat szerkezetének eleme |
TableElement.CreateTHead | A táblázat fejléseinek létrehozása . |
TableElement.CreateTBody | A táblázat test részének létrehozása |
TableTRElement | Táblázat soreleme |
TableTRElement.CreateTD | Adatcellát hozzáadni |
TableTRElement.CreateTH | Célcím hozzáadása |
IllustrationElement | Számkép/színtörténet szerkezeti eleme |
IllustrationElement.SetImage | Csatlakozzon a képhez. |