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 Zeiger aktiv wird. Bei der Maus wird es ausgelöst, wenn das Gerät von keinem gedrückten Knopf zu mindestens einem gedrückten Knopf wechselt. Bei Touch-Geräten wird es ausgelöst, wenn physischer Kontakt mit dem Digitizer hergestellt wird. Bei einem Stift wird es ausgelöst, wenn der Stylus physischen Kontakt mit dem Digitizer aufnimmt.

Dieses Verhalten unterscheidet sich von mousedown-Ereignissen. Bei der Verwendung einer physischen Maus werden mousedown-Ereignisse immer dann ausgelöst, wenn irgendein Knopf einer Maus gedrückt wird. pointerdown-Ereignisse werden nur beim ersten Knopfdruck ausgelöst; nachfolgende Knopfdrücke lösen keine pointerdown-Ereignisse aus.

Hinweis: Für Touchscreen-Browser, die direkte Manipulation erlauben, löst ein pointerdown-Ereignis eine implizite Zeigererfassung aus, was dazu führt, dass das Ziel alle nachfolgenden Zeigerereignisse erfasst, als ob sie über dem erfassenden Ziel auftreten würden. Dementsprechend werden pointerover, pointerenter, pointerleave und pointerout nicht ausgelöst, solange diese Erfassung eingestellt ist. Die Erfassung kann manuell durch den Aufruf von element.releasePointerCapture auf dem Zielelement freigegeben werden oder sie wird implizit nach einem pointerup- oder pointercancel-Ereignis freigegeben.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-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: Stellt den Winkel zwischen einer Transducer-Achse (einem Zeiger oder Stylus) und der X-Y-Ebene eines Geräteschirms dar.
PointerEvent.azimuthAngle Schreibgeschützt Experimentell: Stellt den Winkel zwischen der Y-Z-Ebene und der Ebene dar, die sowohl die Transducer-Achse (einem Zeiger oder Stylus) 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 der Zeigereingabe im Bereich von 0 bis 1, wobei 0 und 1 den minimalen und maximalen Druck, den die Hardware erkennen kann, darstellen.
PointerEvent.tangentialPressure Schreibgeschützt: Der normalisierte tangentiale Druck der Zeigereingabe (auch bekannt als Fassdruck oder Zylinderstress) im Bereich -1 bis 1, wobei 0 die neutrale Position der Steuerung ist.
PointerEvent.tiltX Schreibgeschützt: Der Winkel zur Ebene (in Grad, im Bereich von -90 bis 90) zwischen der Y–Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. Stiftstylus) als auch die Y-Achse enthält.
PointerEvent.tiltY Schreibgeschützt: Der Winkel zur Ebene (in Grad, im Bereich von -90 bis 90) zwischen der X–Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. Stiftstylus) als auch die X-Achse enthält.
PointerEvent.twist Schreibgeschützt: Die Drehung des Zeigers (z.B. Stiftstylus) im Uhrzeigersinn um seine Hauptachse in Grad, mit einem Wert im Bereich 0 bis 359.
PointerEvent.pointerType Schreibgeschützt: Gibt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Touch, etc.).
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-Ereignishandler-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