@marchintosh94/i18n-pro

Introduction

i18nPro is a powerful internationalization library for web applications. It provides a seamless way to manage translations and pluralization in multiple languages. This is the core library and this documentation will guide you through the installation, setup, and usage of i18nPro.

📄 Table of Contents

1. Installation
2. Configuration
3. Usage
   • Load Translations
   • Inject Translations
   • Change Language
   • Translate
     • Pluralization
     • Dynamic Data
   • JSON Translations
4. React
5. License

Installation

1npm install @marchintosh94/i18n-pro
2# or
3yarn add @marchintosh94/i18n-pro

Configuration

• defaultLocale (string): The default language to use if no language is specified.

Import the i18nPro module and set your desired configuration in the entry point of your application:

1// src/index.ts
2
3import { i18nPro } from '@marchintosh94/i18n-pro'
4
5i18nPro.defaultLocale = 'en-US'
6
7//... other

Usage

Load external translation: loadMessages

This method allows to change current locale and load the dictionary from remote server via HTTP.

1import { i18nPro } from '@marchintosh94/i18n-pro'
2
3
4// Set the locale and load translation dictionary from external url
5await i18nPro.loadMessages('en', 'https://cdn.site.dev/translations/en.json')
6const welcome = i18nPro.t('welcome');

Load translation manually: loadLocalMessages

This method allows to change current locale andload the dictionary directly from the local environment.

1import { i18nPro } from '@marchintosh94/i18n-pro'
2
3
4// Set the locale and load translation dictionary as string that contains the JSON object
5await i18nPro.loadLocalMessages('en', '{"Hi": "Hi"}')
6// or with a JSON object Record<string, string | number>
7const dictionary: Record<string, string | number> = {"Hi": "Hi"}
8await i18nPro.loadLocalMessages('en', dictionary)
9const welcome = i18nPro.t('Hi');

Change Language: changeLanguage

This method allows to change current locale and dynamically load the dictionary from the local environment or remote server based on the argouments passed to the function.

1import { i18nPro } from '@marchintosh94/i18n-pro'
2
3
4// Set the locale and load translation dictionary as string that contains the JSON object
5await i18nPro.changeLanguage('en', '{"Hi": "Hi"}')
6// or with a JSON object Record<string, string | number>
7const dictionary: Record<string, string | number> = {"Hi": "Hi"}
8await i18nPro.changeLanguage('en', dictionary)
9const welcome = i18nPro.t('Hi');

Translate: t

Once the dictionary is loaded and the locale is set, the t method will translate the key that is passed in if a match is found, otherwise it will return the key as default value.

1import { i18nPro } from '@marchintosh94/i18n-pro'
2
3const dictionary: Record<string, string | number> = {"Hi": "Hi"}
4await i18nPro.changeLanguage('en', dictionary)
5
6//
7const welcome = i18nPro.t('Hi');

Pluralization

1{
2    "apple": "0 apples| 1 apple | 2 apples ",
3}

1const apples = i18nPro.t('apple', 1);
2// Output: "I'd like 1 apples"

Dynamic Data

1{
2    "tranlsation_key": "Hi, my name is {my_name}",
3}

1const apples = i18nPro.t('tranlsation_key', { my_name: "Carlos" });
2// Output: "Hi, my name is Carlos"

JSON Translations

i18nPro accepts as translation dictionary a JSON with the following format:

Simple

1{
2    "tranlsation_key": "translation_value",
3    "tranlsation_key2": "translation_value2",
4    "tranlsation_key3": "translation_value3",
5}

Pluralization

The result of the translation will be calculated once t method will be used with the pluralization argoument.

1{
2    "tranlsation_key": "One | Two | Three",
3}

Dynamic Data

The value in the curly braces will be replaced once the t method will be used with the related argoument.

1{
2    "tranlsation_key": "Hi, my name is {my_name}",
3}

React - I18nPro-React

@marchintosh/i18n-pro-react

This is the implementation of main library for React. i18nPro-react exposes all the core functionalities and utilities to adapt them to React ecosystem.

🔗I18nPro-react

License

This project is licensed under the MIT License.