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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Content-Language

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Veja também