本技能为 HTML 邮件无障碍的参考数据,本身不是审查器,供 email-accessibility 智能体使用。
用途:在邮件客户端渲染限制下编写无障碍 HTML 邮件。
主要能力与要点: 渲染限制:Gmail、Outlook(Win)、Yahoo、Outlook.com 会剥离语义 HTML、role、aria-*、tabindex;外部 CSS 与 JavaScript 在各客户端均被剥离;Outlook 桌面版使用 Word 渲染引擎,不支持 CSS Grid 与 Flexbox。 布局:布局表格须加 role="presentation" 并设 cellspacing/cellpadding/border="0",避免读屏器朗读表格语义;数据表格相反,需 th、scope、caption。阅读顺序遵循源码顺序,单列最易无障碍。 图片:每个 img 都要有 alt,装饰图用 alt="";设置显式宽高与 display:block,并在 img 上写字体颜色样式,以应对默认屏蔽图片时显示替代文本。 链接:链接文字须具描述性,保留下划线(不能仅靠颜色),样式直接写在 a 标签上;按钮可用 bulletproof 表格加 a 加 span 的写法。 其他:标题层级不跳级;html 设 lang 与 xmlns;深色模式用 color-scheme meta 与 prefers-color-scheme 媒体查询,Outlook.com 可用 data-ogsb="ignore" 防反转,透明 PNG 优于白底 JPG。 框架:给出 MJML 的 mj-image/mj-button 与 Foundation for Emails 的写法示例。
限制:仅覆盖资料所述范围,价格、平台支持与效果等未提供。