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 e ja-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, e es-013 é o espanhol falado na America Central. "Espanhol Internacional" seria es.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
# attr-lang

Compatibilidade com navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
lang

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Veja também