Content-Language

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 (en-US) sim
CORS-safelisted request-header (en-US) 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
<html lang="de"></html>

Não use este elemento meta como o abaixo para definir a língua de um documento:

html
<!-- /!\ 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

Veja também