i18n
Funciones para internacionalizar su extensión. Es posible utilizar estas API para obtener cadenas de texto traducidas a partir de archivos de configuración regional incluidos en la extensión, conocer el idioma actual del navegador y recuperar el valor de su cabecera Accept-Language.
Para obtener más información sobre el uso de i18n en su extensión, consulte:
- Internacionalización: una guía para utilizar el sistema de l18n de WebExtensions.
- Referencia de mensajes específicos de la configuración regional: las extensiones proporcionan cadenas específicas de la configuración regional en archivos denominados
messages.json
. Esta página describe el formato demessages.json
.
Tipos
i18n.LanguageCode
-
Una etiqueta de idioma como «
en-US
» o «fr
».
Funciones
i18n.getAcceptLanguages()
-
Recupera los valores de accept-language del navegador. Esto es distinto de la configuración regional utilizada por el navegador. Para obtener la configuración regional, utilice
i18n.getUILanguage
. i18n.getMessage()
-
Obtiene la cadena de texto traducida correspondiente al mensaje especificado.
i18n.getUILanguage()
-
Obtiene el idioma de la IU del navegador. Esto es distinto de
i18n.getAcceptLanguages
, que devuelve los idiomas preferidos del usuario. i18n.detectLanguage()
-
Detecta el idioma del texto proporcionado a través de Compact Language Detector.
Compatibilidad con navegadores
BCD tables only load in the browser
Example extensions
Nota: Reconocimientos
Esta API se basa en la API chrome.i18n
de Chromium. Esta documentación deriva del archivo i18n.json
en el código fuente de Chromium.
Los datos de compatibilidad de Microsoft Edge son suministrados por Microsoft Corporation y se incluyen aquí según los términos de la licencia Creative Commons Atribución 3.0, versión estadounidense.