如何使用文本超链接在 iText7 中创建 PDF/UA

问题描述

我正在尝试创建一个包含 iText 7 文本超链接的 PDF/UA 兼容文件。PDF/UA 的 Acrobat Preflight 测试和 PDF Accessibility Checker (PAC 3) 都抱怨 PDF 文件说 PDF不合规。

PAC 3 表示“链接”注释未嵌套在“链接”结构元素内”，并且 Acrobat 预检测试表示链接注释在 Contents 键中没有替代描述。 以下是我尝试创建包含文本超链接的 PDF/UA 兼容输出。

任何建议将不胜感激。

public void testHyperLink() throws IOException {
    // Create PDF/UA with text hyperlink
    String filename = "./results/HyperLink.pdf";
    WriterProperties properties = new WriterProperties();
    properties.addUAXmpMetadata().setPdfVersion(PdfVersion.PDF_1_7);
    PdfWriter writer = new PdfWriter(filename,properties);
    pdfDoc = new PdfDocument(writer);
    //Make document tagged
    pdfDoc.setTagged();
    pdfDoc.getCatalog().setLang(new PdfString("en-US"));
    pdfDoc.getCatalog().setViewerPreferences(new PdfViewerPreferences().setdisplayDocTitle(true));
    PdfDocumentInfo info = pdfDoc.getDocumentInfo();
    info.setTitle("Hello Hyperlinks!");
    document = new Document(pdfDoc);

    // Must embed font for PDF/UA
    byte[] inputBytes = Files.readAllBytes(Paths.get("./resources/fonts/opensans-regular.ttf"));
    boolean embedded = true;
    boolean cached = false;
    PdfFont font = PdfFontFactory.createFont(inputBytes,PdfEncodings.CP1252,embedded,cached);
  
    Text text = new Text("This is a Text link");
    text.setFont(font);
    text.setFontSize(16F);
    // Add alternate text for hyperlink
    text.getAccessibilityProperties().setAlternateDescription("Click here to go to the iText website");
    PdfAction act = PdfAction.createURI("https://itextpdf.com/");
    text.setAction(act);

    Paragraph para = new Paragraph();
    para.add(text);
    document.add(para);
    document.close();
    System.out.println("Created "+ filename);
}

解决方法

一个链接对象可能就是你想要的：

            Link lnk = new Link("This is a Text link",PdfAction.CreateURI("https://itextpdf.com/"));
            lnk.SetFont(font);
            lnk.GetLinkAnnotation().SetBorder(new PdfAnnotationBorder(0,0));//Remove the default border
            lnk.GetAccessibilityProperties().SetAlternateDescription("Click here to go to the iText website");
            Paragraph para = new Paragraph();
            para.Add(lnk);
            document.Add(para);