i18n
Funktionen zur Internationalisierung Ihrer Erweiterung. Sie können diese APIs verwenden, um lokalisierte Zeichenfolgen aus mit Ihrer Erweiterung gepackten Lokalisierungsdateien zu erhalten, die aktuelle Sprache des Browsers zu ermitteln und den Wert seines Accept-Language-Headers herauszufinden.
Siehe die Seite Internationalisierung für einen Leitfaden zur Verwendung dieser API.
Typen
i18n.LanguageCode
-
Ein Sprachtag wie
"en-US"
oder"fr"
.
Funktionen
i18n.detectLanguage()
-
Erkennt die Sprache des bereitgestellten Textes mit dem Compact Language Detector.
i18n.getMessage()
-
Ruft die lokalisierte Zeichenfolge für die angegebene Nachricht ab.
i18n.getAcceptLanguages()
-
Holt die accept-languages des Browsers. Dies unterscheidet sich von der vom Browser verwendeten Locale. Um die Locale zu erhalten, verwenden Sie
i18n.getUILanguage
. i18n.getUILanguage()
-
Ermittelt die UI-Sprache des Browsers. Dies unterscheidet sich von
i18n.getAcceptLanguages
, das die bevorzugten Benutzersprachen zurückgibt. i18n.getPreferredSystemLanguages()
-
Gibt die bevorzugten Locales des Betriebssystems zurück.
i18n.getSystemUILanguage()
-
Gibt die aktuelle UI-Locale des Betriebssystems zurück.
Beispielerweiterungen
Browser-Kompatibilität
Hinweis:
Diese API basiert auf Chromiums chrome.i18n
API. Diese Dokumentation wird abgeleitet von i18n.json
im Chromium-Code.
Siehe auch
- Internationalisierung: ein Leitfaden zur Verwendung des WebExtension i18n-Systems.
- Lokale spezifische Nachrichtsreferenz: Erweiterungen liefern sprachspezifische Zeichenfolgen in Dateien namens
messages.json
. Diese Seite beschreibt das Format vonmessages.json
.