blob: 416ffecbc0e1ae9e8e6e0b54dae81e844b6bb809 (
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
|
---
title: NavigatorLanguage.languages
slug: Web/API/NavigatorLanguage/languages
translation_of: Web/API/NavigatorLanguage/languages
---
<p>{{APIRef("HTML DOM")}}{{SeeCompatTable}}</p>
<p>La propriété en lecture seule <code><strong>NavigatorLanguage.languages</strong></code> retourne un tableau de {{domxref("DOMString")}} représentant les langues préférées de l'utilisateur. Les étiquettes de langue utilisent les étiquettes de langages défini par <a href="http://tools.ietf.org/html/bcp47">BCP 47</a>. Le tableau retourné est trié par ordre de préférence décroissante (la langue préférée en premier).</p>
<p>La valeur de {{domxref("NavigatorLanguage.language","navigator.language")}} est le premier élément du tableau retourné.</p>
<p>Quant la valeur change, notamment lorsque l'utilisateur modifie ses préférences de langues, un événement {{event("languagechange")}} est déclenché sur l'objet {{domxref("Window")}}.</p>
<p>L'entête HTTP <code>Accept-Language</code> présent dans chaque requête HTTP issu de la navigation de l'utilisateur contient les mêmes valeurs que <code>navigator.languages</code>, avec en plus un champ <code>qvalues</code> (<em>valeur de qualité</em>), par exemple: <code>en-US;q=0.8</code>.</p>
<h2 id="Syntaxe">Syntaxe</h2>
<pre class="syntaxbox notranslate"><em>preferredLanguages</em> = <em>globalObj</em>.navigator.languages
</pre>
<h2 id="Exemples">Exemples</h2>
<pre class="brush: js notranslate">navigator.language //"en-US"
navigator.languages //["en-US", "zh-CN", "ja-JP"]
</pre>
<h2 id="Spécifications">Spécifications</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Spécifications</th>
<th scope="col">Status</th>
<th scope="col">Commentaire</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName('HTML WHATWG', '#dom-navigator-languages', 'NavigatorLanguage: languages')}}</td>
<td>{{Spec2('HTML WHATWG')}}</td>
<td>Définition initiale</td>
</tr>
</tbody>
</table>
<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
<p>{{Compat("api.NavigatorLanguage.languages")}}</p>
<h2 id="See_also" name="See_also">Voir aussi</h2>
<ul>
<li>{{domxref("NavigatorLanguage.language","navigator.language")}}</li>
<li>{{domxref("Navigator")}}</li>
<li>{{domxref("Window.onlanguagechange")}}</li>
</ul>
|
