CKTIS / JavaScript
HTMLElement.focus — programmatisch focus instellen
De methode focus() verplaatst de focus naar een element dat deze kan ontvangen. Lees hoe focus verschilt van klikken, hoe de opties voor scrollen en focusaanduiding werken en hoe je het resultaat controleert.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
element.focus();
element.focus({ preventScroll: true });
element.focus({ preventScroll: true, focusVisible: true });HTMLElement.focus stelt de focus in op een element als het die kan ontvangen; er wordt geen klik uitgevoerd. De methode retourneert undefined, geen succesindicator. In een eenvoudig document controleer je het resultaat met document.activeElement === element.
Het element moet focus kunnen ontvangen. Met tabindex="-1" kun je een gewoon element programmatisch focus geven zonder het toe te voegen aan de opeenvolgende Tab-navigatie. focus() omzeilt geen beperkingen voor uitgeschakelde elementen, elementen die door inert inactief zijn gemaakt of elementen die door display: none niet worden weergegeven.
Standaard scrolt de methode het element in beeld; preventScroll: true voorkomt dat scrollen. Gewoonlijk bepaalt de browser of er een focusaanduiding wordt weergegeven. focusVisible: true vraagt om die weergave. Verwijder de zichtbare aanduiding niet zonder een alternatief te bieden.
Dit is een API uit de HTML-standaard, niet uit ECMAScript. Huidige browserengines ondersteunen de basisvorm focus(); controleer de ondersteuning van opties afzonderlijk voor de doelbrowsers. Node 24 bewijst geen ondersteuning van de browser-API. Het voorbeeld roept de methode bewust aan na een gebruikersactie.
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Focus example</title>
<button id="move" type="button">Focus target</button>
<p id="target" tabindex="-1">Target</p>
<pre id="result"></pre>
<script>
const move = document.getElementById('move');
const target = document.getElementById('target');
const result = document.getElementById('result');
move.addEventListener('click', () => {
target.focus({ preventScroll: true });
result.textContent = String(document.activeElement === target);
});
</script>
</html>Resultaat
true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.