CKTIS / HTML
shadowrootdelegatesfocus — delegowanie fokusu w deklaratywnym Shadow DOM
Atrybut logiczny shadowrootdelegatesfocus elementu template włącza delegowanie fokusu w deklaratywnie tworzonym korzeniu cienia. Pozwala przekazać fokus z hosta do odpowiedniego elementu wewnętrznego; sam nie tworzy korzenia cienia ani nie ustawia fokusu.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<template shadowrootmode="open" shadowrootdelegatesfocus>…</template>shadowrootdelegatesfocus jest atrybutem logicznym elementu template. Podczas tworzenia deklaratywnego korzenia cienia jego obecność włącza delegowanie fokusu, a brak je wyłącza. Potrzebny jest także poprawny shadowrootmode: open albo closed. Sam atrybut nie tworzy korzenia cienia.
Gdy host otrzymuje żądanie fokusu, na przykład przez host.focus(), przeglądarka może przekazać fokus do odpowiedniego elementu w jego drzewie cienia. W przykładzie jedynym takim elementem jest input. Atrybut nie działa jak autofocus: jego obecność nie ustawia fokusu podczas ładowania strony.
Poprawne zapisy obejmują shadowrootdelegatesfocus, shadowrootdelegatesfocus="" oraz shadowrootdelegatesfocus="shadowrootdelegatesfocus". Wartość "false" nie jest poprawną wartością atrybutu logicznego i nie wyłącza funkcji: obecny atrybut nadal ją włącza. Aby utworzyć korzeń bez delegowania fokusu, pomiń atrybut w deklaracji.
Opcja jest odczytywana podczas tworzenia korzenia przez parser, a nie jako bieżące ustawienie istniejącego korzenia. W przykładzie open umożliwia dostęp przez host.shadowRoot. Po kliknięciu Run właściwość document.activeElement wskazuje hosta, a root.activeElement wskazuje wewnętrzny input; oba porównania dają true.
Przykłady
<!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>Wynik
true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.