CKTIS / HTML
shadowrootdelegatesfocus — predajanje fokusa v deklarativnem Shadow DOM
Logični atribut shadowrootdelegatesfocus elementa template vključi predajanje fokusa za deklarativno ustvarjen koren shadow. Omogoča prenos fokusa s gostitelja na ustrezen notranji element; sam ne ustvari korena shadow in ne nastavi samodejno fokusa.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
<template shadowrootmode="open" shadowrootdelegatesfocus>…</template>shadowrootdelegatesfocus je logični atribut elementa template. Pri ustvarjanju deklarativnega korena shadow njegova prisotnost vključi predajanje fokusa, njegova odsotnost pa ga izključi. Potreben je tudi veljaven shadowrootmode, bodisi open bodisi closed. Sam atribut ne ustvari korena shadow.
Ko gostitelj prejme zahtevo za fokus, na primer prek host.focus(), lahko brskalnik fokus prenese na ustrezen element v njegovem drevesu shadow. V primeru je input edini tak element. Atribut ne deluje kot autofocus: njegova prisotnost ob nalaganju strani ne nastavi fokusa na noben element.
Veljavne oblike vključujejo shadowrootdelegatesfocus, shadowrootdelegatesfocus="" in shadowrootdelegatesfocus="shadowrootdelegatesfocus". Vrednost "false" ni veljavna vrednost logičnega atributa in funkcije ne izključi: prisotni atribut jo še vedno vključi. Če želite ustvariti koren brez predajanja fokusa, atribut iz deklaracije izpustite.
Razčlenjevalnik to možnost prebere ob ustvarjanju korena; ne gre za sprotno nastavitev obstoječega korena. V primeru open omogoča dostop prek host.shadowRoot. Po kliku na Run document.activeElement označuje gostitelja, root.activeElement pa notranji input; obe primerjavi vrneta true.
Primeri
<!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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.