JavaScript (Vanilla)

Verwenden Sie i1n in jedem JavaScript- oder TypeScript-Projekt ohne Framework.

Einrichtung

Installieren Sie i1n als Abhängigkeit (npm install i1n) und führen Sie i1n init aus, um Ihr Projekt zu konfigurieren. Die CLI richtet das verschachtelte JSON-Format im Verzeichnis locales/ ein.

Das i1n SDK funktioniert in jeder JavaScript- oder TypeScript-Umgebung — Node.js, Browser, Deno oder Bun. Es sind keine Framework- oder Build-Tool-Abhängigkeiten erforderlich.

Verwendung

Importieren Sie init und t von i1n. Rufen Sie init() mit Ihrer Locale und den Übersetzungsressourcen auf und verwenden Sie dann t(), um übersetzte Strings abzurufen. Variablen werden mit der Syntax {var}, {{var}} oder %{var} interpoliert.

Verwenden Sie setLocale(), um Sprachen zur Laufzeit zu wechseln. Die Pluralisierung wird über die Schlüssel-Suffixe _zero, _one und _other unterstützt. Die generierte i1n.d.ts-Datei bietet eine vollständige Autovervollständigung, wenn Sie TypeScript verwenden.

Bridge-Modus

Wenn Ihr Projekt bereits eine benutzerdefinierte Übersetzungsfunktion oder ein Nachschagesystem verwendet, verbinden Sie es mit registerI1n((key, params) => yourFunction(key, params)). Dies fügt die typsichere Autovervollständigung von i1n zu jeder vorhandenen Einrichtung hinzu.

Der Brückenmodus funktioniert mit jeder Funktion, die einen Schlüssel und optionale Parameter entgegennimmt und einen String zurückgibt. Dies macht i1n mit jeder benutzerdefinierten i18n-Lösung kompatibel, unabhängig vom 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))

Verwandt

Armaturenbrett

Leitfaden für das i1n-Web-Dashboard: Kontoerstellung, Organisationen, API-Schlüssel, Übersetzungsbearbeitung und Teamverwaltung.

Bridge-Modus

Behalten Sie Ihre bestehende i18n-Bibliothek bei und fügen Sie gleichzeitig die typsichere Autovervollständigung, KI-Übersetzung und Dateiverwaltung von i1n hinzu.