Nuked: Probably Microwaved

    angular-jed

    1.2.0 • Public • Published

    Angular-Jed

    Angular wrapper for Jed.

    Check out the gh-pages branch to see a working example.

    Installation

    npm install --save angular-jed
    

    or

    bower install angular-jed
    

    Usage

    Configuration

    When running your app it's on you to set the language and the path to the translations files.

    angular.module('myApp', ['jed'])
      .run(['i18n', function(i18n) {
        i18n.setTranslationPath('/path/to/translations')
          .setLang('fr_FR');
      }]);

    Controllers

    The service provides a loadPage method to load a page translation file. The method returns a promise to make sure the translations methods can be used safely.

    angular.module('myApp')
      .controller('Video', [
        '$scope',
        'i18n',
        function($scope, i18n) {
          i18n.loadPage('video').then(function() {
            $scope.translatedText = i18n._('This text will be translated');
          });
        }
    ]);

    Common translations

    You can load common translations (eg. for directives) which will add to the current translations loaded. Returns a promise.

    angular.module('myApp')
      .directive('footer', ['i18n', function(i18n) {
        i18n.loadCommon('footer').then(function() {
          message = i18n._('This text will be translated');
        });
      }
    ]);

    Translations

    Filter

    In the views you can use the trans filter:

    <h1>{{ 'Translated title here'|trans }}</h1>
    <h2>{{ 'There is one cat'|trans:{plural: 'There are several cats', count: nbrOfCats, none: 'There are no cats'} }}</h2>

    Options:

    • singular Singular text
    • plural Plural text
    • none (optionnal) Text to display when count is 0
    • count
    • placeholders objects containing the variables to interpolate. The count is automatically added.

    Directive

    A trans directive is available for more complex plural:

    <trans singular="There is one %obj%" plural="There are %number% %objs%" none="No %objs%" count="nbr" placeholders="{number: nbr, obj: object, objs: objects}"></trans>

    The attributes are the same as the options for the filter.

    API

    • setTranslationPath(path) Set the translation path to retrieve the translation files
    • setLang(value) Sets the language of the app
    • getLang Returns the current language of the app
    • setDefaultLang(value) Sets the default language
    • ready Returns a promise resolved when the service has loaded the initial file
    • loadPage(page) Load a page translations. Returns a promise
    • loadCommon(name) Load common translations (footer, header...). Returns a promise
    • _(key) Simple translation
    • _n(singular_key, plural_key, value) Translation for plural

    Translation files

    The files MUST be named with the name of the page or directive and the language: name-fr_FR.json. For example calling i18n.loadPage('video') will load the file video-fr_FR (or whatever language the site is in).

    The translations files are cached so they won't be loaded twice. The cache is only a js variable so it just lives during the angular app life.

    If the translations files are not found the service falls back to the a default language. If even the default language file isn't found the translations method juste returns the given keys.

    Known issue

    The domains are not usable for now. The loadCommon method merges the messages with the current page loaded, so everything falls into the page domain.

    Keywords

    none

    Install

    npm i angular-jed

    DownloadsWeekly Downloads

    0

    Version

    1.2.0

    License

    MIT

    Last publish

    Collaborators

    • romainberger