Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

shadowrootdelegatesfocus — odovzdávanie fokusu v deklaratívnom Shadow DOM

Booleovský atribút shadowrootdelegatesfocus prvku template zapína odovzdávanie fokusu pre deklaratívne vytvorený koreň shadow. Umožňuje odovzdať fokus z hostiteľa vhodnému vnútornému prvku; sám koreň shadow nevytvára ani automaticky nenastavuje fokus.

Verzia: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

<template shadowrootmode="open" shadowrootdelegatesfocus>…</template>

shadowrootdelegatesfocus je booleovský atribút prvku template. Pri vytváraní deklaratívneho koreňa shadow jeho prítomnosť zapína odovzdávanie fokusu a jeho neprítomnosť ho vypína. Potrebný je aj platný shadowrootmode, buď open, alebo closed. Samotný atribút koreň shadow nevytvorí.

Keď hostiteľ dostane požiadavku na fokus, napríklad prostredníctvom host.focus(), prehliadač môže odovzdať fokus vhodnému prvku v jeho strome shadow. V príklade je jediným takým prvkom input. Atribút nefunguje ako autofocus: jeho prítomnosť pri načítaní stránky nenastaví fokus na žiadny prvok.

Platné zápisy zahŕňajú shadowrootdelegatesfocus, shadowrootdelegatesfocus="" a shadowrootdelegatesfocus="shadowrootdelegatesfocus". Hodnota "false" nie je platnou hodnotou booleovského atribútu a funkciu nevypne: prítomný atribút ju stále zapína. Ak chcete vytvoriť koreň bez odovzdávania fokusu, atribút z deklarácie vynechajte.

Analyzátor túto možnosť načíta pri vytváraní koreňa; nejde o priebežné nastavenie existujúceho koreňa. V príklade umožňuje open prístup cez host.shadowRoot. Po kliknutí na Run označuje document.activeElement hostiteľa a root.activeElement vnútorný input; obe porovnania vrátia true.

Príklady

<!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>

Výsledok

true
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje