Element: pointerover-Ereignis
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2020.
Das pointerover
-Ereignis wird ausgelöst, wenn ein Zeigegerät in die Hit-Test-Grenzen eines Elements bewegt wird.
pointerover
-Ereignisse haben dieselben Probleme wie mouseover
. Wenn das Zielelement untergeordnete Elemente hat, werden pointerout
- und pointerover
-Ereignisse ausgelöst, während der Zeiger über die Grenzen dieser Elemente bewegt wird, nicht nur des Zielelements selbst. In der Regel ist das Verhalten von pointerenter
und pointerleave
sinnvoller, da sie nicht durch das Bewegen in untergeordnete Elemente beeinflusst werden.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder legen Sie eine Ereignis-Handler-Eigenschaft fest.
addEventListener("pointerover", (event) => { })
onpointerover = (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 Umsetzerachse (ein 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 Umsetzerachse (ein 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 (Magnitude auf der X-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.height
Schreibgeschützt-
Die Höhe (Magnitude auf der Y-Achse), in CSS-Pixeln, der Kontaktgeometrie des Zeigers.
PointerEvent.pressure
Schreibgeschützt-
Der normalisierte Druck des Zeigereingangs im Bereich von
0
bis1
, wobei0
und1
den minimalen und maximalen Druck darstellen, den die Hardware erkennen kann. PointerEvent.tangentialPressure
Schreibgeschützt-
Der normalisierte tangentiale Druck des Zeigereingangs (auch bekannt als Laufdruck oder Zylinderbelastung) im Bereich von
-1
bis1
, wobei0
die Neutralposition der Steuerung ist. PointerEvent.tiltX
Schreibgeschützt-
Der Ebenenwinkel (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
Schreibgeschützt-
Der Ebenenwinkel (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
Schreibgeschützt-
Die Drehung des Zeigers (z. B. Stift) im Uhrzeigersinn um seine Hauptachse in Grad, mit einem Wert im Bereich von
0
bis359
. PointerEvent.pointerType
Schreibgeschützt-
Gibt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Touch 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("pointerover", (event) => {
console.log("Pointer moved in");
});
Verwendung der onpointerover
-Ereignis-Handler-Eigenschaft:
const para = document.querySelector("p");
para.onpointerover = (event) => {
console.log("Pointer moved in");
};
Spezifikationen
Specification |
---|
Pointer Events # the-pointerover-event |
Pointer Events # dom-globaleventhandlers-onpointerover |
Browser-Kompatibilität
Loading…