CKTIS / HTML
shadowrootdelegatesfocus — Fokusdelegation im deklarativen Shadow DOM
Das boolesche Attribut shadowrootdelegatesfocus auf einem template aktiviert die Fokusdelegation für einen deklarativ erstellten Shadow Root. So kann der Fokus vom Host zu einem geeigneten Element im Inneren weitergeleitet werden; das Attribut erstellt selbst keinen Shadow Root und setzt auch nicht automatisch den Fokus.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<template shadowrootmode="open" shadowrootdelegatesfocus>…</template>shadowrootdelegatesfocus ist ein boolesches Attribut von template. Beim Erstellen eines deklarativen Shadow Roots aktiviert seine Anwesenheit die Fokusdelegation; fehlt es, ist sie deaktiviert. Außerdem ist ein gültiges shadowrootmode erforderlich, entweder open oder closed. Das Attribut allein erstellt keinen Shadow Root.
Wenn der Host eine Fokusanforderung erhält, zum Beispiel durch host.focus(), kann der Browser den Fokus an ein geeignetes Element in seinem Shadow Tree weiterleiten. Im Beispiel ist das input das einzige solche Element. Das Attribut verhält sich nicht wie autofocus: Seine Anwesenheit setzt beim Laden der Seite keinen Fokus.
Gültige Schreibweisen sind unter anderem shadowrootdelegatesfocus, shadowrootdelegatesfocus="" und shadowrootdelegatesfocus="shadowrootdelegatesfocus". Der Wert "false" ist kein gültiger Wert für ein boolesches Attribut und deaktiviert die Funktion nicht: Das vorhandene Attribut aktiviert sie weiterhin. Um einen Root ohne Fokusdelegation zu erstellen, lasse das Attribut in der Deklaration weg.
Die Option wird beim Erstellen des Roots durch den Parser gelesen und ist keine laufende Einstellung eines bestehenden Roots. Im Beispiel ermöglicht open den Zugriff über host.shadowRoot. Nach einem Klick auf Run verweist document.activeElement auf den Host, während root.activeElement auf das interne input verweist; beide Vergleiche ergeben true.
Beispiele
<!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>Ergebnis
true true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.