Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

oncontextmenu — obsluha události kontextové nabídky

Atribut oncontextmenu určuje kód JavaScriptu, který obsluhuje událost contextmenu. Je dostupný na všech prvcích HTML; vrácení false událost zruší, pokud ji lze zrušit.

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

Syntaxe

oncontextmenu="JavaScript statements"

oncontextmenu je globální atribut HTML pro obsluhu událostí, dostupný na každém prvku HTML. Odpovídá události contextmenu, která souvisí s požadavkem na kontextovou nabídku; samotný atribut žádnou nabídku nedefinuje.

Jeho hodnotou je tělo funkce JavaScriptu, nikoli URL nebo deklarace funkce. Objekt události je dostupný jako event. return false událost zruší, pokud ji lze zrušit; nezastaví její šíření.

Rozlišuj atribut HTML oncontextmenu, vlastnost JavaScriptu element.oncontextmenu a název události contextmenu používaný s addEventListener(). Příklad programově vyvolá událost, aby ověřil její obsluhu a zrušení, aniž by bylo nutné ručně otevřít nabídku.

Příklady

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

Výsledek

contextmenu
defaultPrevented: true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje