WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

onfocus — Reaktion auf den Erhalt des Fokus

Das Attribut onfocus enthält JavaScript, das ausgeführt wird, wenn ein focus-Ereignis empfangen wird. Damit lässt sich reagieren, wenn ein Eingabefeld den Fokus erhält; das Attribut allein macht ein Element jedoch nicht fokussierbar.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

onfocus="JavaScript statements"

onfocus ist ein Ereignisbehandlungsattribut für focus. Sein Wert ist der Funktionskörper von JavaScript, nicht ein Ereignisname oder ein boolescher Wert. Bei body und frameset behandelt es den Fokus des Window-Objekts und nicht den des Elements selbst.

Der Fokus bestimmt, wohin Tastatureingaben gehen. Ein Eingabefeld kann ihn durch die Tab-Navigation oder mit focus() erhalten. onfocus allein macht ein Element nicht fokussierbar. Das focus-Ereignis sprudelt nicht nach oben und kann nicht abgebrochen werden; return false verhindert nicht, dass der Fokus gesetzt wird.

Das HTML-Attribut und die JavaScript-Eigenschaft element.onfocus richten denselben Handler ein. Die Content Security Policy kann Code blockieren, der direkt im Attribut steht. Füge darin nicht nicht vertrauenswürdigen Text als Code ein.

Im Beispiel kannst du den Fokus mit der Tabulatortaste zum Eingabefeld bewegen. Der Text Waiting wird zu Focused. Sorge dafür, dass der Fokus sichtbar bleibt, damit Tastaturnutzende das aktive Element erkennen können.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onfocus example</title>
<label for="name">Name</label>
<input id="name" onfocus="document.getElementById('status').textContent = 'Focused';">
<p id="status">Waiting</p>
</html>

Ergebnis

Focused

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.

Quellen