Λογική δομή

Λογική δομή

Τα Tagged PDFs περιλαμβάνουν ένα λογικό δομικό δέντρο που καθορίζει το έγγραφο του Σεμάντικη ιεραρχία — παραγράφους, τίτλους, πίνακες, αριθμούς και λίστες. Το FOSS για το .NET παρέχει την TaggedContent API για την κατασκευή και επιθεώρηση Αυτή η δομή, η οποία είναι απαραίτητη για την συμμόρφωση με τη διαθεσιμότητα PDF/UA.


Ετικέτες πρόσβαση περιεχόμενο

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

Δημιουργία δομικών στοιχείων

ITaggedContent παρέχει εργοστασιακές μεθόδους για κάθε τυποποιημένο στοιχείο δομής Τα στοιχεία συσσωρεύονται σε ένα δέντρο με την κλήση 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);

Σχεδιασμένα τραπέζια

TableElement δημιουργεί προσβάσιμες τραπέζες με κεφάλι, σώμα και τμήματα ποδιών.

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");

Εικόνες και αριθμοί

IllustrationElement Βάζουμε εικόνες στο δέντρο.

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

Τύποι δομών στοιχείων

Το API υποστηρίζει το πλήρες σύνολο των τύπων στοιχείων δομής PDF:

  • Μικρο-Επίπεδο: Παράγραφος, Κεφάλαιο (H1-H6), Λίστα, ListItem, Τίτλος, BlockQuote, κώδικας
  • ΕΝΤΥΡΙΑ: Σπάνιο, σύνδεση, αναφορά, εικόνα, φόρμουλα
  • Ομάδα: Τμήμα, Άρθρο, Μέρος, Μερική

Συμβουλές και βέλτιστες πρακτικές

  • Πάντα ορίστε Title και Language Ο ΣΕ TaggedContent Για την συμμόρφωση PDF/UA.
  • Κατασκευάστε το δομικό δέντρο πάνω προς τα κάτω: δημιουργήστε στοιχεία, στη συνέχεια προσθέστε παιδιά.
  • Χρησιμοποιήστε SetAlternativeText Στοιχεία για την προσβασιμότητα του αναγνώστη οθόνης.
  • Σημειώστε τα τραπέζια με THead, TBody, TFoot Για την κατάλληλη σημαντική πίνακα.
  • Εγκρίθηκε η συμμόρφωση PDF/UA με το PdfFormatConversionOptions (Δείτε τον οδηγό μετατροπής).

κοινά ζητήματα

ΘέμαΑιτίαΦΙΛΕΞΗ
Εξέλιξη PDF/UAΤο δέντρο που λείπει από τα απαραίτητα στοιχείαΒεβαιωθείτε ότι όλα τα περιεχόμενα έχουν αντίστοιχα στοιχεία δομής
Η εντολή της επικεφαλής είναι λάθοςH2 εμφανίζεται πριν από H1Ακολουθήστε την ακολουθία της ιεραρχίας επικεφαλής
Η εικόνα δεν έχει κείμενοSetAlternativeText Δεν καλείταιΠάντα να παρέχει κείμενο για εικόνες
Το τραπέζι που δεν αναγνωρίζεται από τον αναγνώστη οθόνηςΗ έλλειψη δομής THead/TBodyΧρησιμοποιήστε το πλήρες API δομής πίνακα

FAQ

Τι είναι ένα ετικέτα PDF;?

Ένα ετικέτα PDF περιλαμβάνει ένα λογικό δομικό δέντρο που χαρτογραφεί οπτικό περιεχόμενο σε σημαντικά στοιχεία (επίπεδα, παραγράφους, πίνακες), επιτρέποντας εργαλεία προσβασιμότητας και επαναφόρτωση περιεχομένου.

Το PDF είναι το ίδιο με το PDF/UA;?

Το PDF/UA είναι ένα πρότυπο που απαιτεί ετικέτα και πρόσθετες κανόνες προσβασιμότητας. τα Tagged PDFs αποτελούν προϋπόθεση για την συμμόρφωση με το PDF / UA.

Μπορώ να βάλω ένα υπάρχον PDF;?

Η TaggedContent Το API λειτουργεί καλύτερα με έγγραφα που δημιουργούνται από το scratch. υφιστάμενες PDFs, ελέγξτε το δομικό δέντρο μέσω Document.TaggedContent.


Συνοπτική αναφορά API

Κλάση / ΜέθοδοςΠεριγραφή
TaggedContentΠρος το παρόν, η λειτουργία της Λογικής Στρατηγικής
TaggedContent.SetTitleΟρισμός του τίτλου εγγράφου για προσβασιμότητα
TaggedContent.SetLanguageΕισάγετε τη γλώσσα του εγγράφου
ITaggedContentΕπαφάνεια με εργοστάσια μέθοδοι για όλους τους τύπους στοιχείων
StructureElementΚλάση βάσης για όλα τα στοιχεία της δομής
StructureElement.AppendChildΠροσθέστε ένα παιδικό στοιχείο στο δέντρο
StructureElement.SetTextΕισάγετε το περιεχόμενο ενός στοιχείου
TableElementΔιαθέσιμο στοιχείο δομής πίνακα
TableElement.CreateTHeadΔημιουργία του τμήματος τίτλου πίνακα
TableElement.CreateTBodyΔημιουργία του τμήματος σώματος πίνακα
TableTRElementΕτικέτες Τάπος Στάδιο
TableTRElement.CreateTDΠροσθέστε ένα κελί δεδομένων
TableTRElement.CreateTHΠροσθέστε ένα κελί επικεφαλής
IllustrationElementΦωτογραφία / Εικόνα Σύνθεσης
IllustrationElement.SetImageΠροσθέστε μια εικόνα στην εικονογράφηση

Δείτε επίσης

 Ελληνικά