d8038afad9
Provide atocopletion capabilities to the search box: showing the remaining part of the matching element and allow user selection with keyboard. Change-Id: Ic591c3c87632fb56af16b9b15ecedbf9558d674a
306 lines
8.7 KiB
JavaScript
306 lines
8.7 KiB
JavaScript
/**
|
|
* jQuery language filter plugin.
|
|
*
|
|
* Copyright (C) 2012 Alolita Sharma, Amir Aharoni, Arun Ganesh, Brandon Harris,
|
|
* Niklas Laxström, Pau Giner, Santhosh Thottingal, Siebrand Mazeland and other
|
|
* contributors. See CREDITS for a list.
|
|
*
|
|
* UniversalLanguageSelector is dual licensed GPLv2 or later and MIT. You don't
|
|
* have to do anything special to choose one license or the other and you don't
|
|
* have to notify anyone which license you are using. You are free to use
|
|
* UniversalLanguageSelector in commercial projects as long as the copyright
|
|
* header is left intact. See files GPL-LICENSE and MIT-LICENSE for details.
|
|
*
|
|
* @file
|
|
* @ingroup Extensions
|
|
* @licence GNU General Public Licence 2.0 or later
|
|
* @licence MIT License
|
|
*/
|
|
|
|
/**
|
|
* Usage: $( 'inputbox' ).languagefilter();
|
|
* The values for autocompletion is from the options.languages.
|
|
* The data is in the format of languagecode:languagename.
|
|
*/
|
|
|
|
(function ( $ ) {
|
|
"use strict";
|
|
|
|
var LanguageFilter = function( element, options ) {
|
|
this.$element = $( element );
|
|
this.options = $.extend( {}, $.fn.regionselector.defaults, options );
|
|
this.$element.addClass( 'languagefilter' );
|
|
this.resultCount = 0;
|
|
this.$suggestion = $( '#' + this.$element.data( 'suggestion' ) );
|
|
this.listen();
|
|
};
|
|
|
|
LanguageFilter.prototype = {
|
|
|
|
listen: function() {
|
|
this.$element.on( 'keypress', $.proxy( this.keyup, this ) )
|
|
.on( 'keyup', $.proxy( this.keyup, this ) );
|
|
if ( $.browser.webkit || $.browser.msie ) {
|
|
this.$element.on( 'keydown', $.proxy( this.keyup, this ) );
|
|
}
|
|
},
|
|
|
|
keyup: function( e ) {
|
|
switch( e.keyCode ) {
|
|
case 9: // Tab -> Autocomplete
|
|
var suggestion = this.$suggestion.val();
|
|
if ( suggestion && suggestion !== this.$element.val() ) {
|
|
this.$element.val( suggestion );
|
|
e.preventDefault();
|
|
e.stopPropagation();
|
|
} else {
|
|
this.options.$target.focus();
|
|
}
|
|
default:
|
|
this.options.$target.empty();
|
|
this.search();
|
|
}
|
|
},
|
|
|
|
search: function() {
|
|
var query = $.trim( this.$element.val() ),
|
|
languages = $.uls.data.languagesByScriptGroup( this.options.languages ),
|
|
scriptGroup, langNum, langCode;
|
|
this.resultCount = 0;
|
|
for ( scriptGroup in languages ) {
|
|
for ( langNum = 0; langNum < languages[scriptGroup].length; langNum++ ) {
|
|
langCode = languages[scriptGroup][langNum];
|
|
if ( query === "" || this.filter( langCode, query ) ) {
|
|
if ( this.resultCount === 0 ) {
|
|
// Autofill the first result.
|
|
this.autofill( langCode );
|
|
}
|
|
this.render( langCode );
|
|
this.resultCount++;
|
|
}
|
|
}
|
|
}
|
|
// Also do a search by search API
|
|
if( this.options.searchAPI && query ) {
|
|
this.searchAPI( query );
|
|
} else {
|
|
this.resultHandler( query );
|
|
}
|
|
},
|
|
|
|
searchAPI: function( query ) {
|
|
var that = this;
|
|
$.get( that.options.searchAPI, { search: query }, function( result ) {
|
|
$.each( result['languagesearch'], function( code, name ) {
|
|
that.render( code, name );
|
|
that.resultCount++;
|
|
} );
|
|
that.resultHandler( query );
|
|
} );
|
|
},
|
|
|
|
/**
|
|
* Handler method to be called once search is over.
|
|
* Based on search result call success or noresults callbacks
|
|
* @param String query
|
|
*/
|
|
resultHandler: function( query ) {
|
|
if ( this.resultCount === 0 && this.options.noresults ) {
|
|
this.options.noresults.call( this, query );
|
|
} else if ( this.options.success ) {
|
|
this.options.success( this, query, this.resultCount );
|
|
}
|
|
},
|
|
|
|
autofill: function( langCode ) {
|
|
if ( !this.$suggestion.length ) {
|
|
return;
|
|
}
|
|
if ( !this.$element.val() ) {
|
|
this.$suggestion.val( '' );
|
|
return;
|
|
}
|
|
var autonym,
|
|
languageName = this.options.languages[langCode],
|
|
userInput = this.$element.val(),
|
|
suggestion = userInput + languageName.substring( userInput.length, languageName.length );
|
|
if ( suggestion !== languageName ) {
|
|
// see if it was autonym match
|
|
autonym = $.uls.data.autonym( langCode );
|
|
suggestion = userInput + autonym.substring( userInput.length, autonym.length );
|
|
if ( suggestion !== autonym ) {
|
|
// Give up. It may be iso/script code match.
|
|
suggestion = "";
|
|
}
|
|
}
|
|
this.$suggestion.val( suggestion );
|
|
},
|
|
|
|
render: function( langCode, languageName ) {
|
|
var $target = this.options.$target;
|
|
if ( !$target ) {
|
|
return;
|
|
}
|
|
$target.append( langCode, null, languageName );
|
|
},
|
|
|
|
escapeRegex: function( value ) {
|
|
// This is a prefix search.
|
|
return value.replace( /^[-[\]{}()*+?.,\\^$|#\s]/g, "\\$&" );
|
|
},
|
|
|
|
/**
|
|
* A search match happens if any of the following passes:
|
|
* a) Language name in current user interface language
|
|
* 'starts with' search string.
|
|
* b) Language autonym 'starts with' search string.
|
|
* c) ISO 639 code match with search string.
|
|
* d) ISO 15924 code for the script match the search string.
|
|
*/
|
|
filter: function( langCode, searchTerm ) {
|
|
// FIXME script is ISO 15924 code. We might need actual name of script.
|
|
var matcher = new RegExp( this.escapeRegex( searchTerm ), 'i' ),
|
|
languageName = this.options.languages[langCode];
|
|
return matcher.test( languageName ) ||
|
|
matcher.test( $.uls.data.autonym( langCode ) ) ||
|
|
matcher.test( langCode ) ||
|
|
matcher.test( $.uls.data.script( langCode ) );
|
|
}
|
|
|
|
};
|
|
|
|
$.fn.languagefilter = function( option ) {
|
|
return this.each( function() {
|
|
var $this = $( this ),
|
|
data = $this.data( 'languagefilter' ),
|
|
options = typeof option === 'object' && option;
|
|
if ( !data ) {
|
|
$this.data( 'languagefilter', ( data = new LanguageFilter( this, options ) ) );
|
|
}
|
|
if ( typeof option === 'string' ) {
|
|
data[option]();
|
|
}
|
|
} );
|
|
};
|
|
|
|
$.fn.languagefilter.defaults = {
|
|
$target: null, // Where to append the results
|
|
searchAPI: null,
|
|
languages: null, // Languages as code:name format.
|
|
noresults: null, // callback for no results found case
|
|
success: null // callback if any results found.
|
|
};
|
|
|
|
$.fn.languagefilter.Constructor = LanguageFilter;
|
|
|
|
/* RegionSelector plugin definition */
|
|
|
|
/**
|
|
* Region selector is a language selector based on regions.
|
|
* Usage: $( 'jqueryselector' ).regionselector( options );
|
|
* The attached element should have data-regiongroup attribute
|
|
* that defines the regiongroup for the selector.
|
|
*/
|
|
var RegionSelector = function( element, options ) {
|
|
this.$element = $( element );
|
|
this.options = $.extend( {}, $.fn.regionselector.defaults, options );
|
|
this.$element.addClass( 'regionselector' );
|
|
this.regions = [];
|
|
this.regionGroup = this.$element.data( 'regiongroup' );
|
|
this.init();
|
|
this.listen();
|
|
};
|
|
|
|
RegionSelector.prototype = {
|
|
constructor: RegionSelector,
|
|
|
|
init: function() {
|
|
var region = this.$element.data( 'region' );
|
|
this.regions = $.uls.data.regionsInGroup( this.regionGroup );
|
|
if ( region ) {
|
|
this.regions.push( region );
|
|
}
|
|
},
|
|
|
|
test: function( langCode ) {
|
|
var langRegions = $.uls.data.regions( langCode ),
|
|
region;
|
|
for ( var i = 0; i < this.regions.length; i++ ) {
|
|
region = this.regions[i];
|
|
if ( $.inArray( region, langRegions ) >= 0 ) {
|
|
this.render( langCode, region );
|
|
return;
|
|
}
|
|
}
|
|
},
|
|
|
|
show: function() {
|
|
var i, regions, language, languagesByScriptGroup, scriptGroup, languages;
|
|
// Make the selected region (and it only) active
|
|
$( '.regionselector' ).removeClass( 'active' );
|
|
if( this.regionGroup ) {
|
|
// if there is a region group, make it active.
|
|
this.$element.addClass( 'active' );
|
|
}
|
|
// Re-populate the list of languages
|
|
this.options.$target.empty();
|
|
languagesByScriptGroup = $.uls.data.languagesByScriptGroup( this.options.languages );
|
|
for ( scriptGroup in languagesByScriptGroup ) {
|
|
languages = languagesByScriptGroup[scriptGroup];
|
|
for ( i = 0; i < languages.length; i++) {
|
|
language = languages[i];
|
|
this.test( language );
|
|
}
|
|
}
|
|
|
|
if ( this.options.success ) {
|
|
this.options.success.call();
|
|
}
|
|
},
|
|
|
|
render: function( langCode, region ) {
|
|
var $target = this.options.$target;
|
|
if ( !$target ) {
|
|
return;
|
|
}
|
|
$target.append( langCode, region );
|
|
},
|
|
|
|
listen: function() {
|
|
this.$element.on( 'click', $.proxy( this.click, this ) );
|
|
},
|
|
|
|
click: function( e ) {
|
|
e.stopPropagation();
|
|
e.preventDefault();
|
|
this.show();
|
|
}
|
|
};
|
|
|
|
/* RegionSelector plugin definition */
|
|
|
|
$.fn.regionselector = function( option ) {
|
|
return this.each( function() {
|
|
var $this = $( this ),
|
|
data = $this.data( 'regionselector' ),
|
|
options = typeof option === 'object' && option;
|
|
|
|
if ( !data ) {
|
|
$this.data( 'regionselector', ( data = new RegionSelector( this, options ) ) );
|
|
}
|
|
if ( typeof option === 'string' ) {
|
|
data[option]();
|
|
}
|
|
} );
|
|
};
|
|
|
|
$.fn.regionselector.defaults = {
|
|
$target: null, // Where to render the results
|
|
success: null, // callback if any results found.
|
|
languages: null
|
|
};
|
|
|
|
$.fn.regionselector.Constructor = RegionSelector;
|
|
|
|
} )( jQuery );
|