База знанияИзпитен център
BGБългарски
Избери език13

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

Истинският браузър проверява маркираната цел, низа на командата, изходния бутон и непроменената втора цел.

Източници