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 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">

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 de browser

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Content-LanguageChrome Full support YesEdge Full support YesFirefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support  
Full support

Veja também