How to Export PDF/UA Format Documents in C

Que código preciso para exportar PDF/UA?

O exemplo a seguir demonstra a conversão de um PDF existente para o formato PDF/UA. Essa abordagem funciona quando você tem documentos antigos que precisam atender aos padrões de acessibilidade. O processo de conversão preserva o conteúdo do documento, adicionando as estruturas de acessibilidade necessárias exigidas pela conformidade com o padrão PDF/UA.

:path=/static-assets/pdf/content-code-examples/how-to/pdfua-fromfile.cs

using IronPdf;

// Open PDF File
PdfDocument pdf = PdfDocument.FromFile("wikipedia.pdf");

// Export as PDF/UA compliance PDF
pdf.SaveAsPdfUA("pdf-ua-wikipedia.pdf");

Imports IronPdf

' Open PDF File
Dim pdf As PdfDocument = PdfDocument.FromFile("wikipedia.pdf")

' Export as PDF/UA compliance PDF
pdf.SaveAsPdfUA("pdf-ua-wikipedia.pdf")

Qual a diferença entre PDF/UA-1 e PDF/UA-2?

O PDF/UA-1 (ISO 14289-1) é o padrão original de acessibilidade universal para documentos PDF, lançado em 2012. Ele estabelece a base para arquivos PDF acessíveis, com suporte para tecnologias assistivas e conteúdo estruturado.

O PDF/UA-2 (ISO 14289-2:2024) é a versão mais recente, oferecendo suporte aprimorado para recursos modernos de PDF, incluindo melhor tratamento de campos de formulário, anotações, conteúdo multimídia e estruturas de documentos complexas. O formato PDF/UA-2 oferece melhor compatibilidade com as especificações do PDF 2.0, mantendo ao mesmo tempo a retrocompatibilidade com os requisitos de acessibilidade.

Para especificar o formato PDF/UA-2 ao exportar, use o parâmetro de versão no método SaveAsPdfUA:

:path=/static-assets/pdf/content-code-examples/how-to/pdfua-pdfua2.cs

using IronPdf;

// Load existing PDF
var pdf = PdfDocument.FromFile("input.pdf");

// Export as PDF/UA-2 format
pdf.SaveAsPdfUA("output_pdfua2.pdf", PdfUaVersion.PdfUa2);

Imports IronPdf

' Load existing PDF
Dim pdf = PdfDocument.FromFile("input.pdf")

' Export as PDF/UA-2 format
pdf.SaveAsPdfUA("output_pdfua2.pdf", PdfUaVersion.PdfUa2)

Como faço para converter para PDF/UA-2 na memória?

Para fluxos de trabalho que exigem modificações adicionais antes de salvar, use ConvertToPdfUA() para converter os documentos na memória primeiro. Essa abordagem permite aplicar transformações de conformidade com PDF/UA-2 e, em seguida, executar outras operações antes da exportação final.

:path=/static-assets/pdf/content-code-examples/how-to/pdfua-convert-ua2.cs

using IronPdf;

// Open PDF File
PdfDocument pdf = PdfDocument.FromFile("input.pdf");

// Convert to PDF/UA-2 in memory
pdf.ConvertToPdfUA(PdfUAVersions.PdfUA2);

// Perform additional modifications if needed
// ...

// Save the converted document
pdf.SaveAs("output-ua2.pdf");

Imports IronPdf

' Open PDF File
Dim pdf As PdfDocument = PdfDocument.FromFile("input.pdf")

' Convert to PDF/UA-2 in memory
pdf.ConvertToPdfUA(PdfUAVersions.PdfUA2)

' Perform additional modifications if needed
' ...

' Save the converted document
pdf.SaveAs("output-ua2.pdf")

Qual é a aparência do arquivo PDF/UA gerado?

O arquivo de saída está em conformidade com o padrão PDF/UA:

PDF de saída:

Como faço para renderizar HTML diretamente em PDF/UA?

Além de exportar documentos para o padrão PDF/UA, use o método RenderHtmlAsPdfUA para renderizar a entrada HTML diretamente no formato PDF/UA. Essa abordagem funciona bem ao criar novos documentos do zero ou ao trabalhar com conteúdo dinâmico de aplicativos da web.

Ao renderizar HTML para PDF/UA, certifique-se de que seu HTML siga as melhores práticas de acessibilidade: use elementos HTML semânticos, forneça uma hierarquia de títulos adequada, inclua texto alternativo para imagens e mantenha um fluxo de conteúdo lógico. O mecanismo de renderização Chrome do IronPDF garante uma conversão precisa, mantendo os recursos de acessibilidade. Para obter mais informações sobre a conversão de HTML para PDF, consulte nosso guia de HTML para PDF .

Aqui está um exemplo de código:

Qual código renderiza HTML para PDF/UA?

Este exemplo mostra como criar um documento compatível com PDF/UA diretamente a partir de conteúdo HTML. Observe o uso de elementos HTML semânticos, como títulos e parágrafos, que são essenciais para a criação de documentos PDF acessíveis. O título dos metadados garante que o documento tenha a identificação adequada, um requisito de conformidade com o padrão PDF/UA.

:path=/static-assets/pdf/content-code-examples/how-to/pdfua-render-html-to-pdfua.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// html is a large stright above of a full html page with <html><head><style><body> etc...
var pdf = renderer.RenderHtmlAsPdfUA(@"
    <!DOCTYPE html>
    <html>
    <head>
        <title>Document</title>
    </head>
    <body>
        <h1>Heading 1</h1>
        <h2>Heading 2</h2>
        <p>Paragraph text</p>
    </body>
    </html>");

pdf.MetaData.Title = "v2025.1";

pdf.SaveAs("html-string-ua-ironpdf.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

' html is a large stright above of a full html page with <html><head><style><body> etc...
Private pdf = renderer.RenderHtmlAsPdfUA("
    <!DOCTYPE html>
    <html>
    <head>
        <title>Document</title>
    </head>
    <body>
        <h1>Heading 1</h1>
        <h2>Heading 2</h2>
        <p>Paragraph text</p>
    </body>
    </html>")

pdf.MetaData.Title = "v2025.1"

pdf.SaveAs("html-string-ua-ironpdf.pdf")

Como posso verificar a conformidade com o PDF/UA?

O arquivo de saída está em conformidade com o padrão PDF/UA:

Para validar externamente a conformidade de PDF/UA, utilize o veraPDF Conformance Checker, uma ferramenta gratuita e de código aberto desenvolvida para validação de PDFs. Esta ferramenta verifica documentos em relação aos padrões PDF/UA-1 e PDF/UA-2 e fornece relatórios detalhados sobre problemas de conformidade. A validação regular é crucial ao implementar recursos de acessibilidade em seu fluxo de trabalho de PDF.