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 July 2015.
Please take two minutes to fill out our short survey.
O cabeçalho de entidade Content-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 nenhum Content-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 header Content-Language com varios tipos de mídia e não apenas para documentos de texto.
| Header type | Entity header |
|---|---|
| Forbidden header name | não |
| CORS-safelisted response-header | sim |
| CORS-safelisted request-header | sim |
Syntax
Content-Language: de-DE Content-Language: en-US Content-Language: de-DE, en-CA
Directives
language-tag-
Mú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 em RFC 5646, que depende do padrão ISO 639 (muitas vezes o ISO 639-1 code list) para language codes serem usados.
Exemplos
Indicando a língua que um documento está escrito
O atributo global lang é usado em elementos HTML para indicar a língua de um documento HTML 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 header Content-Language é usado para especificar a audiê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 |