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.