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

CKTIS / JavaScript

Vyhľadanie podľa ID a fokus: getElementById() a activeElement

`document.getElementById(id)` vyhľadá prvok podľa identifikátora, zatiaľ čo `document.activeElement` ukazuje, kde je z pohľadu dokumentu práve fokus klávesnice.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

document.getElementById(id) // call: Element or null
document.activeElement     // read-only property: Element or null

document.getElementById(id) je metóda, ktorá hľadá hodnotu id v strome daného dokumentu. Odovzdaj samotný identifikátor bez predpony # používanej v selektoroch CSS. Pri porovnávaní záleží na veľkosti písmen. Metóda vráti Element alebo null, ak nenájde zhodu. ID majú byť v rámci stromu jedinečné; pri duplicitách metóda vráti prvú zhodu v poradí stromu.

Vyhľadávanie nezahŕňa uzly odpojené od dokumentu a nevstupuje do stromov Shadow DOM ani do dokumentov v prvkoch iframe. DocumentFragment, a teda aj ShadowRoot, má vlastnú metódu getElementById(); bežný Element ju nemá. Pred použitím výsledku over, či nie je null, alebo použi ?., ak prvok môže chýbať.

document.activeElement je vlastnosť iba na čítanie, nie metóda. Vracia Element, ktorý z pohľadu tohto dokumentu reprezentuje aktuálny fokus klávesnice. Keď je fokus v strome Shadow DOM alebo vo vloženom dokumente, vonkajší dokument vidí hostiteľský prvok Shadow DOM, respektíve prvok iframe. Ďalšiu úroveň zistíš čítaním activeElement na prístupnom ShadowRoot alebo na dokumente rámca s rovnakým pôvodom. Ak fokus pripadne samotnému dokumentu, vlastnosť vráti jeho body, inak documentElement, ak existuje. Ak v dotazovanom strome neprichádza do úvahy žiadny prvok ani náhradná hodnota, vráti null.

Fokus nie je výber textu a vyhľadanie prvku mu nepridelí fokus. Ak target nie je null, výraz document.activeElement === target overí, či ide o ten istý uzol. Po zmene fokusu vlastnosť prečítaj znova: uložená hodnota sa sama neaktualizuje. Ide o API webovej platformy, nie o funkcie ECMAScriptu 2024; prostredie bez DOM prehliadača nemusí poskytovať document.

Príklady

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>ID lookup and focus</title>
</head>
<body>
<script>
{
  const other = document.createElement('input');
  const target = document.createElement('input');
  target.id = 'cktis-target';
  document.body.append(other, target);

  try {
    const found = document.getElementById('cktis-target');
    other.focus();
    console.log(found === target);
    console.log(found === document.activeElement);

    found?.focus();
    console.log(found === document.activeElement);
    console.log(document.getElementById('CKTIS-target') === null);
  } finally {
    other.remove();
    target.remove();
  }
}
</script>
</body>
</html>

Výsledok

true
false
true
true

Ulož príklad ako súbor HTML, otvor ho na karte prehliadača v popredí a potom skontroluj konzolu prehliadača. Ak prehliadač umožní nastaviť fokus programovo, prvé tri riadky ukážu, že sa cieľový prvok našiel, najprv nemá fokus a potom ho získa. Posledný riadok potvrdí, že zmena veľkosti písmen zabráni zhode.

Súvisiace lekcie

  • JavaScript · Lekcia 18 · Pokročilá · Verzia: 4

Zdroje