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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.