Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła