...
Eroare HTML și CSS · Formulare și avertismentele [DOM]

Autofocus processing was blocked because a document already has a focused element.

Pe scurt

Pagina are mai multe elemente cu autofocus (sau un element primise deja focus), iar browserul pune focusul doar pe primul și le ignoră pe celelalte. De aceea cursorul nu ajunge în câmpul dorit. Lasă autofocus pe un singur element pe pagină, cel în care utilizatorul chiar trebuie să scrie primul.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Atributul autofocus mută cursorul într-un câmp imediat ce se încarcă pagina. Un document poate avea un singur element focalizat odată, așa că browserul procesează doar primul autofocus găsit. Pentru celelalte, sau pentru unul întâlnit după ce utilizatorul sau un script au mutat deja focusul, Chrome scrie mesajul în consolă și nu face nimic.

Cazul clasic: șablonul site-ului are autofocus pe căutarea din header, iar pagina de autentificare îl are pe câmpul de e-mail. Căutarea apare prima în cod, deci primește focusul, iar câmpul de e-mail nu. Același lucru se întâmplă cu un autofocus dintr-un conținut adăugat ulterior cu JavaScript, de exemplu într-o fereastră modală.

Pentru câmpurile care apar mai târziu, folosește element.focus() din JavaScript, în momentul în care se afișează.

De ce apare: cauzele frecvente

1autofocus în header și în formular

Greșit
HTML
<input type="search" name="q" autofocus>
...
<input type="email" id="email" name="email" autofocus>
Corect
HTML
<input type="search" name="q">
...
<input type="email" id="email" name="email" autofocus>

Cu un singur autofocus, browserul pune cursorul exact în câmpul de e-mail.

2autofocus în conținut adăugat mai târziu

Greșit
HTML
modal.innerHTML = '<input id="cod" autofocus>';
modal.hidden = false;
Corect
HTML
modal.innerHTML = '<input id="cod">';
modal.hidden = false;
document.querySelector("#cod").focus();

După încărcare, autofocus nu mai este garantat. Un apel focus() la afișarea ferestrei e sigur.

3Script care mută focusul înainte

Greșit
HTML
document.querySelector("#cautare").focus();
<!-- iar mai jos: <input id="email" autofocus> -->
Corect
HTML
<input id="email" autofocus>
<!-- fără focus() pe alt element la încărcare -->

Dacă un script a pus focusul în altă parte, autofocus nu mai are voie să-l mute. Alege un singur mecanism.

Repară tu

Repară eroarea, direct în pagină

Pe pagina de autentificare, cursorul ar trebui să apară în câmpul de e-mail, dar ajunge în căutarea din header, iar consola arată „Autofocus processing was blocked because a document already has a focused element.”. Lasă autofocus doar pe câmpul #email.

Codul care dă eroarea
HTML
<!DOCTYPE html>
<html lang="ro">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Autentificare</title>
    <style>
      body {
        font-family: system-ui, Arial, sans-serif;
        padding: 20px;
        color: #1f2937;
      }

      label {
        display: block;
        margin-top: 8px;
      }

      input {
        padding: 8px;
        font: inherit;
      }
    </style>
  </head>
  <body>
    <header>
      <input type="search" id="cautare" name="q" placeholder="Caută în magazin" aria-label="Caută în magazin" autofocus>
    </header>
    <main>
      <form action="/login" method="post">
        <label for="email">E-mail</label>
        <input type="email" id="email" name="email" autocomplete="username" autofocus>
        <label for="parola">Parola</label>
        <input type="password" id="parola" name="parola" autocomplete="current-password">
        <button type="submit">Intră în cont</button>
      </form>
    </main>
  </body>
</html>
Indiciu

Browserul folosește doar primul autofocus din pagină.

Alte forme ale mesajului

  • Autofocus processing was blocked because a document's URL has a fragment '#contact'.
  • Blocked autofocusing on a <input> element in a cross-origin subframe.

Cum o eviți pe viitor

  • Folosește autofocus cel mult o dată pe pagină, în câmpul principal (căutarea pe pagina de căutare, e-mailul la autentificare).
  • Nu pune autofocus în șabloanele comune (header, footer).
  • Pentru ferestre modale și conținut dinamic, folosește element.focus().
  • Pe telefon, autofocus deschide tastatura; folosește-l doar unde chiar ajută.

Întrebări frecvente

De ce primește focus căutarea, nu e-mailul?

Pentru că browserul îl procesează pe primul din document. Căutarea din header apare în cod înaintea formularului, deci câștigă ea.

E o problemă de accesibilitate?

Poate fi: autofocus sare peste conținutul de deasupra câmpului pentru utilizatorii de cititoare de ecran. Folosește-l doar pe paginile al căror scop e chiar acel câmp.

Erori înrudite

← Toate erorile HTML și CSS

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață HTML și CSS de la zero, cu exerciții la fiecare lecție

Curs HTML & CSS: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.