blob: bb22f56649038ccd989a90d661bd14e32293f11e (
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
|
---
title: i18n
slug: Mozilla/Add-ons/WebExtensions/API/i18n
tags:
- API
- Add-ons
- Extensions
- Interface
- Non-standard
- Reference
- WebExtensions
- i18n
translation_of: Mozilla/Add-ons/WebExtensions/API/i18n
---
<div>{{AddonSidebar}}</div>
<p>Fonctions permettant d'internationaliser votre extension. Vous pouvez utiliser ces API pour obtenir des chaînes localisées à partir de fichiers locaux conditionnés avec votre extension, connaître la langue actuelle du navigateur et en connaître la valeur de son <a href="/fr/docs/Web/HTTP/Content_negotiation#The_Accept-Language_header">En-tete "Accept-Language"</a>.</p>
<p id="See_also">Pour plus de détails sur l'utilisation de i18n pour votre extension, voir :</p>
<ul>
<li><a href="/fr/Add-ons/WebExtensions/Internationalization">Internationalization</a>: un guide d'utilisation du système WebExtension i18n.</li>
<li><a href="/fr/Add-ons/WebExtensions/API/i18n/Locale-Specific_Message_reference">Référence de message spécifique aux paramètres régionaux </a>: Les extensions fournissent des chaînes de caractères locales dans des fichiers appelés <code>messages.json</code>. Cette page décrit le format de <code>messages.json</code>.</li>
</ul>
<h2 id="Types">Types</h2>
<dl>
<dt>{{WebExtAPIRef("i18n.LanguageCode")}}</dt>
<dd>Une <a href="https://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html#sec3.10">balise de langue</a> telle que <code>"en-US"</code> ou "<code>fr</code>".</dd>
</dl>
<h2 id="Fonctions">Fonctions</h2>
<dl>
<dt>{{WebExtAPIRef("i18n.getAcceptLanguages()")}}</dt>
<dd>Obtient les <a href="/fr/docs/Web/HTTP/Content_negotiation#The_Accept-Language_header">accept-languages</a> du navigateur. Ceci est différent des paramètres régionaux utilisés par le navigateur. Pour obtenir les paramètres régionaux, utilisez {{WebExtAPIRef('i18n.getUILanguage')}}.</dd>
<dt>{{WebExtAPIRef("i18n.getMessage()")}}</dt>
<dd>Obtient la chaîne localisée pour le message spécifié.</dd>
<dt>{{WebExtAPIRef("i18n.getUILanguage()")}}</dt>
<dd>Obtient la langue de l'interface utilisateur du navigateur. Ceci est différent de {{WebExtAPIRef('i18n.getAcceptLanguages')}} qui renvoie les langues utilisateur préférées.</dd>
<dt>{{WebExtAPIRef("i18n.detectLanguage()")}}</dt>
<dd>Détecte la langue du texte fourni en utilisant le <a href="https://github.com/CLD2Owners/cld2">détecteur de langue compact</a>.</dd>
</dl>
<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
<p>{{Compat("webextensions.api.i18n")}}</p>
<p>{{WebExtExamples("h2")}}</p>
<div class="blockIndicator note">
<p><strong>Remerciements</strong><br>
Cette API est basée sur l'API Chromium <a href="https://developer.chrome.com/extensions/i18n"><code>chrome.i18n</code></a>. Cette documentation est dérivée de <a href="https://chromium.googlesource.com/chromium/src/+/master/chrome/common/extensions/api/i18n.json"><code>i18n.json</code></a> dans le code de Chromium.<br>
<br>
Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.</p>
</div>
|
