用途:在 Coinbase Design System(CDS)界面写完后做无障碍审查,确认命名、状态、角色和播报与 CDS 支持的一致,而非充当通用 WCAG/ARIA 手册。
主要能力:针对 React Native 核对 accessibilityLabel、accessibilityHint、accessibilityState、accessibilityRole 等 CDS 组件文档所列属性;针对 Web 核对 aria-*、as、role、标签与字段连接是否符合 CDS Web 组件 API;检查表单校验、错误与实时区域是否按 CDS 表单模式关联;检查图标、图片的装饰性与有意义内容处理;核对 Text 的 as(Web)与 accessibilityRole(React Native)与标题语义是否匹配;对焦点受管组件(如 Modal、Tray、Tooltip 等文档定义了焦点行为的组件)核对打开落焦、Tab 循环、关闭焦点恢复与可关闭按键。组件选择上,应选用文档覆盖所需无障碍行为的最小 CDS 组件;文档已规定组合组件时不应以通用 ARIA 或临时模式替代。
使用方式:先确定代码为 Web 还是移动端,用 cds-docs 技能加载对应平台的当前官方 CDS 组件文档(官方文档站点为 cds.coinbase.com),阅读属性表及 Accessibility、ARIA、屏幕阅读器等说明,再按作用域、文档拉取、组件选择、属性核对、焦点管理、验证、最终清单的顺序执行。cds-docs 为必需前置,若未安装需告知用户并仅基于代码可核实内容继续,标注未能对照文档确认之处。cds-code 负责布局、令牌、导入与视觉校验,本技能只补充无障碍消费与组件选择审查。
适用场景:CDS 界面的无障碍复核,尤其涉及表单、弹层、列表、图标与标题语义时。
限制:不用于无设计系统组件的非 CDS 页面;不得凭第三方博客猜测 aria-* 或 RN 属性名;CDS 文档未定义的行为不应自行发明完整自定义控件规范;若流程要求 VoiceOver、TalkBack 等设备或人工验证,需明确已满足或仍待处理。具体平台支持范围与 CDS 版本要求暂未提供。