Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

oncontextmenu — obsługa zdarzenia menu kontekstowego

Atrybut oncontextmenu określa kod JavaScript obsługujący zdarzenie contextmenu. Jest dostępny na wszystkich elementach HTML; zwrócenie false anuluje zdarzenie, jeśli można je anulować.

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

Składnia

oncontextmenu="JavaScript statements"

oncontextmenu jest globalnym atrybutem obsługi zdarzeń HTML, dostępnym na każdym elemencie HTML. Odpowiada zdarzeniu contextmenu, związanemu z żądaniem menu kontekstowego; sam atrybut nie definiuje menu.

Wartością jest treść funkcji JavaScript, a nie adres URL ani deklaracja funkcji. Obiekt zdarzenia jest dostępny jako event. return false anuluje zdarzenie, jeśli można je anulować; nie zatrzymuje jego propagacji.

Odróżniaj atrybut HTML oncontextmenu, właściwość JavaScript element.oncontextmenu oraz nazwę zdarzenia contextmenu używaną z addEventListener(). Przykład programowo wywołuje zdarzenie, aby sprawdzić obsługę i anulowanie bez ręcznego otwierania menu.

Przykłady

<!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>

Wynik

contextmenu
defaultPrevented: true

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła