CKTIS / JavaScript
Wyszukiwanie po ID a fokus: getElementById() i activeElement
`document.getElementById(id)` wyszukuje element według identyfikatora, a `document.activeElement` wskazuje, gdzie dokument widzi bieżący fokus klawiatury.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
document.getElementById(id) // call: Element or null
document.activeElement // read-only property: Element or nulldocument.getElementById(id) to metoda wyszukująca element w drzewie danego dokumentu na podstawie wartości id. Podaj sam identyfikator, bez prefiksu # stosowanego w selektorach CSS. Wielkość liter ma znaczenie. Wynik to Element albo null, jeśli nie ma dopasowania. Wartości id powinny być unikatowe w obrębie drzewa; w razie powtórzeń metoda zwraca pierwsze dopasowanie w kolejności drzewa.
Wyszukiwanie nie obejmuje węzłów odłączonych od dokumentu ani nie wchodzi do drzew Shadow DOM czy dokumentów w iframe. DocumentFragment, a więc również ShadowRoot, udostępnia własną metodę getElementById(); zwykły Element jej nie ma. Zanim użyjesz wyniku, sprawdź, czy nie jest równy null, lub zastosuj ?., jeśli brak elementu jest dopuszczalny.
document.activeElement to właściwość tylko do odczytu, a nie metoda. Zwraca Element reprezentujący bieżący fokus klawiatury z perspektywy tego dokumentu. Gdy fokus jest wewnątrz Shadow DOM lub dokumentu osadzonego w iframe, dokument zewnętrzny widzi odpowiednio hosta lub element iframe. Aby zajrzeć głębiej, odczytaj activeElement z dostępnego ShadowRoot lub dokumentu ramki z tego samego źródła (same origin). Gdy fokus wskazuje na sam dokument, wynikiem jest jego body, a przy jego braku documentElement, jeśli istnieje. Jeśli z perspektywy tego drzewa nie ma pasującego elementu ani wartości zastępczej, wynikiem jest null.
Fokus to nie zaznaczenie tekstu. Samo wyszukanie elementu nie przenosi fokusu. Jeśli target nie jest null, porównanie document.activeElement === target sprawdza tożsamość węzła. Po zmianie fokusu ponownie odczytaj właściwość: zapisana wcześniej wartość nie aktualizuje się sama. To interfejsy platformy webowej, a nie funkcje ECMAScript 2024; środowisko bez DOM przeglądarki nie musi udostępniać document.
Przykłady
<!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>Wynik
true false true true
Zapisz przykład jako plik HTML, otwórz go w aktywnej karcie przeglądarki, a następnie sprawdź konsolę. Jeśli przeglądarka pozwala ustawić fokus programowo, pierwsze trzy wiersze pokazują, że element znaleziono, początkowo nie ma on fokusu, a potem go otrzymuje. Ostatni wiersz potwierdza brak dopasowania po zmianie wielkości liter.
Powiązane lekcje
- JavaScript · Lekcja 18 · Zaawansowany · Wersja: 4