Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

oncommand — obravnava dogodka command

Atribut oncommand določa JavaScript, ki se izvede ob prejemu dogodka command. Namesti se na element, ki prejme ukaz; ne izbere cilja in sam ne sproži ukaza.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

oncommand="JavaScript statements"

oncommand je globalni vsebinski atribut za obravnavo dogodka command, ki je na voljo na elementih HTML. Njegova vrednost je telo funkcije JavaScript, ne ime ukaza. Njegovemu DOM-ekvivalentu element.oncommand je mogoče dodeliti funkcijo.

V mehanizmu ukazov gumb uporabi commandfor za določitev ciljnega elementa in command za določitev dejanja. Obdelovalnik oncommand namesti na cilj, ne nujno na gumb. Imena ukazov po meri se začnejo z --; njihovo vedenje določa koda avtorja.

V obdelovalniku event.command vsebuje ukaz, event.source pa označuje element, ki je sprožil dejanje, ob upoštevanju pravil preusmerjanja Shadow DOM. this se nanaša na element, ki obravnava dogodek. V primeru gumb pošlje --report, odstavek pa svoje besedilo nadomesti s to vrednostjo.

Primer zahteva podporo ustreznih funkcij v brskalniku in dovoljenje za izvajanje vdelanih skriptov. Content Security Policy lahko blokira atribut obdelovalnika; aplikacija lahko namesto tega registrira obdelovalnik z addEventListener('command', handler) v dovoljenem skriptu.

Primeri

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

Rezultat

--report

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri