CKTIS / JavaScript
Zoeken op ID en focus: getElementById() en activeElement
`document.getElementById(id)` zoekt een element op basis van de ID, terwijl `document.activeElement` aangeeft waar de toetsenbordfocus ligt vanuit het perspectief van het document.
Versie: 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) is een methode die in de boom van het betreffende document naar een id zoekt. Geef alleen de ID op, zonder het voorvoegsel # van CSS-selectors. De zoekopdracht is hoofdlettergevoelig. De methode geeft een Element terug, of null als niets overeenkomt. ID’s horen binnen een boom uniek te zijn; bij duplicaten krijg je de eerste overeenkomst in boomvolgorde.
De zoekopdracht slaat losgekoppelde knooppunten over en zoekt niet in shadowbomen of in documenten binnen iframe-elementen. DocumentFragment, en dus ook ShadowRoot, heeft een eigen methode getElementById(); een gewoon Element heeft die niet. Controleer vóór gebruik of het resultaat null is, of gebruik ?. als het element mag ontbreken.
document.activeElement is een alleen-lezen eigenschap, geen methode. Ze geeft het Element terug dat vanuit dit document de huidige toetsenbordfocus vertegenwoordigt. Ligt de focus in een shadowboom of een ingesloten document, dan ziet het buitenste document respectievelijk de shadowhost of het iframe-element. Lees voor meer detail activeElement op een toegankelijke ShadowRoot of op het framedocument als dat dezelfde origin heeft. Komt de focus uit op het document zelf, dan geeft de eigenschap eerst body terug, of anders documentElement als dat bestaat. Als er in de opgevraagde boom geen toepasselijk element of terugvalwaarde is, krijg je null.
Focus is geen tekstselectie, en een element opzoeken geeft het geen focus. Als target niet null is, controleert document.activeElement === target of het om hetzelfde knooppunt gaat. Lees de eigenschap na een focuswijziging opnieuw: een opgeslagen waarde werkt zichzelf niet bij. Dit zijn API’s van het webplatform, geen functies van ECMAScript 2024; een runtime zonder browser-DOM hoeft geen document aan te bieden.
Voorbeelden
<!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>Resultaat
true false true true
Sla het voorbeeld op als HTML-bestand, open het in een browsertabblad op de voorgrond en bekijk daarna de browserconsole. Als de browser focus via code toestaat, tonen de eerste drie regels dat het doelelement is gevonden, eerst geen focus heeft en die daarna krijgt. De laatste regel bevestigt dat een andere schrijfwijze met hoofdletters geen overeenkomst oplevert.
Gerelateerde lessen
- JavaScript · Les 18 · Gevorderd · Versie: 4