lang
O atributo global lang
ajuda a definir o idioma de um elemento: a língua em que elementos não-editáveis são escritos, ou a língua em que elementos editáveis devem ser escritos pelo usuário. O atributo contém uma uma única “tag de idioma” em um formato definido em Tags para identificar linguagens(BCP47).
Experimente
Se o valor do atributo é uma string vazia (lang=""
), o idioma é definido como unknown (desconhecido); se a tag de idioma não é válida conforme o BCP47, ela é definida como invalid (invalida).
Note: ## Sintaxe da tag de idiomaA sintaxe completa do BCP47 é profunda o suficente para caracterizar dialetos de linguagem extremamente expecíficos, mas a maioria dos usos são bem mais simples.Uma tag de idioma é feita de subtags de idioma separadas por hífen, onde cada subtag indica uma certa propriedade da língua. As três subtags mais comuns são:- Subtag de idioma - : Necessária. Um código de 2 ou 3 caracteres que define o idioma base, tipicamente escrita em letras minúsculas. Por exemplo, o código para Inglês é
en
e o código para Português épt
.
- Subtag de script
Opcional. Essa subtag define o sistema de escrita usado para a linguagem, e sempre tem 4 caracteres, com a primeira letra maiúscula. Por exemplo, Francês em Braile é
fr-Brai
eja-Kana
é Japonês escrito no alfabeto Katakana. Se a língua é escrita em uma maneira tipicamente comum, como Inglês no alfabeto Latino, não é necessário o uso da subtag.- Subtag de região
Opcional. Essa subtag define um dialeto do idioma base em uma localização particular e tem um código de duas letras maiúsculas referentes ao país, ou um código de três números referentes à uma área fora do país. Por exemplo,
es-ES
é para espanhol falado na Espanha, ees-013
é o espanhol falado na America Central. “Espanhol Internacional” seriaes
.A subtag de script precede a região da subtag quando ambos estão presentes—ru-Cyrl-BY
é Russo, escrito no alfabeto Cyrillic, falado em Belarus.Para encontrar os códigos corretos para uma subtag de idioma, acesse Language Subtag Lookup.
Mesmo que o atributo lang esteja bem definido ele ainda pode ser ignorado, pois o atributo xml:lang tem prioridade.
Para as pseudo-classes CSS :lang
(en-US), dois nomes de idiomas inválidos são diferentes se seus nomes forem diferentes. Por tanto, enquanto :lang(es)
corresponde a ambos lang="es-ES"
e lang="es-419"
, :lang(xyzzy)
não corresponde a lang="xyzzy-Zorp!"
.
Especificações
Specification | Status | Comment |
---|---|---|
HTML Living Standard The definition of 'lang' in that specification. |
Padrão em tempo real | Sem mudança até o último registro, HTML 5.1 |
HTML 5.1 The definition of 'lang' in that specification. |
Recomendação | Registro de HTML Living Standard, sem mudança para HTML5 |
HTML5 The definition of 'lang' in that specification. |
Recomendação | Registro de HTML Living Standard, comportamento com xml:lang e algoritmo de determinação definido. Ele também é um atributo global. |
HTML 4.01 Specification The definition of 'lang' in that specification. |
Recomendação | Suportado em todos os elementos, mas <applet> , <base> , <basefont> (en-US), <br> , <frame> (en-US), <frameset> (en-US), <iframe> , <param> (en-US) e <script> . |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também
- Todos atributos globais.