What problem does it solve?
PixiJS developers often struggle with why pointer events don’t fire, how to configure hit testing, and how to use propagation, capture, and global move events correctly in the federated event system.
Core Features & Use Cases
- Event-mode configuration: Choose the right
eventMode (none, passive, auto, static, dynamic) to control which objects participate in interaction.
- Correct event handling & propagation: Use
.on(), addEventListener, or property handlers, plus stopPropagation/capture-phase listeners to control how events bubble.
- Hit testing and interaction behavior: Tune
hitArea, interactiveChildren, and cursor behavior (including cursor styles) to get expected results, including drag via globalpointermove.
- Typical use cases: Buttons/UI clicks, drag-and-drop mechanics, global hover/drag tracking, and optimizing event-heavy scenes for performance.
Quick Start
Set your interactive object to eventMode = "static", assign an optional cursor, and listen for pointertap to handle clicks with event.global coordinates.
