CKTIS / HTML
commandfor: получател на командата на бутон
Свържете бутона с конкретен елемент, не CSS селектор или всички съвпадащи възли.
Версия: HTML Living Standard
Синтаксис
<button type="button" command="--mark" commandfor="first">Mark</button>Атрибутът commandfor съдържа ID на елемента, към който е насочена командата на бутона. Целта трябва да е в същото дърво. Запишете самото ID, не CSS селектор с начална решетка. DOM свойството commandForElement предоставя свързания елемент там, където функцията се поддържа. Липсваща или ненамерена цел не може да получи предвидената команда.
Атрибутът избира получател, а command задава операцията. Собствена операция създава CommandEvent, чиято команда и източник обозначават заявката и извикващия бутон. Приложението трябва да реализира собственото поведение. Използвайте изричен тип бутон без изпращане на формуляр и избягвайте повтарящи се ID, които правят връзката ненадеждна.
Сценарият има две възможни цели, но изпраща собствената заявка само към първата. Нейният обработчик маркира елемента и записва името на командата и изходния бутон; вторият обработчик не се използва. Chromium 145 потвърждава вграденото насочване. Неподдържащ браузър съобщава липсващата възможност, вместо да се преструва, че операцията е изпълнена.
Примери
<!doctype html><meta charset="utf-8">
<button id="send" type="button" command="--mark" commandfor="first">Mark</button>
<div id="first">First target</div><div id="second">Second target</div><output id="result"></output>
<script>
const send = document.querySelector('#send'); let second = false;
document.querySelector('#second').addEventListener('command', () => { second = true; });
document.querySelector('#first').addEventListener('command', event => {
event.currentTarget.dataset.marked = 'yes';
document.querySelector('#result').textContent = 'target=' + event.currentTarget.id + '; command=' + event.command + '; source=' + event.source.id + '; second=' + second;
});
if ('commandForElement' in send) send.click();
else document.querySelector('#result').textContent = 'commandfor unsupported; install an explicit event-routing fallback';
</script>Резултат
target=first; command=--mark; source=send; second=false
Истинският браузър проверява маркираната цел, низа на командата, изходния бутон и непроменената втора цел.