CKTIS / HTML
shadowrootdelegatesfocus — odovzdávanie fokusu v deklaratívnom Shadow DOM
Booleovský atribút shadowrootdelegatesfocus prvku template zapína odovzdávanie fokusu pre deklaratívne vytvorený koreň shadow. Umožňuje odovzdať fokus z hostiteľa vhodnému vnútornému prvku; sám koreň shadow nevytvára ani automaticky nenastavuje fokus.
Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<template shadowrootmode="open" shadowrootdelegatesfocus>…</template>shadowrootdelegatesfocus je booleovský atribút prvku template. Pri vytváraní deklaratívneho koreňa shadow jeho prítomnosť zapína odovzdávanie fokusu a jeho neprítomnosť ho vypína. Potrebný je aj platný shadowrootmode, buď open, alebo closed. Samotný atribút koreň shadow nevytvorí.
Keď hostiteľ dostane požiadavku na fokus, napríklad prostredníctvom host.focus(), prehliadač môže odovzdať fokus vhodnému prvku v jeho strome shadow. V príklade je jediným takým prvkom input. Atribút nefunguje ako autofocus: jeho prítomnosť pri načítaní stránky nenastaví fokus na žiadny prvok.
Platné zápisy zahŕňajú shadowrootdelegatesfocus, shadowrootdelegatesfocus="" a shadowrootdelegatesfocus="shadowrootdelegatesfocus". Hodnota "false" nie je platnou hodnotou booleovského atribútu a funkciu nevypne: prítomný atribút ju stále zapína. Ak chcete vytvoriť koreň bez odovzdávania fokusu, atribút z deklarácie vynechajte.
Analyzátor túto možnosť načíta pri vytváraní koreňa; nejde o priebežné nastavenie existujúceho koreňa. V príklade umožňuje open prístup cez host.shadowRoot. Po kliknutí na Run označuje document.activeElement hostiteľa a root.activeElement vnútorný input; obe porovnania vrátia true.
Prí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ýsledok
true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.