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

CKTIS / HTML

oncommand — zpracování události command

Atribut oncommand určuje JavaScript, který se spustí při přijetí události command. Patří na prvek, který příkaz přijímá; neurčuje cíl ani sám příkaz nespouští.

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

Syntaxe

oncommand="JavaScript statements"

oncommand je globální obsahový atribut pro obsluhu události command, dostupný na prvcích HTML. Jeho hodnotou je tělo funkce JavaScript, nikoli název příkazu. Jeho protějšku v DOM, element.oncommand, lze přiřadit funkci.

V mechanismu příkazů používá tlačítko commandfor k určení cílového prvku a command k určení akce. Obsluhu oncommand umístěte na cíl, ne nutně na tlačítko. Vlastní názvy příkazů začínají na --; jejich chování implementuje kód autora.

V obsluze obsahuje event.command příkaz a event.source označuje prvek, který akci vyvolal, s ohledem na pravidla přesměrování Shadow DOM. this odkazuje na prvek, který událost obsluhuje. V příkladu tlačítko odešle --report a odstavec nahradí svůj text touto hodnotou.

Příklad vyžaduje podporu příslušných funkcí v prohlížeči a povolené inline skripty. Content Security Policy může atribut obsluhy zablokovat; aplikace může místo toho zaregistrovat obsluhu pomocí addEventListener('command', handler) v povoleném skriptu.

Příklady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oncommand example</title>
<button type="button" commandfor="target" command="--report">Run</button>
<p id="target" oncommand="if (event.command === '--report') this.textContent = event.command;">Ready</p>
</html>

Výsledek

--report

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