如何从含无障碍标签的HTML生成JAWS友好的PDF？求经验分享

我之前在项目里刚好碰到过一模一样的需求——常规工具（比如jsPDF系列）确实没法很好地处理PDF无障碍标签嵌入，下面是我亲测有效的几个方案，供你参考：

1. 使用Chrome Headless + Puppeteer #

Chrome本身对网页无障碍的支持很完善，用Puppeteer调用Chrome的打印功能可以生成带完整无障碍标签的PDF，JAWS能完美识别这些标签。

关键配置与代码示例 #

你需要确保HTML本身的无障碍结构正确（语义化标签、aria属性等），然后用Puppeteer的tagged: true参数启用标签生成：

const puppeteer = require('puppeteer');

async function generateAccessiblePDF() {
  const browser = await puppeteer.launch({ headless: 'new' }); // 用新版无头模式
  const page = await browser.newPage();
  
  // 加载你的本地HTML文件或在线页面
  await page.goto('file:///Users/you/project/accessible-page.html', { 
    waitUntil: 'networkidle0' // 确保页面完全加载
  });
  
  // 生成带无障碍标签的PDF
  await page.pdf({
    path: 'accessible-output.pdf',
    format: 'A4',
    printBackground: true, // 保留背景样式
    tagged: true, // 核心：启用PDF标签生成
    displayHeaderFooter: false
  });
  
  await browser.close();
}

generateAccessiblePDF();

注意点 #

• 一定要用语义化HTML（<header>、<nav>、<main>、<button>等），而不是全用<div>模拟；
• 图片必须加alt文本，表格要正确使用<thead>、<th scope="col/row">；
• 生成后可以用Adobe Acrobat的「辅助工具检查器」验证标签是否正确。

2. 使用PrinceXML #

这是一款专门做HTML/CSS转PDF的商业工具，对无障碍的支持是它的核心特性之一，完全兼容WCAG标准，能把HTML里的所有无障碍属性精准转换成PDF的标签结构，JAWS识别毫无问题。

命令行示例 #

# 安装后直接调用，--tagged参数启用无障碍标签
prince --tagged --pdf-output=final-accessible.pdf your-source.html

它支持复杂的CSS布局和动态内容，适合企业级的复杂文档转换，虽然是付费工具，但有免费试用版可以先测试效果。

3. 使用WeasyPrint（开源方案） #

如果你倾向于开源工具，WeasyPrint是个不错的选择，它基于Python，支持生成带标签的PDF，对HTML/CSS的兼容性也很好。

Python代码示例 #

from weasyprint import HTML

# 生成带无障碍标签的PDF
HTML('path/to/your-accessible.html').write_pdf(
    'output.pdf',
    tagged=True, # 启用标签
    presentational_hints=True # 保留样式提示
)

注意点 #

WeasyPrint对一些复杂CSS的支持不如PrinceXML，但对于常规的无障碍页面完全够用，而且免费开源。

通用建议 #

不管用哪个工具，HTML本身的无障碍质量是前提：

• 避免用JS动态生成的内容（如果必须用，要确保Puppeteer/WeasyPrint等工具能等待内容加载完成）；
• 测试时一定要用JAWS实际朗读PDF，不要只依赖工具的验证；
• 不要忽略PDF里的文档属性（标题、作者等），这些也是无障碍的一部分。

内容的提问来源于stack exchange，提问作者glass duo