Getting started

Installation

i18next can be added to your project using npm or bower:

# npm
$ npm install i18next --save

# bower
$ bower install i18next

The default export is UMD compatible (commonjs, requirejs, global).

In the /dist folder you find additional builds for commonjs, es6 modules. Optimized to load i18next in webpack, rollup, ... or node.js. The correct entry points are already configured in the package.json so there should be no extra setup to get the best build option.

Load from CDN

You can also directly add a script tag loading i18next from one of the CDNs providing it:

unpkg.com

cdnjs.com

Basic sample

Please be aware this is samples are just showing basic usage of the core functionality. For production usage please consider using one of our framework integrations to get better and simpler integrations (Setting innerHTML is just done to show how it works).

import i18next from 'i18next';

i18next.init({
  lng: 'en',
  debug: true,
  resources: {
    en: {
      translation: {
        "key": "hello world"
      }
    }
  }
}, function(err, t) {
  // initialized and ready to go!
  document.getElementById('output').innerHTML = i18next.t('key');
});

As you might see this basic sample provides only one language directly added on init...lets extend this to have buttons to change language from english to german:

source code

This is a working sample showing translated text. To lear more have a look at the following extended sample.

Extended sample

The extended sample adds the language detector for browser and the xhr-backend to load translation files from this documentation's i18next-gitbook repo.

source code

You now have an idea about the basic setup. It's time to learn more about:

results matching ""

    No results matching ""