`<frame>` or `<iframe>` elements do not have a title
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
<iframe src="https://www.google.com/maps/embed?pb=..."></iframe><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
<iframe src="video.html" title="iframe"></iframe><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
<iframe src="harta-cluj.html" title="Harta"></iframe>
<iframe src="harta-iasi.html" title="Harta"></iframe><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ă 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.
<!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.
Reparația
<!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" title="Harta: Strada Lungă 10, Brașov" loading="lazy"></iframe>
</body>
</html>De ce merge
Fără title, cititorul de ecran anunța doar un cadru fără nume, iar utilizatorul nu avea de unde ști că e o hartă.
Cu title="Harta: Strada Lungă 10, Brașov", cadrul are un nume accesibil care spune exact ce conține. Lighthouse nu mai raportează problema, iar harta arată la fel.
Alte forme ale mesajului
Frames must have an accessible nameFrames should have a unique title attribute
Cum o eviți pe viitor
- Adaugă
titleimediat 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
Buttons do not have an accessible name Lighthouse a găsit butoane (sau linkuri) care au doar o iconiță, fără text. Cititorul de ecran anunță doar „buton”, fără să spună ce face. Dă-i un nume: aria-label="Coșul de cumpărături" pe buton, un text ascuns vizual sau un alt descriptiv pe imaginea din el. Refused to display 'https://www.youtube.com/' in a frame because it set 'X-Frame-Options' to 'sameorigin'. Ai pus într-un <iframe> o pagină care nu permite să fie afișată în alte site-uri; în locul ei apare „refused to connect”. La YouTube și Google Maps, folosește adresa de embed (youtube.com/embed/ID, codul din Share → Embed), nu adresa din bara de adrese. Allow attribute will take precedence over 'allowfullscreen'. Iframe-ul are și atributul vechi allowfullscreen, și atributul nou allow, iar Chrome te anunță că regulile din allow au prioritate. E doar un avertisment: video-ul merge. Ca să scapi de el, pune fullscreen în lista din allow și șterge allowfullscreen. Î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.
