CKTIS / HTML
oncommand — обработване на събитието command
Атрибутът oncommand задава JavaScript, който се изпълнява при получаване на събитие command. Поставя се върху елемента, който получава командата; не избира целта и сам по себе си не задейства команда.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
oncommand="JavaScript statements"oncommand е глобален атрибут за обработчик на събитието command, наличен за HTML елементите. Стойността му е тяло на JavaScript функция, а не име на команда. На DOM съответствието му element.oncommand може да бъде присвоена функция.
В механизма за команди бутонът използва commandfor, за да посочи целевия елемент, и command, за да зададе действието. Поставете обработчика oncommand върху целта, не непременно върху бутона. Имената на потребителските команди започват с --; поведението им се реализира от кода на автора.
В обработчика event.command съдържа командата, а event.source указва елемента, който е инициирал действието, съобразно правилата за пренасочване на Shadow DOM. this се отнася до елемента, който обработва събитието. В примера бутонът изпраща --report, а абзацът заменя текста си с тази стойност.
Примерът изисква браузърът да поддържа съответните функции и да е разрешено изпълнението на вградени скриптове. Content Security Policy може да блокира атрибута на обработчика; вместо това приложение може да регистрира обработчик чрез addEventListener('command', handler) в разрешен скрипт.
Примери
<!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>Резултат
--report
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.