jquery-sls

Simple language switcher for jQuery

This is a jQuery plugin that I have been working on in the past. It is also an example of overriding jQuery's html(), text() methods, MutationObservers etc...

• Easily searches document and applies translations on client side
• Dynamic language loading with ajax
• Supports translations at json format
• Language selection persists across pages (with HTML5 storage and cookie fallback)
• Match by sanitized text and replace with html
• Clean sanitization to remove excessive spaces and better matching
• Supports all container tags (innerHTML translation), known attributes like "title", "alt", "href", "placeholder", "src", custom attributes, values
• Of course, it is for web applications (If you have a traditional web page, you should serve your multiple language pages for compatibility with search engines)

Usage

Include script at html header.

<script src="jquery-sls.js" charset="utf-8" type="text/javascript"></script> 

You must have a default language and all the html files must be written in default language. Language json files default language texts as keys. Assuming that default language code is "en", add lang="en" attribute to all html elements that you want to be translated.

Call init() once. You can override the following self explanatory options.

$.sls.init({ 	defaultLang: "en", 	path: "/languages/", 	persistent: true }); 

Switch language with a simple command. This command translates the whole document automatically.

$.sls.setLang("tr"); 

Get current language code:

var lang = $.sls.getLang(); 

Translate single string from default language to current language. This function is for using with your custom javascript files.

var hello = $.sls.t("Hello World."); 

Translate an element matched by jQuery selector from default language to current language. This function is also chainable.

$("#mydiv").sls();