lang
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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).
Sintaxe da tag de idioma
A 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
, 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 |
---|
HTML Standard # attr-lang |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também
- Todos atributos globais.