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 nulldocument.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