CKTIS / HTML
oncommand — obsługa zdarzenia command
Atrybut oncommand określa kod JavaScript wykonywany po odebraniu zdarzenia command. Umieszcza się go na elemencie odbierającym polecenie; nie wskazuje on celu ani sam nie uruchamia polecenia.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
oncommand="JavaScript statements"oncommand to globalny atrybut obsługi zdarzenia command, dostępny na elementach HTML. Jego wartością jest treść funkcji JavaScript, a nie nazwa polecenia. Odpowiada mu właściwość DOM element.oncommand, której można przypisać funkcję.
W mechanizmie poleceń przycisk używa commandfor, aby wskazać element docelowy, oraz command, aby określić działanie. Handler oncommand należy umieścić na celu, niekoniecznie na przycisku. Nazwy własnych poleceń zaczynają się od --; ich działanie implementuje kod autora.
W handlerze event.command zawiera polecenie, a event.source wskazuje element inicjujący, z uwzględnieniem reguł przekierowania celu w Shadow DOM. this oznacza element obsługujący zdarzenie. W przykładzie przycisk wysyła --report, a akapit zastępuje swój tekst tą wartością.
Przykład wymaga obsługi odpowiednich funkcji przez przeglądarkę oraz zezwolenia na skrypty inline. Content Security Policy może zablokować atrybut obsługi; w aplikacji można zamiast niego rejestrować handler przez addEventListener('command', handler) w dozwolonym skrypcie.
Przykłady
<!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>Wynik
--report
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.