files/ja/web/api/navigator/languages/index.html


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

---
title: Navigator.languages
slug: Web/API/Navigator/languages
tags:
  - API
  - Experimental
  - Navigator
  - Property
  - Read-only
  - Reference
  - languages
browser-compat: api.Navigator.languages
translation_of: Web/API/Navigator/languages
original_slug: Web/API/NavigatorLanguage/languages
---
<p>{{APIRef("HTML DOM")}}{{SeeCompatTable}}</p>

<p><code><strong>navigator.languages</strong></code> は読み取り専用プロパティで、ユーザーの推奨される言語を表す {{domxref("DOMString")}} の配列を返します。この言語は <a href="http://tools.ietf.org/html/bcp47">BCP 47</a> 言語タグを使用して記述されています。返された配列の中では、設定で最も推奨される言語が最初に来るように並べられています。</p>

<p>{{domxref("Navigator.language","navigator.language")}} の値は返される配列の最初の要素です。</p>

<p>この値を変更すると、ユーザーの推奨言語が変更され、 {{event("languagechange")}} イベントが {{domxref("Window")}} オブジェクトに発行されます。</p>

<p>ユーザーのブラウザーからのすべての HTTP リクエストにある <code>Accept-Language</code> ヘッダーは、 <code>navigator.languages</code> プロパティと同じ値ですが、拡張された <code>qvalues</code> (quality values) フィールドのみが異なります (例えば <code>en-US;q=0.8</code>)。
</p>

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

<pre class="brush: js"><em>preferredLanguages</em> = <em>globalObj</em>.navigator.languages
</pre>

<h2 id="Examples">例</h2>

<pre class="brush: js">navigator.language   //"en-US"
navigator.languages  //["en-US", "zh-CN", "ja-JP"]
</pre>

<h2 id="Specifications">仕様書</h2>

{{Specifications}}

<h2 id="Browser_compatibility">ブラウザーの互換性</h2>

<p>{{Compat}}</p>

<h2 id="See_also">関連情報</h2>

<ul>
  <li>{{domxref("navigator.language")}}</li>
  <li>{{domxref("navigator")}}</li>
  <li>{{domxref("Window.onlanguagechange")}}</li>
</ul>