CKTIS / HTML
shadowrootdelegatesfocus — delega del focus nello Shadow DOM dichiarativo
L’attributo booleano shadowrootdelegatesfocus di template attiva la delega del focus per una shadow root creata in modo dichiarativo. Consente di trasferire il focus dall’host a un elemento interno adatto; da solo non crea una shadow root né porta automaticamente il focus su un elemento.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<template shadowrootmode="open" shadowrootdelegatesfocus>…</template>shadowrootdelegatesfocus è un attributo booleano di template. Quando viene creata una shadow root dichiarativa, la sua presenza attiva la delega del focus e la sua assenza la disattiva. È necessario anche un shadowrootmode valido, open oppure closed. Questo attributo, da solo, non crea una shadow root.
Quando l’host riceve una richiesta di focus, per esempio tramite host.focus(), il browser può trasferire il focus a un elemento adatto nel suo albero shadow. Nell’esempio, input è l’unico elemento di questo tipo. L’attributo non si comporta come autofocus: la sua presenza non porta il focus su alcun elemento al caricamento della pagina.
Le forme valide includono shadowrootdelegatesfocus, shadowrootdelegatesfocus="" e shadowrootdelegatesfocus="shadowrootdelegatesfocus". Il valore "false" non è valido per un attributo booleano e non disattiva la funzionalità: se presente, l’attributo continua ad attivarla. Per creare una root senza delega del focus, ometti l’attributo dalla dichiarazione.
Il parser legge l’opzione quando crea la root; non è un’impostazione dinamica di una root già esistente. Nell’esempio, open consente l’accesso tramite host.shadowRoot. Dopo aver fatto clic su Run, document.activeElement indica l’host, mentre root.activeElement indica l’input interno; entrambi i confronti restituiscono true.
Esempi
<!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>Risultato
true true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.