Esta página foi traduzida do inglês pela comunidade.Saiba mais e junte-se à comunidade MDN Web Docs.
Content-Language
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
Ocabeçalho de entidadeContent-Language é usado para descrever a língua(s) destinada para a audiência, para que isto permita um usuário de se diferenciar de acordo com a língua preferida do usuário.
Por exemplo, se "Content-Language: de-DE" está selecionado, você diz que o documento é destinado para quem fala Alemão (no entanto, não indica que o documento é escrito em Alemão. Por exemplo, pode ser escrito em Inglês como parte de um curso de línguas para fluentes em Alemão).
Se nenhumContent-Language é especificado, o padrão é que o conteúdo é destinado para todas as línguas. Múltiplas tags de língua também podem ser usada, assim como usar o headerContent-Language com varios tipos de mídia e não apenas para documentos de texto.
Syntax
Content-Language: de-DEContent-Language: en-USContent-Language: de-DE, en-CA
Directives
language-tagMúltiplas tags de línguas são separadas por uma vírgula. Cada tag de língua é uma sequencia de uma ou mais subtags insensitíveis, cada uma separada por um hífen ("
-",%x2D). Na maioria dos casos, uma tag de língua consiste de uma tag de língua primária que identifica uma família ampla de outras línguas (ex., "en" = English), que é opcionalmente seguida por uma série de subtags que refinam ou restringem aquele alcance da língua (ex., "en-CA" = variedade de Inglês como comunicado no Canadá).
Nota:Tags de língua são formalmente deifnidas emRFC 5646, que depende do padrãoISO 639 (muitas vezes oISO 639-1 code list) paralanguage codes serem usados.
Exemplos
Indicando a língua que um documento está escrito
O atributo globallang é usado em elementos HTML para indicar a língua de um documentoHTML ou partes dele.
<html lang="de"></html>Não use este elemento meta como o abaixo para definir a língua de um documento:
<!-- /!\ Esta prática é ruim --><meta http-equiv="content-language" content="de" />Indicando uma audiência destinada para um documento
O headerContent-Language é usado para especificar aaudiência destinada da página, e pode indicar que é mais de uma língua.
Content-Language: de, en
Especificações
| Specification | Title |
|---|---|
| RFC 7231, sessão 3.1.3.2: Content-Language | Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content |