关于 threejs-accessibility
threejs-accessibility 指导改进 Three.js 体验的无障碍性,涵盖等效 HTML 控件、键盘操作、减少动态效果、状态反馈及无障碍测试。
主要功能
- 01为画布内容提供无障碍替代方式
- 02键盘操作与可见焦点
- 03支持减少动态效果及暂停控件
- 04加载、错误和设备回退状态
- 05无障碍测试指导
适用场景
- 01让 3D 配置器不依赖指针操作
- 02为 3D 图表提供文本等效内容
- 03为交互场景支持减少动态效果
- 04检查 WebGL 不可用时的行为
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ cesartevisual/ threejs-skills --skill threejs-accessibility安装后在 Claude Code 中输入/threejs-accessibility确认已加载。
详细介绍
无障碍 3D 体验
使用项目已安装的版本和现有架构。这些说明是对用户任务的补充;不授权进行无关更改或外部操作。
明确 3D 视图传达的信息和可执行的操作。装饰性场景可以对辅助技术隐藏;有意义的场景则需要提供无障碍名称/描述,以及获取关键信息的等效方式。
使用原生 HTML 按钮、输入框、列表和状态文本呈现有意义的操作,并确保它们与相同的应用状态同步。仅为画布添加标签,并不能让单个 3D 对象变得无障碍。对于配置器,在画布外呈现选项和选定值;对于图表,提供表格或文字摘要。
提供清晰可见的焦点、符合逻辑的 Tab 顺序,以及用于旋转/缩放/重置/选择的键盘替代操作,并提供退出交互捕获的方式。焦点位于查看器之外时,不要劫持页面按键。必要时,为仅限指针的拖动操作提供可完成任务的替代方式。
遵循 prefers-reduced-motion 及其设置变化。移除非必要的镜头移动、视差、自动旋转和闪烁;提供稳定状态和暂停控件。除颜色外,还要使用对比度、文字标签和形状传达信息。
提供实用的 HTML 加载、失败和设备不受支持提示。播报重要的状态变化,但不要播报每一帧或每次悬停。使用纯键盘、浏览器缩放、减少动态效果设置、可用时的屏幕阅读器,以及 WebGL 不可用等情况进行测试。明确说明未测试的辅助技术。
API 参考
请查阅官方文档,了解准确的签名和特定修订版本的行为。如果无法访问文档,请检查已安装的类型定义/源代码,并说明仍存在哪些不确定之处。
评论
支持 Markdown