Dascontextmenu-Ereignis wird ausgelöst, wenn der Benutzer versucht, ein Kontextmenü zu öffnen. Dieses Ereignis wird typischerweise durch Klicken der rechten Maustaste oder durch Drücken der Kontextmenütaste ausgelöst.

Im letzteren Fall wird das Kontextmenü unten links im fokussierten Element angezeigt, es sei denn, das Element ist ein Baum. In diesem Fall wird das Kontextmenü unten links in der aktuellen Zeile angezeigt.

Jedes Rechtsklick-Ereignis, das nicht deaktiviert wurde (durch Aufrufen derpreventDefault()-Methode des Klickevents), führt dazu, dass eincontextmenu-Ereignis auf das anvisierte Element ausgelöst wird.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wieaddEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

addEventListener("contextmenu", (event) => { })oncontextmenu = (event) => { }

Ereignistyp

EinPointerEvent. Erbt vonMouseEvent.

Ereigniseigenschaften

Diese Schnittstelle erbt Eigenschaften vonMouseEvent undEvent.

PointerEvent.altitudeAngleSchreibgeschütztExperimentell

Repräsentiert den Winkel zwischen einer Transducer-Achse (einem Zeiger oder Stylus) und der X-Y-Ebene eines Geräteschirms.

PointerEvent.azimuthAngleSchreibgeschütztExperimentell

Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Transducer-Achse (ein Zeiger oder Stylus) als auch die Y-Achse enthält.

PointerEvent.pointerIdSchreibgeschützt

Eine eindeutige Kennung für den Zeiger, der das Ereignis verursacht.

PointerEvent.widthSchreibgeschützt

Die Breite (Länge auf der X-Achse), in CSS-Pixel, der Kontaktfläche des Zeigers.

PointerEvent.heightSchreibgeschützt

Die Höhe (Länge auf der Y-Achse), in CSS-Pixel, der Kontaktfläche des Zeigers.

PointerEvent.pressureSchreibgeschützt

Der normalisierte Druck des Zeigereingangs im Bereich von0 bis1, wobei0 und1 den minimalen und maximalen Druck darstellen, den die Hardware erkennen kann.

PointerEvent.tangentialPressureSchreibgeschützt

Der normale tangentiale Druck des Zeigereingangs (auch bekannt als Barrel-Druck oderZylinderbelastung) im Bereich von-1 bis1, wobei0 die neutrale Position der Steuerung darstellt.

PointerEvent.tiltXSchreibgeschützt

Der Winkel in der Ebene (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.tiltYSchreibgeschützt

Der Winkel in der Ebene (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.twistSchreibgeschützt

Die Drehung des Zeigers (z.B. Stift) um seine Hauptachse im Uhrzeigersinn, in Grad, mit einem Wert im Bereich von0 bis359.

PointerEvent.pointerTypeSchreibgeschützt

Gibt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Berührung usw.).

PointerEvent.isPrimarySchreibgeschützt

Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.

Beispiele

Dascontextmenu-Ereignis abbrechen

In diesem Beispiel wird die Standardaktion descontextmenu-Ereignisses mitpreventDefault() abgebrochen, wenn dascontextmenu-Ereignis beim ersten Absatz ausgelöst wird. Infolgedessen wird der erste Absatz beim Rechtsklick nichts tun, während der zweite Absatz das standardmäßige Kontextmenü Ihres Browsers anzeigen wird.

HTML

<p>The context menu has been disabled on this paragraph.</p><p>But it has not been disabled on this one.</p>

JavaScript

const noContext = document.getElementById("noContextMenu");noContext.addEventListener("contextmenu", (e) => {  e.preventDefault();});

Ergebnis

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Lernen: Einführung in Ereignisse
• auxclick
• click
• dblclick
• mousedown
• mouseup
• pointerdown
• pointerup