Marque no HTML somente o trecho em outro idioma
O idioma principal é declarado no elemento <html>, por exemplo <html lang="pt-BR">. Se uma frase ou passagem deliberadamente escrita em outro idioma estiver dentro do texto, marque esse trecho com um idioma BCP 47 válido. Leitores de tela e outras tecnologias podem então aplicar regras de pronúncia adequadas.
<p>O cliente descreveu o processo como
<q lang="en">customer journey</q> na reunião.
</p>
<p>Em francês, a expressão <span lang="fr">faux pas</span>
mantém sua pronúncia original.
</p>Se um parágrafo inteiro estiver em outro idioma, marque o <p> inteiro. Para citações, mantenha também o elemento semântico <q> ou <blockquote>; lang fornece informação de idioma, não substitui a semântica.
Escolha e confira a etiqueta
- Determine o idioma humano do texto (não apenas o país, teclado ou alfabeto) e use uma etiqueta válida, como
en,en-US,froues-MX. - Aplique
langao menor elemento que contém a frase completa em outro idioma; não altere o idioma da página inteira por causa de uma citação. - Inspecione o DOM gerado para confirmar a herança:
langpode ser colocado no elemento de bloco ou em um<span>interno. - Teste a pronúncia com leitor de tela ou síntese de voz que ofereça o idioma marcado e esteja configurada para alternar voz. Suporte a vozes varia por sistema.
- Valide a etiqueta com uma referência de etiquetas de idioma; evite códigos inventados e códigos de país usados como idioma.
Quando a marcação pode não ser necessária
O critério WCAG 3.1.2 prevê exceções para nomes próprios, termos técnicos, palavras de idioma indeterminado e termos incorporados ao idioma ao redor. Uma palavra estrangeira isolada nem sempre precisa ser marcada se já se tornou uso comum no contexto. Quando a mudança de idioma for deliberada e a pronúncia correta importar, marque-a.