aboutsummaryrefslogtreecommitdiff
path: root/files/pt-br/web/http/headers/content-language/index.html
blob: 6ba949b262efb19644e650791b742168e6daa67c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
---
title: Content-Language
slug: Web/HTTP/Headers/Content-Language
tags:
  - HTTP
  - Headers
  - Referencia
translation_of: Web/HTTP/Headers/Content-Language
---
<div>{{HTTPSidebar}}</div>

<p>O <a href="/pt-BR/docs/Glossario/Entity_header">cabeçalho de entidade</a> <strong><code>Content-Language</code></strong>  é 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.</p>

<p>Por exemplo, se "<code>Content-Language: de-DE</code>" 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).</p>

<p>Se nenhum <code>Content-Language</code> é 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 <code>Content-Language</code> com varios tipos de mídia e não apenas para documentos de texto.</p>

<table class="properties">
 <tbody>
  <tr>
   <th scope="row">Header type</th>
   <td>{{Glossary("Entity header")}}</td>
  </tr>
  <tr>
   <th scope="row">{{Glossary("Forbidden header name")}}</th>
   <td>não</td>
  </tr>
  <tr>
   <th scope="row">{{Glossary("Simple response header", "CORS-safelisted response-header")}}</th>
   <td>sim</td>
  </tr>
  <tr>
   <th scope="row">{{Glossary("Simple header", "CORS-safelisted request-header")}}</th>
   <td>sim</td>
  </tr>
 </tbody>
</table>

<h2 id="Syntax">Syntax</h2>

<pre class="syntaxbox">Content-Language: de-DE
Content-Language: en-US
Content-Language: de-DE, en-CA
</pre>

<h2 id="Directives">Directives</h2>

<dl>
 <dt><code>language-tag</code></dt>
 <dd>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 ("<code>-</code>", <code>%x2D</code>). 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., "<code>en</code>" = English), que é opcionalmente seguida por uma série de subtags que refinam ou restringem aquele alcance da língua (ex., "<code>en-CA</code>" =  variedade de Inglês como comunicado no Canadá).</dd>
</dl>

<div class="note">
<p><strong>Nota:</strong> Tags de língua são formalmente deifnidas em <a href="https://tools.ietf.org/html/rfc5646">RFC 5646</a>, que depende do padrão <a href="https://en.wikipedia.org/wiki/ISO_639">ISO 639</a> (muitas vezes o <a href="https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes">ISO 639-1 code list</a>) para <a href="https://en.wikipedia.org/wiki/Language_code">language codes</a> serem usados.</p>
</div>

<h2 id="Exemplos">Exemplos</h2>

<h3 id="Indicando_a_língua_que_um_documento_está_escrito">Indicando a língua que um documento está escrito</h3>

<p>O atributo global <code><a href="/en-US/docs/Web/HTML/Global_attributes/lang">lang</a></code> é usado em elementos HTML para indicar a língua de um documento <a href="/en-US/docs/Web/HTML">HTML</a> ou partes dele.</p>

<pre class="brush: html">&lt;html lang="de"&gt;</pre>

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

<pre class="brush: html example-bad">&lt;!-- /!\ Esta prática é ruim --&gt;
&lt;meta http-equiv="content-language" content="de"&gt;</pre>

<h3 id="Indicando_uma_audiência_destinada_para_um_documento">Indicando uma audiência destinada para um documento</h3>

<p>O header <code>Content-Language</code> é usado para especificar a <strong>audiência destinada da página</strong>, e pode indicar que é mais de uma língua.</p>

<pre>Content-Language: de, en</pre>

<h2 id="Especificações">Especificações</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Title</th>
  </tr>
  <tr>
   <td>{{RFC("7231", "Content-Language", "3.1.3.2")}}</td>
   <td>Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>

<p>{{Compat("http.headers.Content-Language")}}</p>

<h2 id="Veja_também">Veja também</h2>

<ul>
 <li>{{HTTPHeader("Accept-Language")}}</li>
 <li>
  <p><a href="https://www.w3.org/International/questions/qa-http-and-lang.en">HTTP headers, meta elements and language information</a></p>
 </li>
</ul>