...
Eroare HTML și CSS · Lighthouse: accesibilitate, SEO și performanță

`<frame>` or `<iframe>` elements do not have a title

Pe scurt

Lighthouse îți spune că un iframe (hartă, video, formular încorporat) nu are atributul title. Cititoarele de ecran anunță doar „cadru”, fără să spună ce conține, iar utilizatorul nu știe dacă merită să intre în el. Adaugă title="..." cu o descriere scurtă a conținutului, de exemplu title="Harta magazinului".

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

Ce înseamnă

Un iframe este o pagină în pagină. Când un utilizator de cititor de ecran ajunge la el, cititorul anunță numele cadrului, luat din atributul title. Fără title, aude doar „frame” sau adresa, deci nu știe ce e acolo: o hartă, un video, un formular de plată sau o reclamă.

Auditul (din categoria Accesibilitate) listează fiecare iframe fără nume accesibil. Codurile de încorporare copiate de la Google Maps, OpenStreetMap sau unele formulare externe vin adesea fără title; YouTube îl pune automat cu titlul video-ului.

Titlul trebuie să fie scurt și unic pe pagină, să descrie conținutul, nu tehnologia: „Harta: Strada Lungă 10, Brașov”, nu „iframe” sau „Google Maps”. aria-label funcționează și el, dar title este varianta obișnuită.

De ce apare: cauzele frecvente

1Hartă încorporată fără title

Greșit
HTML
<iframe src="https://www.google.com/maps/embed?pb=..."></iframe>
Corect
HTML
<iframe src="https://www.google.com/maps/embed?pb=..." title="Harta: Strada Lungă 10, Brașov"></iframe>

Cu title, cititorul de ecran anunță „Harta: Strada Lungă 10, Brașov, cadru”, iar utilizatorul poate decide dacă intră.

2Titlu generic

Greșit
HTML
<iframe src="video.html" title="iframe"></iframe>
Corect
HTML
<iframe src="video.html" title="Video: cum se prepară cafeaua la ibric"></iframe>

Lighthouse acceptă orice text, dar utilizatorului îi folosește doar o descriere a conținutului.

3Mai multe iframe-uri cu același title

Greșit
HTML
<iframe src="harta-cluj.html" title="Harta"></iframe>
<iframe src="harta-iasi.html" title="Harta"></iframe>
Corect
HTML
<iframe src="harta-cluj.html" title="Harta magazinului din Cluj"></iframe>
<iframe src="harta-iasi.html" title="Harta magazinului din Iași"></iframe>

Titlurile identice nu-l ajută pe utilizator să le deosebească. Fă-le unice.

Repară tu

Repară eroarea, direct în pagină

Lighthouse → Accessibility raportează „<frame> or <iframe> elements do not have a title” pentru harta de pe pagina de contact. Adaugă iframe-ului titlul Harta: Strada Lungă 10, Brașov.

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>Contact</title>
    <style>
      body {
        font-family: system-ui, Arial, sans-serif;
        padding: 20px;
        color: #1f2937;
      }

      iframe {
        width: 100%;
        height: 300px;
        border: 0;
      }
    </style>
  </head>
  <body>
    <h1>Unde ne găsești</h1>
    <p>Strada Lungă 10, Brașov.</p>
    <iframe src="https://www.openstreetmap.org/export/embed.html?bbox=25.58%2C45.64%2C25.60%2C45.65" loading="lazy"></iframe>
  </body>
</html>
Indiciu

Atributul se numește chiar ca auditul.

Alte forme ale mesajului

  • Frames must have an accessible name
  • Frames should have a unique title attribute

Cum o eviți pe viitor

  • Adaugă title imediat ce lipești un cod de încorporare.
  • Descrie conținutul, nu sursa: „Video: ...”, „Harta: ...”, „Formular de abonare”.
  • Fă titlurile unice pe pagină.
  • Rulează Lighthouse → Accessibility pe paginile cu hărți și video-uri.

Întrebări frecvente

Iframe-ul nu se vede deloc (pixel de urmărire). Și el are nevoie de title?

Un iframe ascuns cu display: none nu e citit, deci nu e raportat. Dacă e vizibil pentru cititoare, pune-i aria-hidden="true" sau un titlu, ori folosește alt mecanism de încărcare.

Contează title pentru SEO?

Nu direct. E un atribut de accesibilitate, dar ajută și la înțelegerea paginii de către oricine citește codul.

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.