JavaScript (Vanilla)

Utilice i1n en cualquier proyecto de JavaScript o TypeScript sin necesidad de un framework.

Configuración

Instala i1n como dependencia (npm install i1n) y ejecuta i1n init para configurar tu proyecto. La CLI configura el formato JSON anidado en el directorio locales/.

El SDK de i1n funciona en cualquier entorno de JavaScript o TypeScript: Node.js, navegador, Deno o Bun. No se requieren dependencias de marcos de trabajo ni herramientas de compilación.

Uso

Importe init y t desde i1n. Llame a init() con su configuración regional y recursos de traducción, luego utilice t() para recuperar las cadenas traducidas. Las variables se interpolan con la sintaxis {var}, {{var}} o %{var}.

Utilice setLocale() para cambiar de idioma durante la ejecución. La pluralización es compatible mediante los sufijos de clave _zero, _one y _other. El archivo i1n.d.ts generado proporciona autocompletado completo si utiliza TypeScript.

Modo puente

Si su proyecto ya utiliza una función de traducción personalizada o un sistema de búsqueda, conéctelo con registerI1n((key, params) => yourFunction(key, params)). Esto añade el autocompletado con seguridad de tipos de i1n a cualquier configuración existente.

El Modo Puente funciona con cualquier función que acepte una clave y parámetros opcionales y devuelva una cadena de texto. Esto hace que i1n sea compatible con cualquier solución de i18n personalizada, independientemente del framework.

main.js

import { init, t } from 'i1n'

init({
  locale: 'en_us',
  resources: {
    en_us: { greeting: 'Hello {name}' },
    es_es: { greeting: 'Hola {name}' }
  }
})

t('greeting', { name: 'World' }) // "Hello World"

Bridge Mode — main.js

import { registerI1n } from 'i1n'

// Connect any custom translation function
registerI1n((key, params) => myCustomLookup(key, params))

Relacionado

Panel de control

Guía para el panel web de i1n: creación de cuentas, organizaciones, claves de API, edición de traducciones y gestión de equipos.

Modo puente

Conserve su biblioteca de i18n actual mientras añade el autocompletado con seguridad de tipos, la traducción por IA y la gestión de archivos de i1n.