Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

command: deklaratywne działanie przycisku

Wywołuj natywne operacje dialogu lub popovera albo wysyłaj własne polecenie.

Wersja: HTML Living Standard

Składnia

<button type="button" command="show-modal" commandfor="details">Open</button>

Atrybut command nadaje przyciskowi działanie skierowane do elementu wskazanego jako cel polecenia. Wbudowane wartości obejmują show-modal, close i request-close dla dialogów oraz pokazywanie, ukrywanie i przełączanie popoverów. Działanie musi być poprawne dla celu. Brak lub nierozpoznana wartość nie staje się dowolnym JavaScriptem ani nie uruchamia tekstu źródłowego.

Nazwy własnych poleceń zaczynają się od -- i wysyłają zdarzenie do obsługi przez kod aplikacji; nie tworzą nowej natywnej operacji. Anulowanie zdarzenia polecenia blokuje domyślne działanie. Użyj type="button", jeśli kontrolka nie ma wysyłać ani resetować formularza. Wyłączony przycisk nie wywołuje działania, a nowsza obsługa poleceń wymaga wykrywania dostępności.

Przykład używa dwóch natywnych przycisków do otwarcia modalnego dialogu i jego zamknięcia. Chromium 145 wykonuje oba działania bez obsługi zdarzeń aplikacji w obsługiwanej gałęzi. Oddzielna gałąź zastępcza instaluje jawne funkcje, gdy brak funkcji DOM. Sprawdzony wynik dotyczy tej przeglądarki, nie każdego osadzonego WebView ani starszego silnika.

Przykłady

<!doctype html><meta charset="utf-8">
<button id="open" type="button" command="show-modal" commandfor="details">Open</button>
<dialog id="details"><p>Details</p><button id="close" type="button" command="close" commandfor="details">Close</button></dialog>
<output id="result"></output><script>
const open = document.querySelector('#open'), details = document.querySelector('#details');
if ('command' in open && 'commandForElement' in open) {
  open.click(); const opened = details.open && details.matches(':modal');
  document.querySelector('#close').click();
  document.querySelector('#result').textContent = 'opened=' + opened + '; closed=' + !details.open;
} else {
  open.onclick = () => details.showModal();
  document.querySelector('#close').onclick = () => details.close();
  document.querySelector('#result').textContent = 'command unsupported; explicit handlers installed';
}
</script>

Wynik

opened=true; closed=true

W sprawdzonej gałęzi dialog otwierają i zamykają natywne polecenia; zastępcze funkcje obsługi nie są instalowane.

Źródła