Appearance
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 的值已定稿,未安装时回退系统衬线,不会出现方块字。