JavaScript (Vanilla)

Usa i1n in qualsiasi progetto JavaScript o TypeScript senza un framework.

Configurazione

Installa i1n come dipendenza (npm install i1n) ed esegui i1n init per configurare il tuo progetto. La CLI imposta il formato JSON annidato nella directory locales/.

L'SDK i1n funziona in qualsiasi ambiente JavaScript o TypeScript: Node.js, browser, Deno o Bun. Non sono necessarie dipendenze da framework o strumenti di build.

Utilizzo

Importa init e t da i1n. Chiama init() con la tua locale e le risorse di traduzione, quindi usa t() per recuperare le stringhe tradotte. Le variabili vengono interpolate con la sintassi {var}, {{var}} o %{var}.

Usa setLocale() per cambiare lingua in fase di esecuzione. La pluralizzazione è supportata tramite i suffissi di chiave _zero, _one e _other. Il file i1n.d.ts generato fornisce il completamento automatico completo se utilizzi TypeScript.

Modalità Bridge

Se il tuo progetto utilizza già una funzione di traduzione personalizzata o un sistema di lookup, collegalo con registerI1n((key, params) => yourFunction(key, params)). Questo aggiunge il completamento automatico type-safe di i1n a qualsiasi configurazione esistente.

La modalità Bridge funziona con qualsiasi funzione che accetti una chiave e parametri opzionali e restituisca una stringa. Ciò rende i1n compatibile con qualsiasi soluzione i18n personalizzata, indipendentemente dal 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))

Correlato

Cruscotto

Guida alla dashboard web di i1n: creazione account, organizzazioni, chiavi API, modifica traduzioni e gestione del team.

Modalità Bridge

Mantieni la tua libreria i18n esistente aggiungendo l'autocompletamento type-safe, la traduzione AI e la gestione dei file di i1n.