files/ja/web/api/navigatorlanguage/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

---
title: navigator.languages
slug: Web/API/NavigatorLanguage/languages
translation_of: Web/API/NavigatorLanguage/languages
---
<p>{{APIRef}}</p>
<h2 id="Summary" name="Summary">概要</h2>
<p><code><strong>navigator.languages</strong></code> を参照することで、ユーザの使用する言語を表すタグを取得できます。</p>
<h2 id="構文">構文</h2>
<pre class="syntaxbox">preferredLanguages = navigator.languages
</pre>
<h2 id="説明">説明</h2>
<p><code><strong>navigator.languages</strong></code> 属性を参照することで、ユーザが使用する言語の配列を取得できます。この配列は読み取り専用で、各要素は <a href="http://tools.ietf.org/html/bcp47">BCP 47</a> 言語タグです。並び順はユーザの設定した優先度順となっています。この配列の先頭にある、もっとも優先される言語タグは  {{domxref("NavigatorLanguage.language","navigator.language")}} を参照することで取得できます。</p>
<p>Firefox の場合、<code><strong>navigator.languages</strong></code> 属性には、 <code>intl.accept_languages</code> の値が利用されます.</p>
<p>ユーザが言語設定を変更した場合、{{domxref("window")}} に対して <a href="/en-US/docs/Web/Reference/Events/languagechange">languagechange</a> イベントが発生します。</p>
<p>全ての HTTP リクエストの <code>Accept-Language</code> ヘッダは、<strong>qvalues</strong> (quality values) がつくことを除き、 <code><strong>navigator.languages</strong></code> と同じ値でなければなりません。 (例: <code>en-US;q=0.8</code>).</p>
<h2 id="例">例</h2>
<pre class="brush: js">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">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{ SpecName('HTML5 Web application', '#dom-navigator-languages', 'navigator.languages') }}</td>
   <td>{{ Spec2('HTML5.1') }}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>
<h2 id="ブラウザ互換性">ブラウザ互換性</h2>
<p>{{Compat("api.NavigatorLanguage.languages")}}</p>
<h2 id="See_also" name="See_also">関連情報</h2>
<ul>
 <li>{{domxref("NavigatorLanguage.language","navigator.language")}}</li>
 <li>{{domxref("navigator")}}</li>
 <li>{{domxref("window.onlanguagechange")}}</li>
</ul>