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
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.