CKTIS / HTML
shadowrootdelegatesfocus — focusdelegatie in declaratieve Shadow DOM
Het booleaanse attribuut shadowrootdelegatesfocus van template schakelt focusdelegatie in voor een declaratief aangemaakte shadow root. Hiermee kan de focus van de host naar een geschikt intern element worden verplaatst; het attribuut maakt zelf geen shadow root aan en zet ook niet automatisch de focus.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<template shadowrootmode="open" shadowrootdelegatesfocus>…</template>shadowrootdelegatesfocus is een booleaans attribuut van template. Bij het aanmaken van een declaratieve shadow root schakelt de aanwezigheid ervan focusdelegatie in; zonder het attribuut is die uitgeschakeld. Ook is een geldige shadowrootmode nodig: open of closed. Het attribuut maakt op zichzelf geen shadow root aan.
Wanneer de host een focusverzoek ontvangt, bijvoorbeeld via host.focus(), kan de browser de focus doorgeven aan een geschikt element in de shadow tree. In het voorbeeld is input het enige element van dat type. Het attribuut werkt niet zoals autofocus: de aanwezigheid ervan zet bij het laden van de pagina geen element op focus.
Geldige vormen zijn onder meer shadowrootdelegatesfocus, shadowrootdelegatesfocus="" en shadowrootdelegatesfocus="shadowrootdelegatesfocus". De waarde "false" is geen geldige waarde voor een booleaans attribuut en schakelt de functie niet uit: een aanwezig attribuut schakelt die nog steeds in. Laat het attribuut weg uit de declaratie om een root zonder focusdelegatie aan te maken.
De parser leest deze optie wanneer hij de root aanmaakt; het is geen live instelling van een bestaande root. In het voorbeeld maakt open toegang mogelijk via host.shadowRoot. Na een klik op Run verwijst document.activeElement naar de host en verwijst root.activeElement naar de interne input; beide vergelijkingen leveren true op.
Voorbeelden
<!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>Resultaat
true true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.