Fonctions pour internationaliser votre extension. Vous pouvez utiliser ces API pour obtenir des chaînes localisées à partir des fichiers de locale fournis avec votre extension, connaître la langue actuelle du navigateur et connaître la valeur de son En-tete Accept-Language.

Pour plus de détails sur l'utilisation de i18n pour votre extension, voir:

Types

i18n.LanguageCode
Une balise de langue telle que "en-US" ou "fr".

Fonctions

i18n.getAcceptLanguages()
Obtient les accept-languages Ceci est différent des paramètres régionaux utilisés par le navigateur. Pour obtenir les paramètres régionaux, utilisez  i18n.getUILanguage.
i18n.getMessage()
Obtient la chaîne localisée pour le message spécifié.
i18n.getUILanguage()
Obtient la langue de l'interface utilisateur du navigateur. Ceci est différent de  i18n.getAcceptLanguages qui renvoie les langues utilisateur préférées.
i18n.detectLanguage()
Détecte la langue du texte fourni en utilisant le détecteur de langue compact.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
LanguageCodeChrome Support complet 47Edge Support complet 14Firefox Support complet 45Opera Support complet 34Firefox Android Support complet 48
detectLanguageChrome Support complet 47Edge Aucun support NonFirefox Support complet 47Opera Support complet 34Firefox Android Support complet 48
getAcceptLanguagesChrome Support complet 47Edge Support complet 14Firefox Support complet 47Opera Support complet 34Firefox Android Support complet 48
getMessageChrome Support complet 17Edge Support complet 14
Notes
Support complet 14
Notes
Notes Throws an exception instead returning an empty string if the message does not exist.
Notes Expects substitutions to be strings, while other browsers allow any value which is then converted to a string.
Firefox Support complet 45
Notes
Support complet 45
Notes
Notes Firefox 47 and earlier returns "??" instead of "" if the message is not found in _locales, bug 1258199 changed this act to match Chrome, landed on Firefox 48.
Opera Support complet 15Firefox Android Support complet 48
getUILanguageChrome Support complet 35Edge Support complet 14Firefox Support complet 47Opera Support complet OuiFirefox Android Support complet 48

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Example extensions

Remerciements :

Cette API est basée sur l'API Chromium chrome.i18n. Cette documentation est dérivée de i18n.json dans le code de Chromium code.

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.

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,