Element: pointerenter 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 pointerenter
-Ereignis wird ausgelöst, wenn ein Zeigegerät in die Berührungsgrenzen eines Elements oder eines seiner Nachfahren bewegt wird, einschließlich als Ergebnis eines pointerdown
-Ereignisses von einem Gerät, das Hover nicht unterstützt (siehe pointerdown
).
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
, oder setzen Sie eine Ereignishandlereigenschaft.
addEventListener("pointerenter", (event) => {});
onpointerenter = (event) => {};
Ereignistyp
Ein PointerEvent
. Erbt von Event
.
Ereigniseigenschaften
Dieses Interface erbt Eigenschaften von MouseEvent
und Event
.
PointerEvent.altitudeAngle
Schreibgeschützt Experimentell-
Repräsentiert den Winkel zwischen einer Achse eines Wandlers (einem Zeiger oder Stylus) und der X-Y-Ebene eines Geräteschirms.
PointerEvent.azimuthAngle
Schreibgeschützt Experimentell-
Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Wandlers (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 (Ausdehnung auf der X-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.height
Schreibgeschützt-
Die Höhe (Ausdehnung auf der Y-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.pressure
Schreibgeschützt-
Der normalisierte Druck der Zeigereingabe im Bereich von
0
bis1
, wobei0
und1
den minimalen bzw. maximalen Druck repräsentieren, den die Hardware erkennen kann. PointerEvent.tangentialPressure
Schreibgeschützt-
Der normalisierte tangentiale Druck der Zeigereingabe (auch bekannt als Barrel-Druck oder Zylinderbelastung) im Bereich von
-1
bis1
, wobei0
die neutrale Position des Steuerungselements darstellt. PointerEvent.tiltX
Schreibgeschützt-
Der Winkel (in Grad, im Bereich von
-90
bis90
) zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z.B. Pen-Stylus) als auch die Y-Achse enthält. PointerEvent.tiltY
Schreibgeschützt-
Der Winkel (in Grad, im Bereich von
-90
bis90
) zwischen der X-Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z.B. Pen-Stylus) als auch die X-Achse enthält. PointerEvent.twist
Schreibgeschützt-
Die Drehung des Zeigers (z.B. Pen-Stylus) im Uhrzeigersinn um seine Hauptachse in Grad, mit einem Wert im Bereich von
0
bis359
. PointerEvent.pointerType
Schreibgeschützt-
Zeigt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Berührung, 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("pointerenter", (event) => {
console.log("Pointer entered element");
});
Verwendung der onpointerenter
-Ereignishandlereigenschaft:
const para = document.querySelector("p");
para.onpointerenter = (event) => {
console.log("Pointer entered element");
};
Spezifikationen
Specification |
---|
Pointer Events # the-pointerenter-event |
Pointer Events # dom-globaleventhandlers-onpointerenter |
Browser-Kompatibilität
BCD tables only load in the browser