दस्तावेज़ JavaScript (Vanilla)

JavaScript (Vanilla)

बिना किसी फ्रेमवर्क के किसी भी JavaScript या TypeScript प्रोजेक्ट में i1n का उपयोग करें।

सेटअप

i1n को एक निर्भरता के रूप में इंस्टॉल करें (__VAR_1__ npm install i1n) और अपने प्रोजेक्ट को कॉन्फ़िगर करने के लिए __VAR_2__ i1n init चलाएँ। CLI locales/ डायरेक्टरी में नेस्टेड JSON फॉर्मेट सेट करता है।

i1n SDK किसी भी जावास्क्रिप्ट या टाइपस्क्रिप्ट वातावरण में काम करता है — Node.js, ब्राउज़र, Deno, या Bun। किसी भी फ्रेमवर्क या बिल्ड टूल निर्भरता की आवश्यकता नहीं है।

उपयोग

i1n से init और t इम्पोर्ट करें। अपने लोकेल और अनुवाद संसाधनों के साथ init() को कॉल करें, फिर अनुवादित स्ट्रिंग्स प्राप्त करने के लिए t() का उपयोग करें। वैरिएबल {var}, {{var}}, या %{var} सिंटैक्स के साथ इंटरपोलेट किए जाते हैं।

रनटाइम पर भाषाओं को स्विच करने के लिए setLocale() का उपयोग करें। _zero, _one, और _other कुंजी प्रत्यय के माध्यम से बहुवचन का समर्थन किया जाता है। उत्पन्न i1n.d.ts फ़ाइल यदि आप TypeScript का उपयोग करते हैं तो पूर्ण ऑटोपूर्ण प्रदान करती है।

ब्रिज मोड

यदि आपकी परियोजना में पहले से ही कस्टम अनुवाद फ़ंक्शन या लुकअप सिस्टम का उपयोग किया जा रहा है, तो इसे registerI1n((key, params) => yourFunction(key, params)) के साथ कनेक्ट करें। यह किसी भी मौजूदा सेटअप में i1n का टाइप-सेफ़ ऑटो-कम्प्लीट जोड़ता है।

ब्रिज मोड किसी भी फ़ंक्शन के साथ काम करता है जो एक कुंजी और वैकल्पिक पैरामीटर लेता है और एक स्ट्रिंग लौटाता है। यह i1n को किसी भी कस्टम i18n समाधान के साथ संगत बनाता है, चाहे वह किसी भी फ्रेमवर्क का हो।

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

संबंधित