SuperAPI AI 工具集

pixijs-accessibility

测试与质量

查看项目

更新于 10-16 08:06

技能介绍

用途:在 PixiJS v8 应用中通过 AccessibilitySystem 添加屏幕阅读器与键盘导航支持。该系统会在可访问容器上叠加不可见的 shadow DOM 层,供辅助技术发现并激活。

主要能力:容器可设置 accessible、accessibleTitle(title 属性)、accessibleHint(aria-label)、accessibleText、accessibleType(默认 button)、tabIndex、accessibleChildren、accessiblePointerEvents;可用 tabIndex 自定义遍历顺序;可通过 app.renderer.accessibility.setAccessibilityEnabled(true) 运行时启用,或用 isActive、isMobileAccessibility 查询状态;也可在 init 的 accessibilityOptions 中配置 enabledByDefault、debug、activateOnTab、deactivateOnMouseMove,或预先修改 AccessibilitySystem.defaultOptions。

使用方式:给 Sprite 或容器设置 accessible=true、accessibleTitle、eventMode='static'、tabIndex,加入舞台后启用无障碍;激活 shadow div 时会派发 click、pointertap、tap 事件,聚焦派发 mouseover,失焦派发 mouseout。

限制与注意:默认仅在用户按 Tab 后激活,移动端通过隐藏 touch hook 激活;依赖主线程,Web Worker 中不可用;tabIndex 仅在 eventMode 为 static 或 dynamic 时生效;自定义构建 skipExtensionImports:true 时需显式 import 'pixi.js/accessibility';默认 deactivateOnMouseMove 为 true,鼠标移动会停用。资料未提供收费、价格等信息。