SuperAPI AI 工具集

accessibility

编程与开发

查看项目

更新于 10-16 03:44

技能介绍

用途:适用于任何引入或修改交互式 UI 的 VS Code/Positron 功能开发,新增功能时默认使用,即使需求未提及无障碍。新增面板、视图、控件、编辑器覆盖层、对话框等可聚焦交互组件时,需提供三项无障碍组件(若尚不存在):无障碍帮助对话框、可访问视图(面向屏幕阅读器用户的纯文本只读编辑器)、无障碍详细度设置。更新既有功能时,也必须更新其帮助对话框(provideContent())以记录新功能,因为屏幕阅读器用户依赖它发现操作。

主要能力与用法: 1)无障碍帮助对话框:实现 IAccessibleViewImplementation(type=AccessibleViewType.Help),设置 priority 与 when 上下文键,getProvider 返回 AccessibleContentProvider,provideContent() 返回本地化多行帮助文本,onClose() 恢复原焦点,实现类在 .contribution.ts 中通过 AccessibleViewRegistry.register(...) 注册。 2)可访问视图:type=AccessibleViewType.View,提供纯文本内容,可选 provideNextContent()/providePreviousContent() 与操作,同样需注册。 3)详细度设置:在 AccessibilityVerbositySettingId 中新增条目,并在同文件 configuration.properties 中注册,description 用 localize,配合 ...baseVerbosityProperty(boolean,默认 true,tags:['accessibility'])。 4)无障碍信号:使用 IAccessibilitySignalService.playSignal(AccessibilitySignal.),信号含声音与播报两种模式,需沿用已有信号,新增信号须先与 @meganrogge 协调。 5)ARIA 提示与状态:用 aria.ts 的 alert()(role=alert,紧急、打断)与 status()(aria-live=polite,非紧急、排队),优先 status(),消息需本地化且不重复。 6)键盘导航:Tab 顺序、方向键导航、焦点可见、无鼠标独占交互、Escape 关闭、模态焦点陷阱。 7)ARIA 标签与角色:无可见文本控件加本地化 aria-label,可用 aria-labelledby/aria-describedby,自定义控件声明 role 与 aria-expanded/aria-selected/aria-checked,装饰元素设 aria-hidden="true",虚拟化列表用 aria-setsize/aria-posinset。

限制:资料未提供该技能的安装命令、平台范围或收费信息。帮助文本需用 nls.localize(),键位用 keybinding:commandId 语法。