mcpField
I
include

include

github.com/ghaida设计与 UI2292.8k 次安装今天更新
代码仓库

关于 include

include 是面向设计师的无障碍设计技能,将 WCAG 指南转化为实用的界面设计方法。它涵盖屏幕阅读器体验、键盘操作、对比度、触控目标和辅助技术测试。

主要功能

  1. 01将 WCAG 2.2 转化为设计指导
  2. 02规划屏幕阅读器阅读顺序与页面地标
  3. 03检查键盘操作与焦点管理
  4. 04评估对比度、文本替代和触控目标
  5. 05制定辅助技术人工测试方案

适用场景

  1. 01开展无障碍设计审查或 WCAG 检查
  2. 02规划键盘与屏幕阅读器交互流程
  3. 03检查表单标签、错误提示和颜色使用
  4. 04为辅助技术测试制定人工检查计划

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ghaida/intent --skill include

安装后在 Claude Code 中输入/include确认已加载。

详细介绍

包容设计 —— 为所有人而设计

概述

无障碍不是一项功能。它不是一个阶段,也不是设计「完成」后再「添加」的东西。它是一门设计学科,旨在确保每个人——无论能力、设备、情境或背景如何——都能使用你打造的产品。

全球有 10 亿人有残障。仅凭这个数字,就足以终结关于无障碍是否重要的争论。但无障碍不只是关乎永久性残障,更关乎人类体验的方方面面:一位家长一只手抱着婴儿,另一只手用手机;一位通勤者在阳光直射下阅读屏幕;一位在嘈杂咖啡馆里无法播放音频的用户;一位正在从眼科手术中恢复的人;一位视力不如五年前的高管;一位努力集中注意力填写多步骤表单的 ADHD 青少年。

每个人都会遇到情境性或暂时性的能力受限。以无障碍为目标进行设计,能让所有这些人的体验都变得更好——而不仅仅是那些你在「照顾」的人。路缘坡道最初是为轮椅使用者设计的,如今所有推婴儿车、拉行李箱、推送货车或骑自行车的人都会使用它们。优秀的无障碍设计也是如此。

这项技能将无障碍视为设计质量,而非合规负担。但它也不会回避法律现实——在许多司法管辖区,符合 WCAG 标准是法律要求(例如美国的 ADA、《欧洲无障碍法案》、针对政府部门的 Section 508,以及全球类似的法规)。忽视无障碍既是设计失误,也是法律风险。

**适用场景:**无障碍审计、包容性设计评审、WCAG 合规检查、屏幕阅读器测试指导、键盘导航设计、颜色对比度评估、触控目标审查,或任何需要回答「每个人都能使用吗?」的时刻。


技能系列

Include 与完整的 Intent 技能体系协同工作。无障碍设计涉及方方面面——每项技能产出的作品都必须具备无障碍性。

  • /journey — 流程必须适用于仅使用键盘的用户、屏幕阅读器用户、开关控制用户和语音控制用户,而不仅仅是使用鼠标和触控的用户。/journey 设计的每个流程都应接受输入方式独立性审查。如果他们设计拖放交互,你要确保提供键盘替代方式。如果他们设计基于手势的移动端流程,你要确保提供单指操作的备用方式。

  • /articulate — 清晰的文字就是无障碍的文字。使用通俗易懂的语言、简短的句子、有意义的链接文本(“阅读无障碍报告”,而不是“点击这里”)、描述性标题,以及能说明输入内容的标签。/articulate 负责文案;你则提供无障碍方面的建议。

  • /organize — 导航结构必须能被辅助技术解析。地标(header、nav、main、footer)、标题层级(H1 至 H6,不跳级)、跳转链接和面包屑都是信息架构决策,会直接影响无障碍性。/organize 设计信息架构时,你要确保它能转化为合理的屏幕阅读器体验。

  • /fortify — 边界情况加固与无障碍设计相互交叠。针对慢速网络、小屏幕、单手操作和极端内容进行设计,既是韧性工作,也是包容性设计。请协调分工,避免重复——你负责无障碍方法;他们负责状态和压力测试方法。

  • /evaluate — 无障碍评估是每次 UX 评估的一部分。/evaluate 开展启发式评审时,无障碍问题会出现在多项启发式评估中。你详细的无障碍方法将为他们的评估框架提供参考。无障碍类别中的评估结果会交由你跟进。

  • /specify — 屏幕阅读器流程文档、键盘导航图和修复计划都包含在交接资料中。ARIA 角色、键盘交互模式、焦点管理行为和屏幕阅读器播报并非“锦上添花”的注释,而是构建者据以实现产品的内容,因此应纳入你的产出物,并在资料包的入口页面中引用。

  • /blueprint — 系统架构会影响无障碍性。通知系统需要 ARIA live 区域。实时更新需要礼貌播报。无限滚动需要替代导航方式。/blueprint 设计系统时,你要指出哪些架构决策会影响无障碍性,以及这些决策会带来哪些影响。

  • /philosopher — “我们排除了哪些甚至从未想过要考虑的人?”哲学家会帮助揭示“所有人”这个定义中隐含的假设——那些你未曾设想的用户群体、未曾考虑的使用情境,以及包容性设计可能仍会遗漏的人群。


核心能力

1. 面向设计师的 WCAG 2.2

《Web 内容无障碍指南》为无障碍设计提供了通用术语和最低标准。但 WCAG 面向的是一致性测试,而非设计决策。本节将 WCAG 的四项原则转化为实用的设计指导。

可感知性——每位用户都能感知到信息吗?

颜色对比度:普通文本的最低对比度为 4.5:1,大号文本(18pt 及以上,或 14pt 及以上的粗体)和 UI 组件的最低对比度为 3:1。请在浅色和深色模式下检查对比度,并依据实际背景进行检查,而非假设的背景——如果文字叠加在图像上,就要关注最差情况下的对比度。

文本替代:每张有意义的图片都需要替代文本,以传达与图片相同的信息。装饰性图片需要空的 alt 属性(alt=""),以便屏幕阅读器跳过。复杂图片(图表、示意图、信息图表)既需要简短的替代文本,也需要较长的描述。用作操作按钮的图标需要无障碍名称。 媒体:视频需要字幕(不是自动生成的字幕——自动生成的字幕只能作为起点,不能直接作为成品)。音频内容需要文字稿。动画需要暂停控件。任何内容都不应自动播放并带有声音。

不依赖颜色:绝不能只通过颜色传达信息。对 8% 有色觉缺陷的男性来说,红绿状态指示器是看不见的。请添加形状、图标、标签或图案。“必填字段以红色标记”不合格——“必填字段以星号(*)标记”则可行。

重排:内容必须能在 400% 缩放时重新排列,以适应视口,且不需要水平滚动(需要二维布局的内容,如数据表格,除外)。将浏览器宽度设为 320px 进行测试——如果内容被截断或相互重叠,说明设计不合格。

可操作性——每位用户都能操作界面吗?

支持键盘操作:每个交互元素都必须能仅用键盘访问和操作。使用 Tab 键导航。使用 Enter 或空格键激活。复合控件中使用箭头键。使用 Escape 键关闭。任何操作都不应要求鼠标悬停、右键点击或多指手势,除非同时提供替代方式。

不得造成键盘陷阱:按 Tab 键必须始终能向前移动(按 Shift+Tab 则向后移动)浏览页面。唯一可接受的焦点陷阱是在模态对话框内——且该模态必须能通过 Escape 键关闭。

时间限制:如果存在会话超时或限时交互,用户必须能够延长时限、关闭时限,或至少在时限到期前 20 秒收到警告。例外:拍卖、考试等时间限制不可或缺的实时事件。

不得诱发癫痫:任何内容每秒闪烁都不得超过 3 次。这不是可选项——这是医疗安全问题。此要求适用于视频内容、动画插图和过渡效果。

触控目标:根据 WCAG 2.2,最小尺寸为 24x24 CSS 像素。主要操作建议为 44x44px。相邻触控目标之间至少间隔 8px。这些最低要求适用于有运动障碍的人、单手使用手机的人、手指较粗的人,以及身处行驶车辆中的人。

跳过导航:每个页面上,“跳转到主要内容”链接都应是第一个可聚焦元素。屏幕阅读器用户和键盘用户不应为了到达内容而必须逐一跳过整个导航栏。

易于理解——每位用户都能理解内容和界面吗?

阅读难度:根据受众撰写。面向消费者的产品应以美国八年级阅读水平为目标。专业工具可以使用更高的阅读难度,但无论如何,说明和错误消息都应尽可能简单。使用简短的句子。避免使用行话。首次使用技术术语时应加以解释。

导航一致:每个页面上的导航都应位于相同的位置,并保持相同的顺序。用户会建立对各项内容位置的心理模型——在不同页面之间移动导航会破坏这些模型,并让有认知障碍的用户感到尤其迷惑。

交互可预测:点击链接应进行导航。更改下拉选项不应自动提交表单。悬停不应触发不可逆的操作。不得出现意外的上下文变化——用户应始终感觉自己能够掌控操作。

输入辅助:每个表单输入项都需要可见标签(不能只有占位符文本——占位符会在获得焦点时消失)。必填字段必须在提交前标明。错误消息必须指出字段和问题。提供预期格式示例(“MM/DD/YYYY”),而不只是字段名称。

稳健性——当前和未来的辅助技术都能正常使用吗?

HTML 结构有效:语义化 HTML 是基础。按钮使用 button,链接使用 a,标题使用标题元素,列表使用列表元素。语义化 HTML 无需额外操作,就能向辅助技术传达结构和用途。 正确使用 ARIA:ARIA(无障碍富互联网应用)是对 HTML 语义的补充,而非替代。ARIA 的第一条原则:如果原生 HTML 元素可以实现相同功能,就不要使用 ARIA。第二条原则:错误使用 ARIA 比不使用更糟。一个带有 role="button"、却无法处理 Enter 和 Space 按键的 div,比没有 role 的 div 更糟——它会告诉屏幕阅读器这是一个按钮,却没有按钮应有的行为。

使用真实辅助技术进行测试:自动化工具只能发现约 30% 的无障碍问题。其余 70%——不合逻辑的阅读顺序、令人困惑的交互模式、缺失的上下文、糟糕的焦点管理——需要使用真实辅助技术进行手动测试。

2. 屏幕阅读器体验设计

屏幕阅读器无障碍不只是为图片添加替代文本,而是要设计界面的完整非视觉体验。

阅读顺序。 DOM 顺序是否与视觉顺序一致?CSS flexbox 顺序、绝对定位和网格布局可能导致视觉顺序与阅读顺序不一致——屏幕阅读器按 DOM 顺序朗读。如果最重要的内容在视觉上排在最前面,却在 DOM 中排在最后,屏幕阅读器用户就会最后才遇到它。

地标。 屏幕阅读器用户通过地标导航:页眉、导航、主体、补充内容(侧边栏)、页脚信息。包含正确地标的页面能让屏幕阅读器用户直接跳转到导航、主体内容或页脚。没有地标的页面则迫使他们从上到下逐行阅读。每个页面都应恰好有一个主体地标。导航应使用 nav 元素(可以有多个,但要用 aria-label 标注,例如:"Primary navigation"、"Footer navigation")。

标题层级。 屏幕阅读器用户使用标题导航的频率高于任何其他方式。H1 用于页面标题。H2 用于主要章节。H3 用于这些章节中的小节。不要跳过层级(例如,从 H1 跳到 H3,中间没有 H2)。不要为了视觉样式而使用标题元素——如果看起来像标题,但结构上不是标题,就使用 CSS。如果结构上是标题,无论你希望它看起来如何,都应使用标题元素。

实时区域。 无需重新加载页面便会更新的动态内容——通知、聊天消息、表单验证消息、自动更新的数据、进度指示器——需要使用 aria-live 区域。对于可以等到用户空闲时再播报的更新(新聊天消息、股票价格),使用 aria-live="polite"。只有紧急更新需要打断用户时,才使用 aria-live="assertive"(错误消息、重要警报)。过度使用 assertive 会造成糟糕的体验——屏幕阅读器会不断打断用户。

表单标签。 每个输入框都必须有程序化标签——使用带有 for 属性、指向输入框 ID 的 label 元素,或使用 aria-label,或 aria-labelledby。占位符文本不是标签。相关输入框组(单选按钮、复选框)必须放在 fieldset 中,并用 legend 元素为该组命名。用 legend 将街道、城市、州、邮政编码字段括在“收货地址”之下,能为屏幕阅读器用户提供所需的上下文。

状态传达。 交互元素必须传达其当前状态:展开/折叠(aria-expanded)、已选中/未选中(aria-selected)、已勾选/未勾选(aria-checked)、当前页面(aria-current="page")、已禁用(aria-disabled 或 disabled 属性)。如果没有状态传达,屏幕阅读器用户点击切换控件后,就不知道自己是否开启或关闭了某项功能。

隐藏内容。 装饰性图片应使用 aria-hidden="true" 或空的 alt 文本。仅供屏幕阅读器使用的内容(例如仅有图标的按钮的描述性标签)应使用视觉隐藏的 CSS 类,让内容保留在 DOM 中,但在屏幕上不可见。不要对仅供屏幕阅读器使用的内容使用 display:none 或 visibility:hidden——这两种方式也会让屏幕阅读器无法读取内容。

3. 键盘导航设计

键盘无障碍是影响最大的无障碍功能,因为它服务于最广泛的用户群体:屏幕阅读器用户、行动不便的用户、偏好使用键盘提高效率的高级用户、暂时受伤的用户,以及鼠标或触控板停止工作的任何人。

焦点管理。 按 Tab 键可将焦点向前移动。按 Shift+Tab 可向后移动。Tab 顺序应与视觉阅读顺序一致。所有交互元素都必须可获得焦点——如果某个元素可点击,就必须能通过 Tab 键选中(使用原生交互元素,或添加 tabindex="0" 并处理键盘事件)。

清晰可见的焦点指示器。 当前获得焦点的元素必须在视觉上清晰可辨。使用至少 2px 的实线轮廓,并确保其与背景的对比度至少为 3:1。不能只改变颜色——这会让色盲用户无法辨认。不能使用不明显的虚线——许多用户会看不见。默认的浏览器焦点环可作为最低标准;更醒目的自定义焦点指示器更好。切勿在没有提供更好替代方案的情况下使用 outline: none 移除焦点指示器。

跳过链接。 在每个页面上,将“跳转到主要内容”链接设为第一个可获得焦点的元素。可以将其设置为视觉隐藏,直到获得焦点时再显示(按 Tab 键时显示,焦点移过后再次隐藏)。这样键盘用户就能跳过重复的导航区块。

焦点陷阱。 只有模态对话框内应设置焦点陷阱。模态框打开时,焦点移入其中。按 Tab 键时,焦点在模态框内的交互元素之间循环。按 Escape 键可关闭模态框,并将焦点返回到触发它的元素。其他所有元素——下拉列表、菜单、侧边栏——都不应设置焦点陷阱。

复合组件的循环 tabindex。 选项卡组、菜单、工具栏、单选按钮组及类似的复合组件应使用循环 tabindex:按 Tab 键进入组件时,焦点落在当前活动或已选中的项上。使用方向键在组件内的各项之间移动。按 Tab 键离开组件时,焦点移至下一个组件。这样可以让 Tab 键顺序易于管理——包含 20 个按钮的工具栏应只占一个 Tab 停靠点,而不是 20 个。

自定义键盘快捷键。 如果实现了自定义快捷键,请记录这些快捷键。不要与辅助技术快捷键冲突(屏幕阅读器会占用许多组合键)。提供查看、更改或禁用自定义快捷键的方式。根据 WCAG 2.1,单字符快捷键(例如只按“s”进行搜索)必须可重新映射——它们会与语音控制和粘滞键冲突。

4. 认知无障碍

它常常被忽视,却始终影响深远。认知无障碍让每个人受益,但对于有学习障碍、注意力障碍、记忆障碍、自闭症、焦虑症的用户,以及任何感到压力大、疲惫、分心或不熟悉相关领域的人来说,它尤为重要。

使用浅显的语言。 根据受众,目标阅读水平设为八至十二年级。使用短句。每句话只表达一个观点。避免双重否定。避免使用无法跨文化理解的习语。首次使用术语时要加以解释。如果概念复杂,就拆分成几个步骤。阅读难度不是用户的问题,而是作者的问题。

保持模式一致。 同一种操作在任何地方都应有相同的效果。如果在某个页面上点击“X”会关闭模态窗口,那么在所有页面上都应如此。如果在某个列表中向左滑动会删除项目,那么在所有列表中都应如此。如果主要操作始终位于右下角,就应一直放在那里。模式不一致会迫使用户在每个屏幕上重新学习界面,这对有认知障碍的用户尤其不利。

预防错误。 对破坏性操作进行确认(“删除这个项目?此操作无法撤销。”)。尽早验证输入——在用户输入时进行行内验证,而不是等到提交表单后再验证。为可撤销的操作提供撤销功能。通过限制条件来防止无效输入(使用日期选择器代替自由文本日期字段,使用下拉列表代替要求精确格式的输入)。不要指望用户“多加小心”,而要设计系统,让人难以犯错。

尽量减少记忆负担。 优先让用户识别,而不是回忆——向用户展示可选项,而不是让他们去记。展示最近使用的项目、已保存的搜索和常用操作。如果某个流程需要用到前面步骤中的信息,就再次显示这些信息,不要指望用户记得。多步骤流程应显示已完成的内容、当前步骤和后续步骤。

清晰展示进度。 在多步骤流程中:我在哪里?还剩多少?我能返回吗?我能保存进度并稍后继续吗?步骤指示器(第 2 步,共 5 步)是满足基本需求的进度提示。显示步骤名称会更好。允许用户在已完成的步骤之间自由跳转,则是理想做法。

确保行为可预测。 不要出现意外弹窗。不要自动跳转。不要自动播放内容。不要仅因悬停就触发操作。用户应始终能掌控接下来会发生什么。意外情况会引发焦虑,这对有焦虑障碍的用户尤其有害,但对每个人来说都令人不适。

5. 运动障碍可访问性

运动障碍包括永久性状况(脑瘫、肌营养不良、脊髓损伤)、暂时性状况(手臂骨折、重复性劳损、腕管综合征)以及情境性状况(在公交车上单手使用手机、戴着厚手套)。

触控目标。 WCAG 2.2 的最低要求:24x24 CSS 像素。建议主要交互目标达到 44x44px。相邻目标之间至少留出 8px 间距。正文中的内联文本链接不受尺寸要求限制,但导航链接和操作按钮不例外。测量可点击区域,而不只是可见元素的尺寸——内边距也计入。

手势替代方案。 每种滑动、捏合、多指手势和基于路径的手势(绘制形状)都必须提供单指操作替代方案。滑动删除也必须提供删除按钮。捏合缩放也必须提供缩放控件。多指旋转必须提供替代输入方式。这既是 WCAG 的要求,也是实际需要——并非所有设备都支持所有手势。

拖放替代方案。 如果可以通过拖动重新排列项目,请提供替代方式:上移/下移按钮、重新排序菜单或排序下拉菜单。拖放需要精细的运动控制,许多用户无法做到;除非专门实现,否则拖放也没有键盘等效操作。

计时。 定时交互(按住以删除、长按以预览)必须提供替代方案或可调整的计时设置。需要按住 500ms 的按钮对有震颤、无法保持稳定的用户来说不可访问。请提供替代方式:普通点击并确认、菜单选项或可调整的计时设置。

精确操作。 避免要求精确定位的操作:模态框上的关闭按钮要足够大(至少 44x44px);复选框要小的话,也应让其标签可作为点击目标;不要让交互元素只在悬停时出现(有震颤的用户可能会意外触发悬停,并在点击前失去悬停状态)。为目标提供较大的可点击区域,并让触发操作更宽容。

6. 超越合规的包容性设计

WCAG 是底线,而非上限。合规意味着体验在技术上可访问。包容性设计意味着它真正适合所有人使用。

读写能力较弱。 为图标配上文字标签。充分运用视觉层次——最重要的信息应该最醒目。提供结果的可视化预览。使用渐进式披露,减少同时显示的文字量。只要能用视觉方式呈现,就绝不要只依赖文字。

低带宽。 设计时要考虑 2G 网络连接。渐进式加载——先加载文字,再加载图片,最后加载增强内容。延迟加载首屏以下的内容。尽可能压缩图片。提供先于媒体内容加载的文字替代内容。请考虑:37 亿人可以上网,但其中大多数人没有光纤宽带。

旧设备。 核心功能不应依赖最新的浏览器 API。采用渐进增强——基础体验在所有设备上都能运行,现代浏览器则可使用额外功能。在使用了 3-5 年的设备上进行测试。不要假设设备有充足的 RAM、快速的处理器或最新版本的操作系统。

情境性障碍。 单手使用手机(另一只手拿着咖啡、抱着孩子或抓着公交扶手)。强烈的阳光使屏幕内容难以看清。嘈杂环境中听不清音频。乘坐移动中的车辆时精细动作控制能力下降。黑暗环境中,最高亮度会让人感到刺眼。针对这些情境进行设计,也就能满足许多永久性障碍人士的需求。

衰老。 基础字号至少为 16px,并允许用户调大。提供高对比度模式。提供减少动态效果的选项(遵循 prefers-reduced-motion)。提供宽裕的触控目标。避免施加时间压力。简化导航。在大多数市场中,65 岁以上的用户是增长最快的互联网用户群体——为他们设计,就是为规模庞大且不断增长的受众设计。

神经多样性。 减少感官过载:不自动播放、不播放无法暂停的动画、不闪烁、不使用令人目不暇接的配色。帮助用户专注:尽量减少干扰,提供清晰的信息层次,允许用户自定义通知频率。提供清晰的结构:布局可预测、标签清晰、导航一致。避免模棱两可:使用直白的语言、明确的说明,以及带有标签且含义明确的图标。

7. 无障碍测试方法

自动化工具只能发现约 30% 的无障碍问题,而且主要是程序层面的问题(缺少替代文本、颜色对比度不足、缺少表单标签)。另外 70% 的问题——阅读顺序不合逻辑、交互模式令人困惑、缺少上下文、焦点管理不佳——需要手动测试。两者都不可或缺,单独使用任何一种都不够。

自动化测试。 工具:axe(浏览器扩展和 CI 集成)、Lighthouse(内置于 Chrome DevTools)、WAVE(用于显示可视化叠加层的浏览器扩展)。对每个页面和状态运行自动扫描。修复所有标记的问题——自动化检测出的问题是最容易解决的问题,没有理由带着这些问题发布。但要了解其局限:自动化测试通过,并不意味着体验具备无障碍性。

手动键盘测试。 使用 Tab 键,从第一个元素遍历完整个流程,直到最后一个元素。能否到达每个可交互元素?能否激活每个按钮和链接?能否浏览每个下拉菜单和菜单?焦点顺序是否合乎逻辑?焦点指示器是否清晰可见?能否退出每个模态框和叠加层?不碰鼠标能否完成主要任务?每个主要流程都要进行测试,而不仅仅是主页。

屏幕阅读器测试。 Mac/iOS 上的 VoiceOver(内置,按 Cmd+F5 开关)。Windows 上的 NVDA(免费下载)。Android 上的 TalkBack(内置)。在每个目标平台上至少使用一种屏幕阅读器进行测试。仔细体验:朗读顺序是否合理?交互元素是否会播报其角色和状态?表单字段是否有标签?实时区域是否会播报更新?是否有有意义的结构(标题、地标、列表)?

缩放测试。 在浏览器缩放比例为 200% 和 400% 时进行测试。内容应重新排布以适应视口,而无需水平滚动。文本应保持清晰易读。交互元素应仍然可用。任何内容都不应重叠或被裁切。请在用户实际使用的浏览器中测试——缩放行为各不相同。

颜色对比度测试。 使用对比度检查器(大多数浏览器开发工具都内置了此工具,也可以使用 Colour Contrast Analyser 等独立工具)。检查每种文本与背景的组合、每个图标、每个交互元素的边界。检查焦点指示器与背景的对比度。在浅色和深色模式下都要检查。根据实际背景进行检查——图片或渐变上的文本需要按最差情况计算对比度。

减少动态效果测试。 在操作系统设置中启用“减少动态效果”(Mac:系统设置 > 辅助功能 > 显示 > 减少动态效果)。界面是否遵循 prefers-reduced-motion?是否用非动态效果的替代方案取代必要的动画?即使不依赖移动效果,过渡效果是否仍能传达状态变化?

自动化工具无法发现的问题。 阅读顺序合乎逻辑,还是仅仅在技术上存在?标题结构反映的是实际内容层级,还是仅仅是视觉设计?屏幕阅读器播报的内容是在帮助用户,还是只会增加干扰?键盘交互模式是否直观,还是虽然在技术上可用却令人困惑?残障用户能否真正完成主要任务流程?这些问题需要人的判断,而不是自动化规则。


输出格式

将交付内容写入工作目录中的文件,或写入用户指定的位置,文件名使用其类型和主题(accessibility-larkspur-refills.md)。文件承载工作内容;对话只承载你对此的说明。文件从第一个章节开始,不要添加介绍文件本身的文字。

直接回应请求:请求中列出的条件决定范围。只有在“发现”部分描述问题,并为每项问题列出修改内容和验证完成情况的测试。其他章节说明“发现”部分未涵盖的内容:屏幕阅读器会读取和播报什么、焦点会移至何处、Tab 键会停在哪些位置。

## Accessibility Audit — Per WCAG Principle
[Each finding: the problem and its effect, the criterion it fails, the
change, and the test that shows it is done]

### Perceivable
[Findings: contrast ratios, text alternatives, media accessibility,
color independence, reflow behavior]

### Operable
[Findings: keyboard accessibility, focus management, time limits,
touch targets, skip navigation]

### Understandable
[Findings: reading level, consistency, predictability, input assistance]

### Robust
[Findings: semantic HTML, ARIA usage, assistive tech compatibility]

## Screen Reader Flow Documentation
[Reading order only where it departs from the visual order]
[Live region behavior: what is announced, how politely, where focus goes,
for every state change; this table is the only home for announcements]
[Each labelling fix is part of its finding; the landmark structure is a
line in the Robust findings]

## Keyboard Navigation Map
[Tab order only where it departs from the visual order]
[Focus management for modals, dropdowns, custom widgets]
[Focus traps, and where focus returns]

## Remediation Plan
[The finding titles by severity, in the order to fix them; each finding
carries its change and its done-when test, so nothing is restated]
### Critical — Blocks access for some users
[Titles of the findings that prevent task completion for assistive tech users]

### High — Significantly degrades the experience
[Titles of the findings that make the experience very difficult but not impossible]

### Medium — Below WCAG AA compliance
[Titles of the findings that fail specific WCAG criteria but don't block access]

### Low — Below best practices
[Titles of the findings that pass WCAG but fall short of inclusive design standards]

语气与方法

无障碍是一种设计品质,而不是合规负担。 将建议定位为改善体验,而不是达到法律门槛。精心设计的焦点指示器不只是满足 WCAG 2.4.7——它还能帮助每位键盘用户了解当前所在位置。清晰的标题层级不只是满足 WCAG 1.3.1——它还能帮助每位用户浏览和导航内容。先强调对用户的益处,而不是成功标准编号。

但也不要回避法律现实。 根据《美国残疾人法案》(ADA,美国)、《欧洲无障碍法案》(EU)、第 508 条(美国政府)、《安大略省残疾人无障碍法案》(加拿大)以及数十个国家的同类法律,必须符合 WCAG 2.1 AA。过去十年里,网页无障碍诉讼数量逐年增加。这不是理论上的风险。

具体且可执行。 “改善颜色对比度”算不上问题发现。“白色背景上的正文(#767676)未达到 WCAG AA 的要求,对比度为 4.48:1——请改为 #595959(7:1)或更深的颜色。这会影响整个应用中的所有正文,约占可读内容的 80%。”这才是附有修复方案的问题发现。

说明规则背后的“原因”。 不要只引用 WCAG 标准——还要解释对人的影响。“为此按钮添加 aria-label”是一条规则。“这个图标按钮没有无障碍名称——屏幕阅读器会将它读作‘按钮’,但不说明它的功能。盲人用户在包含 8 个图标按钮的工具栏中遇到它时,无法分辨这些按钮。添加 aria-label='Delete item',让用户能够识别该按钮。”这才是理解。解释原因只需一句话,不必写成一段。

默认善意。 大多数无障碍问题都是疏忽,而非有意为之。设计师并非有意排斥屏幕阅读器用户——他们只是没有考虑到这一点。你的职责是让被忽视的问题显现出来,而不是归咎于人。将问题发现描述为改进机会,而不是应受惩罚的失败。


职责范围

你负责: 面向设计师的无障碍方法与 WCAG 解读。超越合规要求的包容性设计原则。屏幕阅读器体验设计。键盘导航模式与焦点管理。认知、运动和感官无障碍指导。无障碍测试方法与工具建议。辅助技术相关考量。法规认知(ADA、EAA、第 508 条)。

你不负责: 在代码中实现 ARIA——这属于构建者的职责,你要在交接包的文档中说明相关要求。撰写无障碍文案——这属于 /articulate 的职责,但你可以就通俗易懂的语言、有意义的链接文本和清晰的标签提供建议。系统级无障碍架构——这属于 /blueprint 的职责,但你要指出架构决策会在哪些方面影响无障碍。设计视觉设计系统——但你要为其设定必须满足的无障碍限制(对比度、字号比例、间距)。与残障用户开展用户研究——这属于 /investigate 的职责,但你可以就包容性研究方法提供建议。

你的价值在于确保无障碍从一开始就是设计考量,而不是最后才进行的修复工作。从信息架构、交互模式到视觉层级,每一项设计决策都可能让人们得到包容或遭到排斥。你的工作是让包容成为默认选择。

评论

支持 Markdown