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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
---
title: NavigatorLanguage.language
slug: Web/API/NavigatorLanguage/language
translation_of: Web/API/NavigatorLanguage/language
---
<div>{{APIRef("HTML DOM")}}</div>
<p>A propriedade <strong><code>NavigatorLanguage.language</code></strong> retorna uma string representando a língua de preferência do usuário, normalmente a língua da interface do navegador.</p>
<h2 id="Sintaxe">Sintaxe</h2>
<pre class="syntaxbox">var <em>lang</em> = navigator.language
</pre>
<h3 id="Valor">Valor</h3>
<p>Uma {{domxref("DOMString")}} <em><code>lang</code></em> armazena a string representando a língua como definida em <a class="external" href="http://www.ietf.org/rfc/bcp/bcp47.txt">BCP 47</a>. Exemplos de códigos de línguas válidos incluem "en", "en-US", "fr", "fr-FR", "es-ES", etc.</p>
<p>Atente-se que no Safari no macOS e iOS antes da versão 10.2, o código do país é retornado em caixa baixa: "en-us", "fr-fr" etc.</p>
<h2 id="Exemplo">Exemplo</h2>
<pre class="brush: js">if (window.navigator.language != 'en') {
doLangSelect(window.navigator.language);
}
</pre>
<h2 id="Specifications">Specifications</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Specification</th>
<th scope="col">Status</th>
<th scope="col">Comentários</th>
</tr>
<tr>
<td>{{ SpecName('HTML5.1', '#dom-navigator-language', 'NavigatorLanguage.language') }}</td>
<td>{{ Spec2('HTML5.1') }}</td>
<td>Definição inicial</td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>
<p>{{CompatibilityTable}}</p>
<div id="compat-desktop">
<table class="compat-table">
<tbody>
<tr>
<th>Feature</th>
<th>Chrome</th>
<th>Edge</th>
<th>Firefox (Gecko)</th>
<th>Internet Explorer</th>
<th>Opera</th>
<th>Safari</th>
</tr>
<tr>
<td>Suporte básico</td>
<td>{{CompatVersionUnknown}}<sup>[1]</sup></td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoDesktop("1.0")}}<sup>[2]</sup><br>
{{CompatGeckoDesktop("5.0")}}<sup>[3]</sup></td>
<td>11.0<sup>[4]</sup></td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
</tr>
<tr>
<td>on {{domxref("WorkerNavigator")}}</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatGeckoDesktop("35")}}</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatUnknown}}</td>
</tr>
</tbody>
</table>
</div>
<div id="compat-mobile">
<table class="compat-table">
<tbody>
<tr>
<th>Feature</th>
<th>Android</th>
<th>Edge</th>
<th>Firefox Mobile (Gecko)</th>
<th>IE Mobile</th>
<th>Opera Mobile</th>
<th>Safari Mobile</th>
</tr>
<tr>
<td>Suporte básico</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatGeckoMobile(1.0)}}</td>
<td>{{CompatNo}}<sup>[4]</sup></td>
<td>{{CompatVersionUnknown}}</td>
<td>{{CompatVersionUnknown}}</td>
</tr>
<tr>
<td>on {{domxref("WorkerNavigator")}}</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatGeckoDesktop("35")}}</td>
<td>{{CompatNo}}</td>
<td>{{CompatUnknown}}</td>
<td>{{CompatUnknown}}</td>
</tr>
</tbody>
</table>
</div>
<p>[1] Retorna a língua da interface do browser, não o valor do <a href="/en-US/docs/Web/HTTP/Headers">HTTP header</a> <code>Accept-Language</code> .</p>
<p>[2] Antes do Gecko 2.0 {{geckoRelease("2.0")}}, o valor dessa propriedade também fazia parte da string de user agent, como reportado em {{domxref("window.navigator.userAgent", "navigator.userAgent")}}.</p>
<p>[3] Começando no Gecko 5.0 {{geckoRelease("5.0")}}, o valor dessa propriedade é baseado no valor do <a href="/en-US/docs/Web/HTTP/Headers">HTTP header</a> <code>Accept-Language</code>.</p>
<p>[4] As propriedades (não padronizadas) mais próximas disponíveis são <code><a href="http://msdn.microsoft.com/en-us/library/ie/ms534713.aspx">userLanguage</a></code> e <code><a href="http://msdn.microsoft.com/en-us/library/ie/ms533542.aspx">browserLanguage</a></code>.</p>
<h2 id="Veja_também">Veja também</h2>
<ul>
<li>{{domxref("NavigatorLanguage.languages", "navigator.languages")}}</li>
<li>{{domxref("navigator")}}</li>
</ul>
|
