Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / HTML

shadowrootdelegatesfocus — delegiranje fokusa u deklarativnom Shadow DOM-u

Booleov atribut shadowrootdelegatesfocus elementa template uključuje delegiranje fokusa za deklarativno stvoreni korijen shadow. Omogućuje prijenos fokusa s domaćina na prikladan unutarnji element; sam ne stvara korijen shadow niti automatski postavlja fokus.

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

Sintaksa

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

shadowrootdelegatesfocus booleov je atribut elementa template. Pri stvaranju deklarativnog korijena shadow njegova prisutnost uključuje delegiranje fokusa, a njegova odsutnost ga isključuje. Potreban je i valjan shadowrootmode: open ili closed. Sam atribut ne stvara korijen shadow.

Kada domaćin primi zahtjev za fokus, primjerice putem host.focus(), preglednik može prenijeti fokus na prikladan element u njegovu stablu shadow. U primjeru je input jedini takav element. Atribut ne funkcionira kao autofocus: njegova prisutnost pri učitavanju stranice ne postavlja fokus ni na što.

Valjani oblici uključuju shadowrootdelegatesfocus, shadowrootdelegatesfocus="" i shadowrootdelegatesfocus="shadowrootdelegatesfocus". Vrijednost "false" nije valjana vrijednost booleova atributa i ne isključuje značajku: prisutni atribut i dalje je uključuje. Za stvaranje korijena bez delegiranja fokusa izostavite atribut iz deklaracije.

Parser čita ovu mogućnost pri stvaranju korijena; ona nije aktivna postavka postojećeg korijena. U primjeru open omogućuje pristup putem host.shadowRoot. Nakon klika na Run, document.activeElement označava domaćina, a root.activeElement unutarnji input; obje usporedbe daju true.

Primjeri

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

Rezultat

true
true

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori