Element: pointerdown event

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.

Das pointerdown Event wird ausgelöst, wenn ein Zeigegerät aktiv wird. Bei der Maus wird es ausgelöst, wenn der Übergang von keinen gedrückten Tasten zu mindestens einer gedrückten Taste erfolgt. Bei Berührung wird es ausgelöst, wenn physischer Kontakt mit dem Digitalisierer hergestellt wird. Beim Stift wird es ausgelöst, wenn der Stift physischen Kontakt mit dem Digitalisierer herstellt.

Dieses Verhalten unterscheidet sich von mousedown Events. Bei der Verwendung einer physischen Maus werden mousedown Events jedes Mal ausgelöst, wenn eine Taste einer Maus gedrückt wird. pointerdown Events werden nur beim ersten Tastendruck ausgelöst; nachfolgende Tastendrücke lösen keine pointerdown Events aus.

Hinweis: Bei Touchscreen-Browsern, die direkte Manipulation ermöglichen, löst ein pointerdown Event eine implizite Zeigererfassung aus, wodurch das Ziel alle nachfolgenden Zeigereignisse erfasst, als ob sie über das erfassende Ziel auftreten würden. Folglich werden pointerover, pointerenter, pointerleave und pointerout nicht ausgelöst, solange diese Erfassung aktiv ist. Die Erfassung kann manuell aufgehoben werden, indem element.releasePointerCapture auf das Ziel-Element angewandt wird, oder sie wird implizit nach einem pointerup oder pointercancel Event aufgehoben.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

addEventListener("pointerdown", (event) => { })

onpointerdown = (event) => { }

Eventtyp

Ein PointerEvent. Erbt von Event.

Ereigniseigenschaften

Diese Schnittstelle erbt Eigenschaften von MouseEvent und Event.

PointerEvent.altitudeAngle Schreibgeschützt Experimentell: Stellt den Winkel zwischen einer Transducer-Achse (einem Zeiger oder Stift) und der X-Y-Ebene eines Geräts dar.
PointerEvent.azimuthAngle Schreibgeschützt Experimentell: Stellt den Winkel zwischen der Y-Z-Ebene und der Ebene dar, die sowohl die Transducer-Achse (ein Zeiger oder Stift) als auch die Y-Achse enthält.
PointerEvent.persistentDeviceId Schreibgeschützt Experimentell: Eine einzigartige Kennung für das Zeigegerät, das das PointerEvent erzeugt.
PointerEvent.pointerId Schreibgeschützt: Eine einzigartige Kennung für den Zeiger, der das Ereignis verursacht.
PointerEvent.width Schreibgeschützt: Die Breite (Magnitude auf der X-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.height Schreibgeschützt: Die Höhe (Magnitude auf der Y-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.pressure Schreibgeschützt: Der normalisierte Druck des Zeigereingangs im Bereich von 0 bis 1, wobei 0 und 1 den minimalen bzw. maximalen Druck darstellen, den die Hardware erkennen kann.
PointerEvent.tangentialPressure Schreibgeschützt: Der normalisierte tangentiale Druck des Zeigereingangs (auch bekannt als Barrel-Druck oder Zylinderbelastung) im Bereich von -1 bis 1, wobei 0 die Neutralstellung der Kontrolle ist.
PointerEvent.tiltX Schreibgeschützt: Der Winkel der Ebene (in Grad, im Bereich von -90 bis 90) zwischen der Y–Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. Stift) als auch die Y-Achse enthält.
PointerEvent.tiltY Schreibgeschützt: Der Winkel der Ebene (in Grad, im Bereich von -90 bis 90) zwischen der X–Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. Stift) als auch die X-Achse enthält.
PointerEvent.twist Schreibgeschützt: Die Drehung des Zeigers (z.B. Stift) im Uhrzeigersinn um seine Hauptachse in Grad, mit einem Wert im Bereich von 0 bis 359.
PointerEvent.pointerType Schreibgeschützt: Gibt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Berührung usw.).
PointerEvent.isPrimary Schreibgeschützt: Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.

Beispiele

Verwendung von addEventListener():

const para = document.querySelector("p");

para.addEventListener("pointerdown", (event) => {
  console.log("Pointer down event");
});

Verwendung der onpointerdown Ereignis-Handler-Eigenschaft:

const para = document.querySelector("p");

para.onpointerdown = (event) => {
  console.log("Pointer down event");
};

Spezifikationen

Specification
Pointer Events # the-pointerdown-event
Pointer Events # dom-globaleventhandlers-onpointerdown

Browser-Kompatibilität

Siehe auch

Verwandte Ereignisse