Skip to content

Accessibility ​

颜色 ​

测试会逐主题验证 semanticTokenDefinitions 中声明的每一个 foreground pairing(含实心状态色、Card、Popover 与全部 *-subtle 组合),最低对比度为 4.5:1。当前覆盖 18 组配对 × 2 主题。Playground 的 Inspector 会显示有明确 foreground pairing 的当前比值。

token 释义由 Record<SemanticColorName, SemanticTokenDefinition> 强制约束:新增语义色而不写释义会导致类型检查失败,声明了 foreground 却达不到 AA 会导致测试失败。

颜色不是状态的唯一线索。Alert 同时提供图标、标题或明确文案;边框与 Surface 层级也不只依靠阴影。

焦点 ​

键盘焦点统一使用 ring,示例 shortcut 为 pd-focus-ring。它只在 focus-visible 时出现,并与背景保留 offset。

动效 ​

duration-fast / normal / slow 与 ease-standard / emphasized 是基础动效 Token。主题 CSS 内置 prefers-reduced-motion: reduce 降级,避免长时间动画和滚动效果。

字体 ​

本包不下载也不打包任何 WebFont,只输出字体栈:

  • 默认 font-sans 使用操作系统默认无衬线(ui-sans-serif),中文回退到 PingFang SC / Microsoft YaHei。正文与界面一律走这条。
  • font-serif 是强调字体,默认「霞鹜文楷 → 系统衬线」。霞鹜文楷是楷体,适合标题、引用与需要衬线气质的排版,不适合大段正文,因此不作为全局默认。
  • font-mono 使用操作系统默认等宽(ui-monospace),中文注释落到 LXGW WenKai Mono。

因为字体不随包分发,字体实验室只做一次本机可用性提示:用 canvas 测量宽度探测本机是否安装了霞鹜文楷,并在基础页显示「已安装 / 未安装 · 回退系统衬线」。这是环境提示而非可切换方案——font-serif 的值已定稿,未安装时回退系统衬线,不会出现方块字。