组件/无障碍

无障碍

Tuffex 组件的无障碍约定与覆盖范围

自 0.4.0BETA

范围

以 WCAG 2.1 AA 为开发目标,不是认证结论。

焦点

焦点环只画在 :focus-visible 上:鼠标点击不留环,键盘走查始终可见。

Token作用
--tx-focus-ring-color焦点环颜色
--tx-focus-ring-shadow环外光晕
  • 深色与高对比度调色板都会重新定义这两个 token。
  • 没有 :focus-visible 规则的组件,要么不可聚焦,要么把焦点交给可聚焦的子元素。
  • 被圆角容器裁切的组件把焦点环画在内侧,避免被父级 overflow: hidden 切成直角;样板是折叠面板表头。

动效

约定做法
响应 prefers-reduced-motion: reduce保留状态、去掉位移:不确定进度条停止扫动但保留半透明轨道,折叠面板直接展开
只动合成属性transform 与 opacity
必须动布局时(如高度 0 ↔ auto)先测量,再用 JavaScript 驱动数值;不对猜测的固定 height 做补间

对比度

高对比度调色板在浅色与深色下都提高文本与边框对比度,材质面板改画不透明底色、不再模糊背后的页面;它经 @media (prefers-contrast: more) 自动跟随系统。强制开启或退出的选择器、各组件的具体变化见《主题定制》。

容易出错的 token 组合(同色 tint 上的浅色徽标、深色页面上的版本胶囊)在声明旁注释实测对比度。

语义

模式做法
用可见文本命名可访问名取自可见标签;只能靠印字命名的控件(如进度条)提供 ariaLabel prop
隐藏装饰与相邻文本重复的字形带 aria-hidden,标签只朗读一次
关联展开状态触发器写 aria-expanded,aria-controls 指向面板生成的 id
EXAMPLE.VUE
<template>
  <TxProgressBar :percentage="40" ariaLabel="上传进度" />
</template>

覆盖到哪里为止

  • 没有自动化无障碍测试套件;无障碍行为由各组件自己的测试与人工评审保证,可能有遗漏。
  • 侧边栏仍标 开发中 的组件尚未评审。
  • 屏幕阅读器测试为人工进行,没有固定测试矩阵。
  • 组件页都附源码位置;修复落在组件源码,所有使用方一并生效。

技术实现

  • 焦点与对比度 token:packages/tuffex/packages/components/style/variables.scss。
  • 主题与对比度选择器:《主题定制》。