Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

commandfor: cíl příkazu tlačítka

Propojte tlačítko s konkrétním prvkem, ne CSS selektorem či všemi shodnými uzly.

Verze: HTML Living Standard

Syntaxe

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

Atribut commandfor obsahuje ID prvku, který je cílem příkazu tlačítka. Cíl musí být ve stejném stromu. Zapište samotné ID, nikoli CSS selektor s úvodní mřížkou. DOM vlastnost commandForElement zpřístupňuje přiřazený prvek tam, kde je funkce podporována. Chybějící nebo nenalezený cíl nemůže zamýšlený příkaz přijmout.

Atribut volí příjemce, zatímco command dodává operaci. Vlastní operace vyvolá CommandEvent, jehož příkaz a zdroj určují požadavek a vyvolávající tlačítko. Vlastní chování musí implementovat kód aplikace. Použijte výslovný neodesílající typ tlačítka a nepoužívejte duplicitní ID, která zamýšlenou vazbu činí nespolehlivou.

Scénář má dva možné cíle, ale vlastní požadavek posílá pouze prvnímu. Jeho obsluha prvek označí a zapíše název příkazu i zdrojové tlačítko; druhá obsluha zůstane nepoužita. Chromium 145 ověřuje nativní směrování. Nepodporující prohlížeč oznámí chybějící funkci, místo aby předstíral provedení.

Příklady

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

Výsledek

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

Skutečný prohlížeč kontroluje označený cíl, řetězec příkazu, zdrojové tlačítko i nezměněný druhý cíl.

Zdroje