Repository files navigation

This is a simple service module that allows you to localize your AngularJS applications. A tutorial that covers the service is located atCoding Smackdown TV

The service returns a localized string based on the current locale of the browser.

You can inject the service into a controller or use it via the i18n filter or the i18n directive provided in the code.

You need to follow a few steps to wire the service into your app:

1. Include the script localize.js in your project.
2. Ensure you add 'localization' to your app's dependency list.
3. Create a folder off the root of your web app named i18n and create a resource-locale_default.js file in it.
4. For every language you want to provide localized strings for you will also need to create a resource file that ends in the languageId-countryId (e.g. resource-locale_en-us.js).
5. To get the translated string using the filter with either ng-bind="'HomeTitle' | i18n" or {{'HomeTitle' | i18n}} in your HTML. You can use the directive by adding the data-i18n="HomeTitle" attribute to your markup.

The localization file is pretty simple. It consists of a JSON array of the following object:

{    "key":"_Greeting_",    "value":"iteSa ocalizationla xampleea singua heta esourcera ocalizationla ervicesa",    "description":"Home page greeting text"}

The key is used to look up the localized string, the value will be returned from the lookup and the description is an aide to developers and translators what the string is used for.

I've created a sample app that uses the Resource Localization Service to provide the text for the entire application. I registered 'localization' in my app's dependency list and I then use a combination of ng-bind="'HomeTitle' | i18n" and data-i18n="HomeTitle" to insert the text into the page at run time.

There is a delay loading the resource file, you may need to use the filter instead of the directive on the home page. This is due to the fact that the directive is only called once per instance where a filter is re-evaluated each time the DOM is compiled.

Resolved github issue #6 by adding code to properly parse language under android 2.x

Resolved github issue #8 by changing broadcast message to "localizeResourcesUpdated" across all components.

The MIT License

Copyright (c) 2012-2013 Coding Smackdown TV,http://codingsmackdown.tv

Permission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), to dealin the Software without restriction, including without limitation the rightsto use, copy, modify, merge, publish, distribute, sublicense, and/or sellcopies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included inall copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS ORIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THEAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHERLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS INTHE SOFTWARE.

Enjoy!