Element: gotpointercapture-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2020 browserübergreifend verfügbar.
Das gotpointercapture-Ereignis wird ausgelöst, wenn ein Element mithilfe von setPointerCapture() einen Zeiger erfasst.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("gotpointercapture", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
ongotpointercapture = (event) => { }
Ereignistyp
Ein PointerEvent. Erbt von Event.
Beispiele
Dieses Beispiel ruft ein <p>-Element ab und lauscht auf das gotpointercapture-Ereignis. Bei einem pointerdown-Ereignis ruft es dann setPointerCapture() für das Element auf, wodurch gotpointercapture ausgelöst wird.
const para = document.querySelector("p");
para.addEventListener("gotpointercapture", () => {
console.log("I've been captured!");
});
para.addEventListener("pointerdown", (event) => {
para.setPointerCapture(event.pointerId);
});
Dasselbe Beispiel mit der Event-Handler-Eigenschaft ongotpointercapture (beachten Sie jedoch, dass dadurch gegebenenfalls andere mit ongotpointercapture hinzugefügte Event-Listener ersetzt werden):
const para = document.querySelector("p");
para.ongotpointercapture = () => {
console.log("I've been captured!");
};
para.addEventListener("pointerdown", (event) => {
para.setPointerCapture(event.pointerId);
});
Spezifikationen
| Spezifikation |
|---|
| Pointer Events # gotpointercapture |
| Pointer Events # dom-globaleventhandlers-ongotpointercapture |