База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

shadowrootdelegatesfocus — делегиране на фокуса в декларативен Shadow DOM

Булевият атрибут shadowrootdelegatesfocus на template включва делегирането на фокуса за декларативно създаден shadow root. Той позволява фокусът да се прехвърли от хоста към подходящ вътрешен елемент; сам по себе си не създава shadow root и не задава автоматично фокус.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

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

shadowrootdelegatesfocus е булев атрибут на template. При създаване на декларативен shadow root наличието му включва делегирането на фокуса, а отсъствието му го изключва. Необходим е и валиден shadowrootmode — open или closed. Сам по себе си атрибутът не създава shadow root.

Когато хостът получи заявка за фокус, например чрез host.focus(), браузърът може да прехвърли фокуса към подходящ елемент в неговото shadow дърво. В примера input е единственият такъв елемент. Атрибутът не действа като autofocus: наличието му не задава фокус при зареждане на страницата.

Валидните форми включват shadowrootdelegatesfocus, shadowrootdelegatesfocus="" и shadowrootdelegatesfocus="shadowrootdelegatesfocus". Стойността "false" не е валидна стойност за булев атрибут и не изключва функцията: наличният атрибут продължава да я включва. За да създадете root без делегиране на фокуса, пропуснете атрибута в декларацията.

Парсерът прочита тази опция при създаването на root; тя не е текуща настройка на вече съществуващ root. В примера open позволява достъп чрез host.shadowRoot. След щракване върху Run document.activeElement обозначава хоста, а root.activeElement — вътрешния input; и двете сравнения дават true.

Примери

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

Резултат

true
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници