Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła