Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

commandfor: odbiorca polecenia przycisku

Połącz przycisk z konkretnym elementem, a nie selektorem CSS lub wszystkimi pasującymi węzłami.

Wersja: HTML Living Standard

Składnia

<button type="button" command="--mark" commandfor="first">Mark</button>

Atrybut commandfor zawiera identyfikator elementu będącego celem polecenia przycisku. Cel musi należeć do tego samego drzewa. Wpisz sam identyfikator, nie selektor CSS z początkowym krzyżykiem. Właściwość DOM commandForElement udostępnia powiązany element, jeśli funkcja jest obsługiwana. Brak lub nierozwiązany cel uniemożliwia dostarczenie zamierzonego polecenia.

Atrybut wybiera odbiorcę, a command określa operację. Własna operacja tworzy CommandEvent, którego polecenie i źródło identyfikują żądanie oraz wywołujący przycisk. Kod aplikacji musi zaimplementować to działanie. Użyj jawnego typu przycisku niewysyłającego formularza i unikaj powielonych identyfikatorów, które czynią powiązanie niepewnym.

Scenariusz ma dwa potencjalne cele, ale wysyła własne żądanie tylko do pierwszego. Obsługa zdarzenia oznacza ten element i zapisuje nazwę polecenia oraz przycisk źródłowy; drugi odbiorca pozostaje niewykorzystany. Chromium 145 potwierdza natywne kierowanie zdarzenia. Nieobsługująca przeglądarka zgłasza brak funkcji zamiast udawać wykonanie operacji.

Przykłady

<!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>

Wynik

target=first; command=--mark; source=send; second=false

Prawdziwa przeglądarka sprawdza oznaczony cel, nazwę polecenia, przycisk źródłowy oraz niezmieniony drugi element.

Źródła