CKTIS / HTML
shadowrootdelegatesfocus — délégation du focus dans le Shadow DOM déclaratif
L’attribut booléen shadowrootdelegatesfocus de template active la délégation du focus pour une racine shadow créée de manière déclarative. Il permet de transférer le focus de l’hôte vers un élément interne approprié ; à lui seul, il ne crée pas de racine shadow et ne met rien automatiquement au focus.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<template shadowrootmode="open" shadowrootdelegatesfocus>…</template>shadowrootdelegatesfocus est un attribut booléen de template. Lors de la création d’une racine shadow déclarative, sa présence active la délégation du focus et son absence la désactive. Un shadowrootmode valide, open ou closed, est également nécessaire. Cet attribut ne crée pas à lui seul une racine shadow.
Lorsque l’hôte reçoit une demande de focus, par exemple avec host.focus(), le navigateur peut transférer le focus vers un élément approprié de son arbre shadow. Dans l’exemple, input est le seul élément de ce type. L’attribut ne fonctionne pas comme autofocus : sa présence ne met aucun élément au focus au chargement de la page.
Les formes valides incluent shadowrootdelegatesfocus, shadowrootdelegatesfocus="" et shadowrootdelegatesfocus="shadowrootdelegatesfocus". La valeur "false" n’est pas une valeur valide pour un attribut booléen et ne désactive pas la fonctionnalité : la présence de l’attribut continue de l’activer. Pour créer une racine sans délégation du focus, omettez l’attribut de la déclaration.
Le parseur lit cette option lors de la création de la racine ; elle ne constitue pas un réglage modifiable en continu sur une racine existante. Dans l’exemple, open permet l’accès via host.shadowRoot. Après avoir cliqué sur Run, document.activeElement désigne l’hôte, tandis que root.activeElement désigne l’input interne ; les deux comparaisons donnent true.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Focus delegation</title>
<div id="host">
<template shadowrootmode="open" shadowrootdelegatesfocus>
<label>Name <input id="name" type="text"></label>
</template>
</div>
<button id="run" type="button">Run</button>
<pre id="result"></pre>
<script>
const host = document.getElementById('host');
document.getElementById('run').addEventListener('click', () => {
host.focus();
const root = host.shadowRoot;
document.getElementById('result').textContent = [
document.activeElement === host,
root.activeElement === root.getElementById('name')
].join('\n');
});
</script>
</html>Résultat
true true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.