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.
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 |
Compatibilidade com navegadores
BCD tables only load in the browser