CKTIS / JavaScript
HTMLElement.focus — Fokus programmatisch setzen
Die Methode focus() verschiebt den Fokus auf ein Element, das ihn empfangen kann. Erfahre, worin sich Fokus und Klicken unterscheiden, wie die Optionen für Scrollen und Fokusanzeige funktionieren und wie du das Ergebnis überprüfst.
Version: 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 setzt den Fokus auf ein Element, sofern es ihn empfangen kann; ein Klick wird dadurch nicht ausgeführt. Die Methode gibt undefined zurück und keinen Erfolgsindikator. In einem einfachen Dokument kannst du das Ergebnis mit document.activeElement === element prüfen.
Das Element muss fokussierbar sein. tabindex="-1" macht ein gewöhnliches Element programmatisch fokussierbar, ohne es in die sequenzielle Tab-Navigation aufzunehmen. focus() umgeht keine Einschränkungen für deaktivierte Elemente, durch inert inaktive Elemente oder wegen display: none nicht dargestellte Elemente.
Standardmäßig scrollt die Methode das Element in den sichtbaren Bereich; preventScroll: true verhindert dieses Scrollen. Ob eine Fokusanzeige erscheint, entscheidet normalerweise der Browser. focusVisible: true fordert ihre Anzeige an. Entferne die sichtbare Anzeige nicht, ohne eine Alternative bereitzustellen.
Dies ist eine API des HTML-Standards, nicht von ECMAScript. Das grundlegende focus() wird von aktuellen Browser-Engines unterstützt; prüfe die Unterstützung der Optionen für die Zielbrowser separat. Node 24 belegt keine Unterstützung der Browser-API. Das Beispiel ruft die Methode bewusst nach einer Nutzeraktion auf.
Beispiele
<!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>Ergebnis
true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.