Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

essoduke/javascript-i18n-core

Open more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Javascript-i18n-core

Simple i18n solution for javascript.

Online demo: https://code.essoduke.org/i18n

Quick start

import i18n from '/path/i18n.es6.js';

i18n.set({
    "resource": "/path/language.json",
    "locale": "en"
}).init(function () {
    // Do something.
    // this._("string key");
});

Usage

// Examples
{
    "hello": "WORLD!",
    "anime" {
        "japan": {
            "_": "Japanese Douga",
            "detective conan": "{year} Vol.{num}",
            "attack_on_titan": "Attck on Titan"
        }
    }
}    

// basic string
let foo = i18n._("hello"); // "WORLD!"

// use "." for multiple level
i18n._("anime.japan"); // "Japanese Douga"
i18n._("anime.japan.attact_on_titan"); // "Attact On Titan"

Variables

// Examples
{
    "anime" {
        "japan": {
            "detective conan": "{year} Vol.{num}"
        }
    }
}    

// by object
const conan = {
    "year": 2022,
    "num": 99
};
i18n._("anime.japan.detective conan", conan); // output "2022 Vol.99"

// by array
i18n._("anime.japan.detective conan", [2022, 99]); // output "2022 Vol.99"

// by arguments
i18n._("anime.japan.detective conan", 2022, 99); // output "2022 Vol.99"

Change language

// Change default language 
i18n.set('locale', 'jp')._("string key"); // output in Japanese

// Get specific language
i18n._("en", "string key"); // string in english

// with variables
i18n._("en", "anime.japan.detective conan", conan);
i18n._("en", "anime.japan.detective conan", [2022, 99]);
i18n._("jp", "anime.japan.detective conan", 2022, 99);

Auto translate

<div data-i18n="string key">...</div>
<div data-i18n-pass="{"name": "value"...}"></div>
<div data-i18n-pass="[value1, value2...]"></div>
// Initialize
i18n.set(...).init(function () {
    i18n.translate();
});

// Event trigger
button.addEventListener("click", function () {
    // auto translate in default language
    i18n.translate()
    
    // auto translate in specific language 
    // it won't change the default language setting
    i18n.translate('jp');    
});

Datetime

// Datetime of default format
let foo = i18n.now();

// Format in specific language
let foo = i18n.now('language key');

// Custom format
let foo = i18n.now('language key', 'format');

Language file example

{
    "Language key": {
        "__meta__": { // for datetime use.
            "datetime": "PHP like",
            "timezone": "UTC offset"
            "day": ["Mon", "Tue", "Wed"...], // abbr of day
            "days": ["Monday", "Tuesday", "Wednesday"...], // full name of day
            "month": ["Jan", "Feb", "Mar"...], // abbr of month
            "months": ["Janurary", "February", "March"...] // full name of month            
        },
        // Example {"key": "value"}
        "string key": "string", // String
        "string key": { // object
            "string key": {
                "string key": {...}
            }
        }
    }
}

License

javascript-i18n-core was release under MIT License.

About

Simple i18n solution for javascript

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published
Morty Proxy This is a proxified and sanitized view of the page, visit original site.