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 Zeigegerät aktiv wird. Bei der Maus wird es ausgelöst, wenn das Gerät von keinem gedrückten zu mindestens einem gedrückten Knopf wechselt. 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 aufnimmt.
Hinweis: Bei Browsern mit Touchscreen, die direkte Manipulation zulassen, löst ein pointerdown
-Ereignis eine implizite Zeigererfassung aus, wodurch das Ziel alle nachfolgenden Zeigerereignisse erfasst, als würden sie über dem erfassenden Ziel auftreten. Dementsprechend werden pointerover
, pointerenter
, pointerleave
und pointerout
nicht ausgelöst, solange diese Erfassung eingestellt ist. Die Erfassung kann manuell durch Aufruf von element.releasePointerCapture
auf dem Zielelement aufgehoben werden, oder sie wird nach einem pointerup
- oder pointercancel
-Ereignis automatisch 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
Nur lesbar Experimentell-
Repräsentiert den Winkel zwischen einer Transducer-Achse (einem Zeiger oder Stift) und der X-Y-Ebene eines Geräts.
PointerEvent.azimuthAngle
Nur lesbar Experimentell-
Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Transducer-Achse (einen Zeiger oder Stift) als auch die Y-Achse enthält.
PointerEvent.persistentDeviceId
Nur lesbar Experimentell-
Eine eindeutige Kennung für das Zeigegerät, das das
PointerEvent
erzeugt. PointerEvent.pointerId
Nur lesbar-
Eine eindeutige Kennung für den Zeiger, der das Ereignis verursacht.
PointerEvent.width
Nur lesbar-
Die Breite (Stärke auf der X-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.height
Nur lesbar-
Die Höhe (Stärke auf der Y-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.pressure
Nur lesbar-
Der normalisierte Druck des Zeigereingangs im Bereich von
0
bis1
, wobei0
und1
jeweils den minimalen und maximalen Druck darstellen, den die Hardware erkennen kann. PointerEvent.tangentialPressure
Nur lesbar-
Der normalisierte Tangentialdruck des Zeigereingangs (auch als Barreldruck oder Zylinderbelastung bekannt) im Bereich von
-1
bis1
, wobei0
die Neutralposition der Steuerung ist. PointerEvent.tiltX
Nur lesbar-
Der Winkelebene (in Grad, im Bereich von
-90
bis90
) zwischen der Y-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. Stift) als auch die Y-Achse enthält. PointerEvent.tiltY
Nur lesbar-
Der Winkelebene (in Grad, im Bereich von
-90
bis90
) zwischen der X-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z.B. Stift) als auch die X-Achse enthält. PointerEvent.twist
Nur lesbar-
Die Drehung im Uhrzeigersinn des Zeigers (z.B. Stift) um seine Hauptachse in Grad, mit einem Wert im Bereich von
0
bis359
. PointerEvent.pointerType
Nur lesbar-
Gibt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Berührung usw.).
PointerEvent.isPrimary
Nur lesbar-
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
BCD tables only load in the browser