CKTIS / JavaScript
Vyhledání podle ID a fokus: getElementById() a activeElement
`document.getElementById(id)` vyhledá prvek podle jeho identifikátoru, zatímco `document.activeElement` ukazuje, kde je z pohledu dokumentu právě fokus klávesnice.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
document.getElementById(id) // call: Element or null
document.activeElement // read-only property: Element or nulldocument.getElementById(id) je metoda, která hledá hodnotu id ve stromu daného dokumentu. Předej samotný identifikátor bez předpony # používané v selektorech CSS. Při porovnávání záleží na velikosti písmen. Metoda vrátí Element, nebo null, pokud nenajde shodu. ID mají být v rámci stromu jedinečná; při duplicitách metoda vrátí první shodu v pořadí stromu.
Vyhledávání nezahrnuje uzly odpojené od dokumentu a nevstupuje do stromů Shadow DOM ani do dokumentů uvnitř prvků iframe. DocumentFragment, a tedy i ShadowRoot, má vlastní metodu getElementById(); běžný Element ji nemá. Než výsledek použiješ, ověř, zda není null, nebo použij ?., pokud prvek smí chybět.
document.activeElement je vlastnost pouze pro čtení, nikoli metoda. Vrací Element, který z pohledu daného dokumentu představuje aktuální fokus klávesnice. Pokud je fokus uvnitř stromu Shadow DOM nebo vloženého dokumentu, vnější dokument vidí hostitelský prvek Shadow DOM, respektive prvek iframe. Další úroveň zjistíš čtením activeElement na přístupném ShadowRoot nebo na dokumentu rámce se stejným původem. Pokud fokus připadne samotnému dokumentu, vlastnost vrátí jeho body, případně documentElement, pokud existuje. Pokud v dotazovaném stromu nepřipadá v úvahu žádný prvek ani náhradní hodnota, vrátí null.
Fokus není výběr textu a vyhledání prvku mu fokus nepřidělí. Pokud target není null, výraz document.activeElement === target ověří, zda jde o tentýž uzel. Po změně fokusu vlastnost přečti znovu: uložená hodnota se sama neaktualizuje. Jde o API webové platformy, nikoli o funkce ECMAScriptu 2024; běhové prostředí bez DOM prohlížeče nemusí poskytovat document.
Pří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ýsledek
true false true true
Ulož příklad jako soubor HTML, otevři ho na kartě prohlížeče v popředí a potom se podívej do konzole prohlížeče. Pokud prohlížeč umožní nastavit fokus programově, první tři řádky ukážou, že se cílový prvek našel, nejprve nemá fokus a pak ho získá. Poslední řádek potvrdí, že změna velikosti písmen zabrání shodě.
Související lekce
- JavaScript · Lekce 18 · Pokročilá · Verze: 4