CKTIS / HTML
oncommand — spracovanie udalosti command
Atribút oncommand určuje JavaScript, ktorý sa vykoná pri prijatí udalosti command. Patrí na prvok, ktorý prijíma príkaz; neurčuje cieľ ani sám príkaz nespúšťa.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
oncommand="JavaScript statements"oncommand je globálny obsahový atribút na obsluhu udalosti command, dostupný na prvkoch HTML. Jeho hodnotou je telo funkcie JavaScript, nie názov príkazu. Jeho náprotivku v DOM, element.oncommand, možno priradiť funkciu.
V mechanizme príkazov používa tlačidlo commandfor na určenie cieľového prvku a command na určenie akcie. Obsluhu oncommand umiestnite na cieľ, nie nevyhnutne na tlačidlo. Vlastné názvy príkazov sa začínajú na --; ich správanie implementuje kód autora.
V obsluhe obsahuje event.command príkaz a event.source označuje prvok, ktorý akciu vyvolal, s ohľadom na pravidlá presmerovania Shadow DOM. this odkazuje na prvok, ktorý udalosť obsluhuje. V príklade tlačidlo odošle --report a odsek nahradí svoj text touto hodnotou.
Príklad vyžaduje podporu príslušných funkcií v prehliadači a povolené inline skripty. Content Security Policy môže atribút obsluhy zablokovať; aplikácia môže namiesto toho zaregistrovať obsluhu pomocou addEventListener('command', handler) v povolenom skripte.
Prí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ýsledok
--report
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.