CKTIS / HTML
shadowrootdelegatesfocus — delegiranje fokusa u deklarativnom Shadow DOM-u
Booleov atribut shadowrootdelegatesfocus elementa template uključuje delegiranje fokusa za deklarativno stvoreni korijen shadow. Omogućuje prijenos fokusa s domaćina na prikladan unutarnji element; sam ne stvara korijen shadow niti automatski postavlja fokus.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<template shadowrootmode="open" shadowrootdelegatesfocus>…</template>shadowrootdelegatesfocus booleov je atribut elementa template. Pri stvaranju deklarativnog korijena shadow njegova prisutnost uključuje delegiranje fokusa, a njegova odsutnost ga isključuje. Potreban je i valjan shadowrootmode: open ili closed. Sam atribut ne stvara korijen shadow.
Kada domaćin primi zahtjev za fokus, primjerice putem host.focus(), preglednik može prenijeti fokus na prikladan element u njegovu stablu shadow. U primjeru je input jedini takav element. Atribut ne funkcionira kao autofocus: njegova prisutnost pri učitavanju stranice ne postavlja fokus ni na što.
Valjani oblici uključuju shadowrootdelegatesfocus, shadowrootdelegatesfocus="" i shadowrootdelegatesfocus="shadowrootdelegatesfocus". Vrijednost "false" nije valjana vrijednost booleova atributa i ne isključuje značajku: prisutni atribut i dalje je uključuje. Za stvaranje korijena bez delegiranja fokusa izostavite atribut iz deklaracije.
Parser čita ovu mogućnost pri stvaranju korijena; ona nije aktivna postavka postojećeg korijena. U primjeru open omogućuje pristup putem host.shadowRoot. Nakon klika na Run, document.activeElement označava domaćina, a root.activeElement unutarnji input; obje usporedbe daju true.
Primjeri
<!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>Rezultat
true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.