Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Pretraživanje po ID-u i fokus: getElementById() i activeElement

`document.getElementById(id)` pronalazi element prema identifikatoru, dok `document.activeElement` pokazuje gdje je trenutačni fokus tipkovnice iz perspektive dokumenta.

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

Sintaksa

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

document.getElementById(id) metoda je koja traži vrijednost id u stablu danog dokumenta. Proslijedi samo identifikator, bez prefiksa # koji se rabi u CSS selektorima. Pretraga razlikuje velika i mala slova. Metoda vraća Element ili null ako nema podudaranja. ID-jevi trebaju biti jedinstveni unutar stabla; ako postoje duplikati, metoda vraća prvi rezultat prema redoslijedu u stablu.

Pretraga ne obuhvaća čvorove odvojene od dokumenta i ne ulazi u stabla Shadow DOM-a ni u dokumente unutar elemenata iframe. DocumentFragment, pa tako i ShadowRoot, ima vlastitu metodu getElementById(); običan Element nema je. Prije uporabe provjeri je li rezultat null ili upotrijebi ?. ako element smije nedostajati.

document.activeElement svojstvo je samo za čitanje, a ne metoda. Vraća Element koji predstavlja trenutačni fokus tipkovnice iz perspektive tog dokumenta. Kad je fokus unutar stabla Shadow DOM-a ili ugrađenog dokumenta, vanjski dokument vidi element domaćin Shadow DOM-a odnosno element iframe. Za uvid u unutrašnjost pročitaj activeElement na dostupnom ShadowRoot ili na dokumentu okvira ako je istog podrijetla. Ako se fokus odnosi na sam dokument, svojstvo vraća njegov body ili, ako ga nema, documentElement ako postoji. Ako u upitanom stablu nema odgovarajućeg elementa ni zamjenske vrijednosti, vraća null.

Fokus nije odabir teksta, a traženje elementa ne daje mu fokus. Ako target nije null, izraz document.activeElement === target provjerava je li riječ o istom čvoru. Nakon promjene fokusa ponovno pročitaj svojstvo: spremljena vrijednost ne ažurira se sama. To su API-ji web-platforme, a ne značajke ECMAScripta 2024; izvršno okruženje bez DOM-a preglednika ne mora nuditi document.

Primjeri

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

Rezultat

true
false
true
true

Spremi primjer kao HTML datoteku, otvori je na kartici preglednika u prvom planu, a zatim provjeri konzolu preglednika. Ako preglednik dopušta programsko postavljanje fokusa, prva tri retka pokazuju da je ciljni element pronađen, da u početku nema fokus, a zatim ga dobiva. Posljednji redak potvrđuje da promjena velikih i malih slova sprječava podudaranje.

Povezane lekcije

  • JavaScript · Lekcija 18 · Napredno · Verzija: 4

Izvori