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

Dieses Verhalten unterscheidet sich von mousedown-Ereignissen. Bei der Verwendung einer physischen Maus werden mousedown-Ereignisse immer dann ausgelöst, wenn eine beliebige Taste einer Maus heruntergedrückt wird. pointerdown-Ereignisse werden nur beim ersten Drücken einer Taste ausgelöst; nachfolgende Tastenbetätigungen lösen keine pointerdown-Ereignisse aus.

Hinweis: Bei Touchscreen-Browsern, die direkte Manipulation zulassen, löst ein pointerdown-Ereignis eine implizite Zeigererfassung aus, was dazu führt, dass das Ziel alle nachfolgenden Zeigereignisse erfasst, als ob sie über dem erfassenden Ziel stattfänden. Demzufolge werden pointerover, pointerenter, pointerleave und pointerout nicht ausgelöst, solange diese Erfassung gesetzt ist. Die Erfassung kann manuell durch Aufruf von element.releasePointerCapture auf dem Zielelement aufgehoben werden, oder sie wird automatisch nach einem pointerup- oder pointercancel-Ereignis aufgehoben.

Syntax

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

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

onpointerdown = (event) => { }

Ereignistyp

Ein PointerEvent. Erbt von Event.

Ereigniseigenschaften

Diese Schnittstelle erbt Eigenschaften von MouseEvent und Event.

PointerEvent.altitudeAngle Schreibgeschützt Experimentell: Repräsentiert den Winkel zwischen der Achse eines Gebers (einem Zeiger oder Stift) und der X-Y-Ebene eines Geräte-Bildschirms.
PointerEvent.azimuthAngle Schreibgeschützt Experimentell: Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Gebers (einem 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 erzeugt.
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 des Zeigereingangs im Bereich von 0 bis 1, wobei 0 und 1 den minimalen bzw. maximalen Druck darstellen, den die Hardware zu erkennen vermag.
PointerEvent.tangentialPressure Schreibgeschützt: Der normalisierte tangentiale Druck des Zeigereingangs (auch als Fassdruck oder Zylinderstress bekannt) im Bereich von -1 bis 1, wobei 0 die Neutralposition des Reglers 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 Achse des Zeigers (z.B. einem Stiftstift) 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 Achse des Zeigers (z.B. einem Stiftstift) als auch die X-Achse enthält.
PointerEvent.twist Schreibgeschützt: Die Drehung im Uhrzeigersinn des Zeigers (z.B. einem Stiftstift) um seine Hauptachse in Grad, mit einem Wert im Bereich von 0 bis 359.
PointerEvent.pointerType Schreibgeschützt: Zeigt 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