SuperAPI AI 工具集

pixijs-events

通用与其它

查看项目

更新于 10-16 03:42

技能介绍

用途:在 PixiJS v8 中处理指针、鼠标、触摸与滚轮输入。其联邦事件系统在场景图上模拟 DOM 事件。

主要能力:eventMode 支持 none、passive、auto、static、dynamic;默认 passive 表示对象自身不接收事件,需显式设为 static 或 dynamic 才能监听。事件类型包括指针事件(pointerdown、pointerup、pointerupoutside、pointermove、pointerover、pointerout、pointerenter、pointerleave、pointertap、pointercancel)、鼠标事件(含 click、rightdown、contextmenu、wheel 等)、触摸事件与全局移动事件(globalpointermove、globalmousemove、globaltouchmove)。支持 on/once/off、addEventListener 与 onclick 属性式监听,支持 capture 捕获阶段、stopPropagation 与 stopImmediatePropagation。命中测试遵循 eventMode、interactiveChildren、hitArea 与可见性规则,可用 Rectangle、Circle、Polygon 或自定义 contains 覆盖。FederatedPointerEvent 提供 global、client、target、pointerType、pointerId、pressure、button 及修饰键等字段,FederatedWheelEvent 增加 delta 字段。

用法要点:设置 eventMode 后使用 .on() 监听;拖拽用 globalpointermove,因 pointermove 仅在指针位于对象上时触发;按钮用 static,静止光标下移动的对象才用 dynamic;可通过 app.init 的 eventFeatures 或 app.renderer.events.features 关闭未用事件类别。

限制与常见错误:buttonMode 已在 v8 移除,改用 cursor='pointer';interactive=true 仍可用但不推荐;cursor 不继承,需逐个交互子对象设置;contextmenu 需在监听中调用 event.preventDefault() 才能阻止浏览器菜单;offset 属性当前不支持;persistentDeviceId 恒为 0。性能上可将非交互子树设为 none 或把容器 interactiveChildren 设为 false。相关技能包括 pixijs-accessibility、pixijs-scene-dom-container、pixijs-performance。