Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

HTML-Autofocus-Globaleigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨März 2023⁩.

Die autofocus globale Eigenschaft ist eine Boolean-Eigenschaft, die angibt, ob das Element beim Laden der Seite oder, wenn es sich innerhalb eines <dialog>- oder popover-Elements befindet, fokussiert werden soll, wenn das <dialog> oder Popover angezeigt wird.

html
<input name="q" autofocus />

Nur ein Element innerhalb eines Dokuments, <dialog>-Elements oder Popovers darf diese Eigenschaft angegeben haben. Wenn sie auf mehrere Elemente angewendet wird, erhält das erste fokussierbare Element den Fokus.

Hinweis: Das autofocus-Attribut gilt für alle Elemente, nicht nur für Formularelemente. Zum Beispiel kann es auf einem contenteditable-Bereich verwendet werden.

Hinweis: Wenn beim Laden der Seite ein URI-Fragmentbezeichner angegeben ist und ein Element identifiziert, erhält das Element mit dem autofocus-Attribut keinen Fokus über das autofocus-Attribut. Im Allgemeinen erhält stattdessen das durch das Fragment angezeigte Element den Fokus.

Barrierefreiheitsbedenken

Das automatische Fokussieren eines Formularelements kann sehbehinderten Menschen, die Bildschirmlesetechnologien verwenden, sowie Menschen mit kognitiven Beeinträchtigungen verwirren. Wenn autofocus zugewiesen ist, "teleportieren" Bildschirmleser ihren Benutzer ohne Vorwarnung zum Formularelement.

Berücksichtigen Sie die Barrierefreiheit sorgfältig, wenn Sie das autofocus-Attribut anwenden. Das automatische Fokusieren auf ein Element kann dazu führen, dass die Seite beim Laden scrollt. Der Fokus kann auch dazu führen, dass auf einigen Touchgeräten dynamische Tastaturen angezeigt werden. Während ein Bildschirmleser das Label des fokussierten Formularelements ansagt, wird der Bildschirmleser nichts vor dem Label ansagen, und der sehende Benutzer auf einem kleinen Gerät wird ebenso den Kontext verpassen, den der vorhergehende Inhalt schafft.

Spezifikationen

Specification
HTML
# dom-fe-autofocus

Browser-Kompatibilität