WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

oncontextmenu — Ereignisbehandlung für das Kontextmenü

Das Attribut oncontextmenu gibt JavaScript-Code zur Behandlung des contextmenu-Ereignisses an. Es ist für alle HTML-Elemente verfügbar; return false bricht das Ereignis ab, wenn es abbrechbar ist.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

oncontextmenu="JavaScript statements"

oncontextmenu ist ein globales HTML-Ereignisbehandlungsattribut, das für jedes HTML-Element verfügbar ist. Es entspricht dem Ereignis contextmenu, das mit einer Anfrage für ein Kontextmenü verbunden ist; das Attribut selbst definiert kein Menü.

Sein Wert ist der Inhalt einer JavaScript-Funktion, keine URL und keine Funktionsdeklaration. Das Ereignisobjekt ist als event verfügbar. return false bricht das Ereignis ab, wenn es abbrechbar ist; die Weitergabe des Ereignisses wird dadurch nicht gestoppt.

Unterscheide zwischen dem HTML-Attribut oncontextmenu, der JavaScript-Eigenschaft element.oncontextmenu und dem Ereignisnamen contextmenu, der mit addEventListener() verwendet wird. Das Beispiel löst ein Ereignis programmgesteuert aus, um die Behandlung und den Abbruch zu prüfen, ohne ein Menü manuell zu öffnen.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oncontextmenu example</title>
<button id="target" oncontextmenu="this.textContent = event.type; return false;">Context menu target</button>
<pre id="result"></pre>
<script>
  const target = document.getElementById('target');
  const testEvent = new Event('contextmenu', { cancelable: true });
  target.dispatchEvent(testEvent);
  document.getElementById('result').textContent =
    target.textContent + '\ndefaultPrevented: ' + testEvent.defaultPrevented;
</script>
</html>

Ergebnis

contextmenu
defaultPrevented: true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen