Element: pointerdown-Ereignis

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-Ereignis wird ausgelöst, wenn ein Zeiger aktiv wird. Bei einer Maus wird es ausgelöst, wenn das Gerät von keinem gedrückten Knopf zu mindestens einem gedrückten Knopf übergeht. Bei Berührung wird es ausgelöst, wenn physischer Kontakt mit dem Digitalisierer erfolgt. Bei einem Stift wird es ausgelöst, wenn der Stift physischen Kontakt mit dem Digitalisierer herstellt.

Dieses Verhalten unterscheidet sich von mousedown-Ereignissen. Beim Einsatz einer physischen Maus werden mousedown-Ereignisse jedes Mal ausgelöst, wenn irgendeine Taste einer Maus gedrückt wird. pointerdown-Ereignisse hingegen werden nur beim ersten Tastendruck ausgelöst; nachfolgende Tastendrücke lösen keine pointerdown-Ereignisse aus.

Hinweis: Für Touchscreen-Browser, die direkte Manipulation unterstützen, löst ein pointerdown-Ereignis eine implizite Zeigererfassung aus. Dies führt dazu, dass das Ziel alle nachfolgenden Zeigerereignisse erfasst, als würden sie über dem erfassten Ziel auftreten. Dementsprechend werden pointerover, pointerenter, pointerleave und pointerout nicht ausgelöst, solange diese Erfassung aktiv ist. Die Erfassung kann manuell durch Aufruf von element.releasePointerCapture am Ziel-Element aufgehoben werden oder wird implizit nach einem pointerup- oder pointercancel-Ereignis zurückgesetzt.

Syntax

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

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

onpointerdown = (event) => {};

Ereignistyp

Ereigniseigenschaften

Diese Schnittstelle erbt Eigenschaften von MouseEvent und Event.

PointerEvent.altitudeAngle Schreibgeschützt Experimentell

Stellt den Winkel zwischen der Achse eines Transducers (z. B. 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 (z. B. Zeiger oder Stift) als auch die Y-Achse enthält.

PointerEvent.persistentDeviceId Schreibgeschützt Experimentell

Eine eindeutige Kennung für das Zeigegerät, das das PointerEvent generiert.

PointerEvent.pointerId Schreibgeschützt

Eine eindeutige Kennung für den Zeiger, der das Ereignis verursacht.

PointerEvent.width Schreibgeschützt

Die Breite (Größe auf der X-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.

PointerEvent.height Schreibgeschützt

Die Höhe (Größe auf der Y-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.

PointerEvent.pressure Schreibgeschützt

Der normalisierte Druck der Zeigereingabe 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 der Zeigereingabe (auch bekannt als Fassdruck oder Zylinderstress) im Bereich von -1 bis 1, wobei 0 die neutrale Position der Steuerung darstellt.

PointerEvent.tiltX Schreibgeschützt

Der Flugwinkel (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 Flugwinkel (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) um seine Hauptachse im Uhrzeigersinn 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 (z. B. Maus, Stift, Berührung).

PointerEvent.isPrimary Schreibgeschützt

Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.

Beispiele

Verwendung von addEventListener():

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

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

Verwendung der onpointerdown-Ereignis-Handler-Eigenschaft:

js
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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
pointerdown event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Requires a vendor prefix or different name for use.
Has more compatibility info.

Siehe auch