Skip to content

UIControl: touchdownrepeat event ​

The touchdownrepeat event fires when the user taps the control repeatedly in quick succession: once per press, from the second press on.

Syntax ​

addEventListener('touchdownrepeat', (event) => { })

Event object ​

The event object's type is UIControlTouchEvent. Besides type and target, it carries two read-only fields:

FieldTypeMeaning
locationCGPoint or nullThe finger's position, in this control's own coordinate system, in pt. null when fired by sendActionsForControlEvents()
tapCountnumberThe number of consecutive taps, counted in taps. 0 when fired by sendActionsForControlEvents()

The callback parameter is declared as Event; to read these two fields, cast it to UIControlTouchEvent, as shown in the example.

It cannot be canceled: cancelable is false, and preventDefault() has no effect.

When it fires ​

  • Fires once for the second and each later press, and touchdown fires as well. Not verified in the simulator.
  • The system decides how short an interval counts as "in succession".
  • Read which tap it is from the event object's tapCount. Not verified in the simulator.

Examples ​

js
const card = new UIControl();
card.addEventListener('touchdownrepeat', (e) => {
  const { tapCount } = /** @type {UIControlTouchEvent} */ (e);
  console.log('Repeat tap', tapCount);
});

Effect: Tapping card twice quickly prints Repeat tap 2 on the second press. Not verified in the simulator.

Corresponding iOS API ​

UIControlEventTouchDownRepeat. Natively it is registered with addTarget:action:forControlEvents:; here, use addEventListener().

See also ​