Consider adding a “lang” attribute to the “html” start tag to declare the language of this document.
Este un avertisment, nu o eroare: documentul nu spune în ce limbă e scris. Adaugă lang="ro" pe elementul html (<html lang="ro">), ca cititoarele de ecran să pronunțe corect textul și browserul să știe ce limbă e.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Validatorul afișează mesajul ca Warning: pagina funcționează, dar îi lipsește o informație importantă. Atributul lang de pe html declară limba principală a documentului.
Ce folosește limba declarată:
- cititoarele de ecran aleg vocea și pronunția (fără
lang, un text românesc poate fi citit cu pronunție englezească); - browserul oferă traducerea corectă și alege regulile de despărțire în silabe pentru
hyphens: auto; - motoarele de căutare înțeleg mai ușor limba paginii;
- unele fonturi și ghilimele (
q) se adaptează limbii.
Validatorul încearcă și să ghicească limba („This document appears to be written in Romanian”) și îți sugerează valoarea potrivită.
De ce apare: cauzele frecvente
1Scheletul paginii fără lang
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"><!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">Atributul stă pe elementul rădăcină și se aplică întregului document.
2Limba greșită, rămasă din șablon
<html lang="en">
...
<p>Bine ai venit!</p><html lang="ro">
...
<p>Bine ai venit!</p>Șabloanele vin des cu lang="en". Validatorul avertizează și atunci: „This document appears to be written in Romanian but the “html” start tag has “lang="en"””.
Repară eroarea, direct în pagină
Validatorul afișează avertismentul „Consider adding a “lang” attribute to the “html” start tag”. Declară limba documentului: elementul html trebuie să aibă lang="ro". Restul paginii rămâne neschimbat.
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Pensiunea Brazilor</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
</style>
</head>
<body>
<h1>Pensiunea Brazilor</h1>
<p>Camere cu vedere spre munte, mic dejun inclus.</p>
</body>
</html>Indiciu
Atributul se pune pe eticheta de deschidere <html>.
Reparația
<!DOCTYPE html>
<html lang="ro">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Pensiunea Brazilor</title>
<style>
body {
font-family: system-ui, Arial, sans-serif;
padding: 20px;
color: #1f2937;
}
</style>
</head>
<body>
<h1>Pensiunea Brazilor</h1>
<p>Camere cu vedere spre munte, mic dejun inclus.</p>
</body>
</html>De ce merge
lang="ro" pe elementul html se aplică întregului document. Cititorul de ecran folosește pronunția românească, browserul nu mai propune traducerea din altă limbă, iar despărțirea automată în silabe folosește regulile limbii române.
Este un atribut mic, dar face parte din scheletul minim al oricărei pagini, alături de meta charset și title.
Alte forme ale mesajului
This document appears to be written in Romanian but the “html” start tag has “lang="en"”. Consider using “lang="ro"” (or variant) instead.
Cum o eviți pe viitor
Pune lang în scheletul de pornire al fiecărei pagini. Când o porțiune de text e în altă limbă (un citat în engleză), marcheaz-o separat: <span lang="en">Hello world</span>. Verifică lang ori de câte ori pornești de la un șablon descărcat sau copiat dintr-un alt proiect.
Întrebări frecvente
Scriu ro sau ro-RO?
Ambele sunt valide. ro ajunge pentru aproape orice site; ro-RO sau ro-MD se folosesc când vrei să precizezi și regiunea.
Ajută la SEO?
Indirect. Google detectează limba și din text, dar lang corect ajută browserul, traducerea automată și accesibilitatea, iar acestea contează pentru experiența vizitatorului.
Erori înrudite
Element “head” is missing a required instance of child element “title”. Orice document HTML trebuie să aibă în head un element title, cu text. Adaugă <title>Numele paginii</title> după meta charset. Titlul apare pe tab-ul browserului și în rezultatele Google. An “img” element must have an “alt” attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images. Fiecare img are nevoie de atributul alt: textul citit de cititoarele de ecran și afișat când imaginea nu se încarcă. Pune o descriere scurtă pentru imaginile cu informație și alt="" (gol) pentru imaginile pur decorative. Î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.
