Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Iskanje po ID-ju in fokus: getElementById() in activeElement

`document.getElementById(id)` poišče element po njegovem identifikatorju, `document.activeElement` pa pokaže, kje je z vidika dokumenta trenutno fokus tipkovnice.

Različica: 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) je metoda, ki v drevesu danega dokumenta poišče vrednost id. Podaj samo identifikator, brez predpone #, ki se uporablja pri izbirnikih CSS. Iskanje razlikuje med velikimi in malimi črkami. Metoda vrne Element ali null, če ni zadetka. ID-ji morajo biti znotraj drevesa enolični; če se ponavljajo, metoda vrne prvi zadetek po vrstnem redu v drevesu.

Iskanje ne zajema vozlišč, ki niso priključena dokumentu, in ne vstopa v drevesa senčnega DOM-a ali v dokumente znotraj elementov iframe. DocumentFragment in s tem tudi ShadowRoot ima lastno metodo getElementById(); navaden Element je nima. Pred uporabo preveri, ali je rezultat null, ali uporabi ?., če element lahko manjka.

document.activeElement je lastnost samo za branje, ne metoda. Vrne Element, ki z vidika tega dokumenta predstavlja trenutni fokus tipkovnice. Če je fokus znotraj drevesa senčnega DOM-a ali v vdelanem dokumentu, zunanji dokument vidi gostitelja senčnega DOM-a oziroma element iframe. Za vpogled v notranjost preberi activeElement na dostopnem ShadowRoot ali na dokumentu okvirja, če ima isti izvor. Če je v fokusu sam dokument, lastnost vrne njegov body ali, če ga ni, documentElement, če obstaja. Če v poizvedovanem drevesu ni ustreznega elementa ali nadomestne vrednosti, vrne null.

Fokus ni isto kot izbira besedila in iskanje elementu ne dodeli fokusa. Če target ni null, izraz document.activeElement === target preveri, ali gre za isto vozlišče. Po spremembi fokusa lastnost preberi znova: shranjena vrednost se ne posodobi sama. To sta vmesnika spletne platforme, ne funkcionalnosti ECMAScripta 2024; izvajalno okolje brez brskalnikovega DOM-a ne zagotavlja nujno document.

Primeri

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

Shrani primer kot datoteko HTML, odpri jo v zavihku brskalnika v ospredju in nato preveri konzolo brskalnika. Če brskalnik dovoljuje programsko nastavljanje fokusa, prve tri vrstice pokažejo, da je ciljni element najden, sprva nima fokusa, nato pa ga dobi. Zadnja vrstica potrdi, da sprememba velikosti črk prepreči ujemanje.

Povezane lekcije

  • JavaScript · Lekcija 18 · Napredna · Različica: 4

Viri