Product media placeholder
Replace this area with a screenshot or short walkthrough video during the media sweep.
DOM pointer-event listener that emits a single-frame `pulse` per fire on `selector`, with click metadata fan-out — `value` (param-or-wired), `x` / `y` (clientX/Y), and `matchIndex` (which selector match fired). `pulse` is the only pulse-coupled signal; all metadata holds at the last-fire value between pulses, so consumers gate on the rising edge to read fresh data. `eventType` selects between `click` / `dblclick` / `pointerdown` / `contextmenu` / `auxclick` etc.
Type clickPulseCategory inputsContext sharedDynamic ports noCompound no
Inputs
| Port | Type | Description |
|---|---|---|
valueInput | float | Optional override for the `value` param. When wired (and finite), the pulse emits this value instead of the param. Use when the per-click value is computed by the graph (timestamp, current state, etc.). |
Outputs
| Port | Type | Description |
|---|---|---|
pulse | float | Single-frame rising-edge spike per fire. Held at 0 between fires — the ONLY pulse-coupled signal on this node. |
value | float | `valueInput` if wired (and finite at fire time), otherwise the static `value` param. Held at the last-fire value between pulses. |
x | float | clientX of the most-recent fire. Held at the last-fire value between pulses. |
y | float | clientY of the most-recent fire. Held at the last-fire value between pulses. |
matchIndex | float | Index of the matched element that fired (when selector matched multiple). Held between pulses so authors can branch on "which one fired last". |
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
selector | elementSelector | "" | CSS selector. Multiple matches all attach a listener; `matchIndex` reports which one fired. |
eventType | eventTypeChooser | "click" | DOM event name. Click is the default; pointerdown fires on press; contextmenu = right-click. Custom event names are also accepted via the trailing input. |
value | float | 0 | Scalar emitted on `value` output when `valueInput` is unwired. Use to embed a slide index / parameter delta into the click. |
preventDefault | bool | false | When true, the listener calls `e.preventDefault()`. Useful for `<a>` nav links that should NOT trigger browser navigation. |
Use cases
- Nav-link dispatch — one clickPulse per link with `value: <slideIndex>`. Sum the `value` outputs into `slideRouter.seekTo`.
- Button-driven state-machine triggers — click → pulse → SM parameter pulse.
- Cursor-aware reveals — read `x`/`y` to position a reveal centred on the click point.
- Multi-target dispatch — single clickPulse on `[data-tab]` (matches N tabs); read `matchIndex` to know which tab fired and route accordingly.
- Suppress-default nav — set `preventDefault: true` for hash-link / anchor-tag clicks that should NOT trigger browser navigation.
Related nodes
Envelope
Use clickPulse as the node type inside a graph node envelope. Add id, optional params, optional connections, and optional activeWhen based on the guide context.
Generated source
Registry faster-motion-docs/node-registry.jsonCategory page /help/faster-motion/faster-motion-node-category-inputs/