blob: 7378d105fa4f5c23e7f39224f04e181a54c8f186 (
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
|
---
title: NavigatorLanguage.languages
slug: Web/API/NavigatorLanguage/languages
tags:
- API
- languages
- 只读
- 实验性
- 属性
translation_of: Web/API/NavigatorLanguage/languages
---
<p>{{APIRef("HTML DOM")}}{{SeeCompatTable}}</p>
<p><code><strong>NavigatorLanguage.languages </strong></code>只读属性 ，返回一个 {{domxref("DOMString")}} 的数组，数组内容表示网站访客所使用的语言。 使用 <a href="http://tools.ietf.org/html/bcp47">BCP 47</a> 语言标签来描述不同的语言。 在返回的数组中，最适合当前用户的语言将会被排到数组的首位。</p>
<p>{{domxref("NavigatorLanguage.language","navigator.language")}} 的值是该属性返回数组的第一个元素 [3]。（但它基于系统语言设置。）</p>
<p>当该值发生改变，即最适合用户的语言被改变， 事件{{event("languagechange")}} 将会在 {{domxref("Window")}} 对象下触发。</p>
<p>在每一个HTTP请求上的来自用户浏览器的HTTP协议头 <code>Accept-Language</code> 使用相同的来自 <code>navigator.languages</code> 属性的语言值，除了特殊的 <code>qvalues</code> （权重值） 字段 （如：<code>en-US;q=0.8）。</code></p>
<h2 id="语法">语法</h2>
<pre class="syntaxbox notranslate"><em>preferredLanguages</em> = <em>globalObj</em>.navigator.languages
</pre>
<h2 id="例子">例子</h2>
<pre class="brush: js notranslate">navigator.language //"en-US"
navigator.languages //["en-US", "zh-CN", "ja-JP"]
</pre>
<h2 id="标准">标准</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">标准</th>
<th scope="col">状态</th>
<th scope="col">备注</th>
</tr>
<tr>
<td>{{ SpecName('HTML5.1', '#dom-navigator-languages', 'NavigatorLanguage.languages') }}</td>
<td>{{ Spec2('HTML5.1') }}</td>
<td>
<p>初始化定义</p>
</td>
</tr>
</tbody>
</table>
<h2 id="浏览器兼容性">浏览器兼容性</h2>
<p>{{Compat("api.NavigatorLanguage.languages")}}</p>
<h2 id="参见">参见</h2>
<ul>
<li>{{domxref("NavigatorLanguage.language","navigator.language")}}</li>
<li>{{domxref("Navigator")}}</li>
<li>{{domxref("Window.onlanguagechange")}}</li>
</ul>
|
