CKTIS / HTML
shadowrootdelegatesfocus — předávání fokusu v deklarativním Shadow DOM
Booleovský atribut shadowrootdelegatesfocus elementu template zapíná předávání fokusu pro deklarativně vytvořený kořen shadow. Umožňuje předat fokus z hostitele na vhodný vnitřní prvek; sám kořen shadow nevytváří ani automaticky nenastavuje fokus.
Verze: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
<template shadowrootmode="open" shadowrootdelegatesfocus>…</template>shadowrootdelegatesfocus je booleovský atribut elementu template. Při vytváření deklarativního kořene shadow jeho přítomnost zapíná předávání fokusu a jeho absence je vypíná. Je také potřeba platný shadowrootmode, buď open, nebo closed. Samotný atribut kořen shadow nevytvoří.
Když hostitel obdrží požadavek na fokus, například prostřednictvím host.focus(), může prohlížeč předat fokus vhodnému prvku v jeho stromu shadow. V příkladu je jediným takovým prvkem input. Atribut nefunguje jako autofocus: jeho přítomnost při načtení stránky na žádný prvek fokus nenastaví.
Platné zápisy zahrnují shadowrootdelegatesfocus, shadowrootdelegatesfocus="" a shadowrootdelegatesfocus="shadowrootdelegatesfocus". Hodnota "false" není platnou hodnotou booleovského atributu a funkci nevypíná: přítomný atribut ji stále zapíná. Chcete-li vytvořit kořen bez předávání fokusu, atribut z deklarace vynechte.
Analyzátor tuto možnost načte při vytvoření kořene; nejde o průběžné nastavení existujícího kořene. V příkladu umožňuje open přístup přes host.shadowRoot. Po kliknutí na Run označuje document.activeElement hostitele a root.activeElement vnitřní input; obě porovnání vrátí true.
Příklady
<!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>Výsledek
true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.