ULS is a jQuery plugin that allows you to implement a Wikimedia Universal language selector on your website. A fast and easy way to learn to use Jquery.uls is experimenting with examples / index.html on your web server.
Jquery.uls provides the jQuery $.fn.uls
extension that can be attached to the launcher object. When you click the trigger item, the language selector appears. The launcher can be a link, a button, or any valid jQuery element.
How to make use of it:
1. Include the newest jQuery library on your website.
<script src="/path/to/cdn/jquery.min.js"></script>
2. Include essential jQuery ULS information on the web page.
<link href="../css/jquery.uls.css" rel="stylesheet"/> <link href="../css/jquery.uls.grid.css" rel="stylesheet"/> <link href="../css/jquery.uls.lcd.css" rel="stylesheet"/> <script src="../src/jquery.uls.data.js"></script> <script src="../src/jquery.uls.data.utils.js"></script> <script src="../src/jquery.uls.lcd.js"></script> <script src="../src/jquery.uls.languagefilter.js"></script> <script src="../src/jquery.uls.regionfilter.js"></script> <script src="../src/jquery.uls.core.js"></script>
3. Create a container for the Language Selector.
<span class="active uls-trigger">Select Language</span>
4. Initialize the plugin on the trigger.
$(document).ready(function(){ $('.uls-trigger').uls({ onSelect: function(language){ var languageName = $.uls.data.getAutonym(language); $( '.uls-trigger' ).text( languageName ); }, quickList: ['en', 'hi', 'he', 'ml', 'ta', 'fr'] }); });
5. All default options.
{ // CSS top position for the dialog top: undefined, // CSS left position for the dialog left: undefined, // Callback function when user selects a language onSelect: undefined, // Callback function when the dialog is closed without selecting a language onCancel: undefined, // Callback function when ULS has initialized onReady: undefined, // Callback function when ULS dialog is shown onVisible: undefined, // Languages to be used for ULS, default is all languages languages: $.uls.data.getAutonyms(), // The options are wide (4 columns), medium (2 columns), and narrow (1 column). // If not specified, it will be set automatically. menuWidth: undefined, // What is this ULS used for. // Should be set for distinguishing between different instances of ULS // in the same application. ulsPurpose: '', // Used by LCD quickList: [], // Used by LCD showRegions: undefined, // Used by LCD languageDecorator: undefined, // Used by LCD noResultsTemplate: undefined, // Used by LCD itemsPerColumn: undefined, // Used by LCD groupByRegion: undefined, // Used by LanguageFilter searchAPI: undefined }
See Demo And Download
Official Website(wikimedia): Click Here
This superior jQuery/javascript plugin is developed by wikimedia. For extra Advanced Usage, please go to the official website.