O que é o atributo lang?
O atributo lang na tag <html> declara o idioma principal do conteúdo da página. Ele informa a navegadores, mecanismos de busca e tecnologias assistivas em que idioma o texto está.
Por que é crítico?
Acessibilidade (requisito WCAG)
- Leitores de tela usam o atributo lang para escolher as regras de pronúncia corretas
- Sem ele, um leitor de tela pode tentar ler texto em português com pronúncia em inglês — tornando o conteúdo incompreensível
- É um requisito WCAG Nível A — o nível mais básico de conformidade de acessibilidade
SEO
- Os mecanismos de busca usam isso para entender o idioma do conteúdo e entregá-lo ao público certo
- É um sinal para SEO internacional e geo-targeting
- Ajuda na indexação correta em resultados de busca específicos por idioma
Recursos do navegador
- Navegadores usam isso para verificação ortográfica no idioma correto
- Sugestões de tradução — O navegador sugere traduzir páginas quando o lang não bate com o idioma do usuário
- Hifenização e renderização de texto — Alguns idiomas exigem tratamento de texto diferente
Como corrigir
Adicione o atributo lang à sua tag <html>:
<html lang="en">
Códigos de idioma comuns
| Código | Idioma |
|---|---|
en |
Inglês |
es |
Espanhol |
fr |
Francês |
de |
Alemão |
pt |
Português |
ja |
Japonês |
zh |
Chinês |
ar |
Árabe |
ko |
Coreano |
it |
Italiano |
Para variantes regionais
<html lang="en-US"> <!-- American English -->
<html lang="en-GB"> <!-- British English -->
<html lang="pt-BR"> <!-- Brazilian Portuguese -->
<html lang="zh-CN"> <!-- Simplified Chinese -->
Boas práticas
- Sempre inclua — Toda página HTML deve ter um atributo lang
- Use o código correto — Códigos de duas letras ISO 639-1
- Combine com o conteúdo — Defina o idioma da maior parte do conteúdo da página
- Use
langem subelementos — Para conteúdo multilíngue:<span lang="fr">Bonjour</span>