概述

Fern 文档使用语义化 HTML 和 ARIA 属性来支持屏幕阅读器和键盘导航。

键盘导航

所有交互元素都支持使用 Tab、Enter 和 Space 键进行键盘导航。请查看键盘快捷键了解完整列表。

对话框和面板

Fern 文档中的对话框和面板专为键盘无障碍而设计。焦点会被限制在打开的对话框内，防止导航到对话框外部，搜索对话框支持使用方向键进行完整的键盘导航。

颜色对比度

Fern 自动执行 WCAG 2.1 AA 颜色对比度比率，确保文本和交互元素对所有用户都是可读的：

• 普通文本: 最低 4.5:1 (WCAG AA)
• UI 元素: 最低 3:1
• 增强: 在可行时达到 7:1 (WCAG AAA)

当您在 docs.yml 文件中配置颜色时，Fern 会验证主色调颜色。如果您的主色调颜色相对于背景颜色不满足最低对比度比率，Fern 将：

1. 在 fern check 验证期间显示警告
2. 在运行时自动调整主色调颜色以满足 WCAG AA 标准
3. 在可能的情况下尝试进一步调整到 WCAG AAA (7:1)