pixijs-events— agent skill

Use this for pointer, mouse, touch, wheel, hover, click, drag, and hit testing.

Fast Path

sprite.eventMode = 'static';
sprite.cursor = 'pointer';
sprite.on('pointertap', () => select(sprite));

Rules

• v8 uses eventMode; replace interactive = true with eventMode = 'static' or 'dynamic'.
• Use passive for parents that should allow interactive descendants but not receive self hits.
• Set hitArea for predictable or cheaper hit testing.
• Use capture listeners only when you need ancestor-first handling.
• For drag, store pointer state, use global coordinates, and convert to the target parent space before setting position.
• Disable interactiveChildren on containers whose descendants should not be checked.

Deep Reads

• Full event modes, event types, propagation, drag, wheel, and hit-area examples: references/details.md
• Math and coordinate conversion: pixijs-math
• Graphics hit testing: pixijs-scene-graphics

Common Fixes

• Handler never fires: set eventMode, ensure visible/renderable ancestors, and check hitArea.
• Drag jumps: convert global pointer coordinates to the parent coordinate space.
• Too many hit tests: simplify hit areas or disable unused interactive descendants.