CKTIS / HTML
commandfor : acheminer la commande d’un bouton vers sa cible
Associez un bouton à un élément précis plutôt qu’à un sélecteur CSS ou à tous les nœuds correspondants.
Version : HTML Living Standard
Syntaxe
<button type="button" command="--mark" commandfor="first">Mark</button>L’attribut commandfor contient l’ID de l’élément ciblé par la commande d’un bouton. La cible doit appartenir au même arbre. Écrivez l’ID lui-même, pas un sélecteur CSS précédé d’un dièse. La propriété DOM commandForElement expose l’élément associé lorsque la fonctionnalité est prise en charge. Une cible absente ou introuvable ne peut pas recevoir la commande prévue.
L’attribut choisit un destinataire ; command fournit l’opération. Une opération personnalisée produit un CommandEvent dont la commande et la source identifient la demande et le bouton appelant. Le code applicatif doit implémenter ce comportement personnalisé. Employez un type de bouton explicitement non soumis au formulaire et évitez les ID dupliqués, qui rendent l’association voulue incertaine.
Le dispositif possède deux cibles possibles, mais n’envoie la demande personnalisée qu’à la première. Son écouteur marque cet élément et relève le nom de commande ainsi que le bouton source ; le second écouteur n’est pas appelé. Chromium 145 vérifie l’acheminement natif. Un navigateur incompatible signale la capacité manquante au lieu de prétendre que l’opération a eu lieu.
Exemples
<!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>Résultat
target=first; command=--mark; source=send; second=false
La cible marquée, la chaîne de commande, le bouton source et la seconde cible intacte sont tous vérifiés dans le véritable navigateur.