La estructura lógica

La estructura lógica

PDFs etiquetados incluyen un árbol de estructura lógica que define el documento Hierarquía semántica: parágrafos, títulos, tablas, figuras y listas. FOSS para .NET proporciona el TaggedContent API para la construcción y inspección Esta estructura, que es esencial para el cumplimiento de la accesibilidad PDF/UA.

Acceso a los contenidos etiquetados

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

Creación de elementos estructurales

ITaggedContent proporciona métodos de fábrica para cada elemento estructural estándar Los elementos se agrupan en un árbol llamando 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);

Tablas estructuradas

TableElement Crea tablas accesibles con secciones de cabeza, cuerpo y pie.

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

Ilustraciones y cifras

IllustrationElement Imagen de la estructura en el árbol.

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

Tipos de elementos estructurales

La API soporta el conjunto completo de tipos de elementos de estructura PDF:

• nivel de bloqueo: Parágrafo, Título (H1-H6), Lista, ListItem, Tabla, BlockQuote, Código
• En línea: Espan, Link, Anotación, Figura, Fórmula
• Grupo: División, artículo, sección, parte

Consejos y mejores prácticas

• Siempre se establece Title y Language En el TaggedContent Para la conformidad PDF/UA.
• Construye el árbol de estructura arriba hacia abajo: crea elementos, luego apéndice a los niños.
• Uso SetAlternativeText El uso de los elementos para la accesibilidad del lector de pantalla.
• Título Tablas con THead, TBody, TFoot Para la semántica de mesa adecuada.
• Validar la conformidad PDF/UA con el PdfFormatConversionOptions (Vea el guía de conversión).

Problemas comunes

FAQ

¿Qué es un PDF etiquetado?

Un PDF etiquetado incluye un árbol de estructura lógica que mapa el contenido visual a elementos semánticos (títulos, parágrafos, tablas), lo que permite las herramientas de accesibilidad y el reflor de contenidos.

¿Es etiquetado PDF el mismo que PDF/UA?

PDF/UA es una norma que requiere etiquetado y reglas adicionales de accesibilidad. los PDF etiquetar son un requisito para el cumplimiento de PDF / UA.

¿Puedo etiquetar un PDF existente?

El TaggedContent API funciona mejor con documentos creados a partir de la escorcilla. PDFs existentes, inspecciona la estructura de la árbol a través de Document.TaggedContent.

Sumación de referencia API

Ver también

• Aspose.PDF for .NET Enterprise Product