/*

 *

 * Copyright (c) 2006-2010 Sam Collett (http://www.texotela.co.uk)

 * Dual licensed under the MIT (http://www.opensource.org/licenses/mit-license.php)

 * and GPL (http://www.opensource.org/licenses/gpl-license.php) licenses.

 *

 * Version 2.2.5

 * Demo: http://www.texotela.co.uk/code/jquery/select/

 *

 *

 */

 

$(document).ready(function(){

 

/**

 * Adds (single/multiple) options to a select box (or series of select boxes)

 *

 * @name     addOption

 * @author   Sam Collett (http://www.texotela.co.uk)

 * @type     jQuery

 * @example  $("#myselect").addOption("Value", "Text"); // add single value (will be selected)

 * @example  $("#myselect").addOption("Value 2", "Text 2", false); // add single value (won't be selected)

 * @example  $("#myselect").addOption({"foo":"bar","bar":"baz"}, false); // add multiple values, but don't select

 *

 */

jQuery.fn.addOption = function()

{

	var add = function(el, v, t, sO, index)

	{

		var option = document.createElement("option");

		option.value = v, option.text = t;

		// get options

		var o = el.options;

		// get number of options

		var oL = o.length;

		if(!el.cache)

		{

			el.cache = {};

			// loop through existing options, adding to cache

			for(var i = 0; i < oL; i++)

			{

				el.cache[o[i].value] = i;

			}

		}

		if (index || index == 0)

		{

 			// we're going to insert these starting  at a specific index...

			// this has the side effect of el.cache[v] being the 

			// correct value for the typeof check below

			var ti = option;

			for(var ii =index; ii <= oL; ii++)

			{

				var tmp = el.options[ii];

				el.options[ii] = ti;

				o[ii] = ti;

				el.cache[o[ii].value] = ii;

				ti = tmp;

			}

		}

    

		// add to cache if it isn't already

		if(typeof el.cache[v] == "undefined") el.cache[v] = oL;

		el.options[el.cache[v]] = option;

		if(sO)

		{

			option.selected = true;

		}

	};

	

	var a = arguments;

	if(a.length == 0) return this;

	// select option when added? default is true

	var sO = true;

	// multiple items

	var m = false;

	// other variables

	var items, v, t;

	if(typeof(a[0]) == "object")

	{

		m = true;

		items = a[0];

	}

	if(a.length >= 2)

	{

		if(typeof(a[1]) == "boolean")

		{

			sO = a[1];

			startindex = a[2];

		}

		else if(typeof(a[2]) == "boolean")

		{

			sO = a[2];

			startindex = a[1];

		}

		else

		{

			startindex = a[1];

		}

		if(!m)

		{

			v = a[0];

			t = a[1];

		}

	}

	this.each(

		function()

		{

			if(this.nodeName.toLowerCase() != "select") return;

			if(m)

			{

				for(var item in items)

				{

					add(this, item, items[item], sO, startindex);

					startindex += 1;

				}

			}

			else

			{

				add(this, v, t, sO, startindex);

			}

		}

	);

	return this;

};



/**

 * Add options via ajax

 *

 * @name     ajaxAddOption

 * @author   Sam Collett (http://www.texotela.co.uk)

 * @type     jQuery

 * @param    String url      Page to get options from (must be valid JSON)

 * @param    Object params   (optional) Any parameters to send with the request

 * @param    Boolean select  (optional) Select the added options, default true

 * @param    Function fn     (optional) Call this function with the select object as param after completion

 * @param    Array args      (optional) Array with params to pass to the function afterwards

 * @example  $("#myselect").ajaxAddOption("myoptions.php");

 * @example  $("#myselect").ajaxAddOption("myoptions.php", {"code" : "007"});

 * @example  $("#myselect").ajaxAddOption("myoptions.php", {"code" : "007"}, false, sortoptions, [{"dir": "desc"}]);

 *

 */

jQuery.fn.ajaxAddOption = function(url, params, select, fn, args)

{

	if(typeof(url) != "string") return this;

	if(typeof(params) != "object") params = {};

	if(typeof(select) != "boolean") select = true;

	this.each(

		function()

		{

			var el = this;

			$.getJSON(url,

				params,

				function(r)

				{

					$(el).addOption(r, select);

					if(typeof fn == "function")

					{

						if(typeof args == "object")

						{

							fn.apply(el, args);

						} 

						else

						{

							fn.call(el);

						}

					}

				}

			);

		}

	);

	return this;

};



/**

 * Removes an option (by value or index) from a select box (or series of select boxes)

 *

 * @name     removeOption

 * @author   Sam Collett (http://www.texotela.co.uk)

 * @type     jQuery

 * @param    String|RegExp|Number what  Option to remove

 * @param    Boolean selectedOnly       (optional) Remove only if it has been selected (default false)   

 * @example  $("#myselect").removeOption("Value"); // remove by value

 * @example  $("#myselect").removeOption(/^val/i); // remove options with a value starting with 'val'

 * @example  $("#myselect").removeOption(/./); // remove all options

 * @example  $("#myselect").removeOption(/./, true); // remove all options that have been selected

 * @example  $("#myselect").removeOption(0); // remove by index

 * @example  $("#myselect").removeOption(["myselect_1","myselect_2"]); // values contained in passed array

 *

 */

jQuery.fn.removeOption = function()

{

	var a = arguments;

	if(a.length == 0) return this;

	var ta = typeof(a[0]);

	var v, index;

	// has to be a string or regular expression (object in IE, function in Firefox)

	if(ta == "string" || ta == "object" || ta == "function" )

	{

		v = a[0];

		// if an array, remove items

		if(v.constructor == Array)

		{

			var l = v.length;

			for(var i = 0; i<l; i++)

			{

				this.removeOption(v[i], a[1]); 

			}

			return this;

		}

	}

	else if(ta == "number") index = a[0];

	else return this;

	this.each(

		function()

		{

			if(this.nodeName.toLowerCase() != "select") return;

			// clear cache

			if(this.cache) this.cache = null;

			// does the option need to be removed?

			var remove = false;

			// get options

			var o = this.options;

			if(!!v)

			{

				// get number of options

				var oL = o.length;

				for(var i=oL-1; i>=0; i--)

				{

					if(v.constructor == RegExp)

					{

						if(o[i].value.match(v))

						{

							remove = true;

						}

					}

					else if(o[i].value == v)

					{

						remove = true;

					}

					// if the option is only to be removed if selected

					if(remove && a[1] === true) remove = o[i].selected;

					if(remove)

					{

						o[i] = null;

					}

					remove = false;

				}

			}

			else

			{

				// only remove if selected?

				if(a[1] === true)

				{

					remove = o[index].selected;

				}

				else

				{

					remove = true;

				}

				if(remove)

				{

					this.remove(index);

				}

			}

		}

	);

	return this;

};



/**

 * Sort options (ascending or descending) in a select box (or series of select boxes)

 *

 * @name     sortOptions

 * @author   Sam Collett (http://www.texotela.co.uk)

 * @type     jQuery

 * @param    Boolean ascending   (optional) Sort ascending (true/undefined), or descending (false)

 * @example  // ascending

 * $("#myselect").sortOptions(); // or $("#myselect").sortOptions(true);

 * @example  // descending

 * $("#myselect").sortOptions(false);

 *

 */

jQuery.fn.sortOptions = function(ascending)

{

	// get selected values first

	var sel = $(this).selectedValues();

	var a = typeof(ascending) == "undefined" ? true : !!ascending;

	this.each(

		function()

		{

			if(this.nodeName.toLowerCase() != "select") return;

			// get options

			var o = this.options;

			// get number of options

			var oL = o.length;

			// create an array for sorting

			var sA = [];

			// loop through options, adding to sort array

			for(var i = 0; i<oL; i++)

			{

				sA[i] = {

					v: o[i].value,

					t: o[i].text

				}

			}

			// sort items in array

			sA.sort(

				function(o1, o2)

				{

					// option text is made lowercase for case insensitive sorting

					o1t = o1.t.toLowerCase(), o2t = o2.t.toLowerCase();

					// if options are the same, no sorting is needed

					if(o1t == o2t) return 0;

					if(a)

					{

						return o1t < o2t ? -1 : 1;

					}

					else

					{

						return o1t > o2t ? -1 : 1;

					}

				}

			);

			// change the options to match the sort array

			for(var i = 0; i<oL; i++)

			{

				o[i].text = sA[i].t;

				o[i].value = sA[i].v;

			}

		}

	).selectOptions(sel, true); // select values, clearing existing ones

	return this;

};

/**

 * Selects an option by value

 *

 * @name     selectOptions

 * @author   Mathias Bank (http://www.mathias-bank.de), original function

 * @author   Sam Collett (http://www.texotela.co.uk), addition of regular expression matching

 * @type     jQuery

 * @param    String|RegExp|Array value  Which options should be selected

 * can be a string or regular expression, or an array of strings / regular expressions

 * @param    Boolean clear  Clear existing selected options, default false

 * @example  $("#myselect").selectOptions("val1"); // with the value 'val1'

 * @example  $("#myselect").selectOptions(["val1","val2","val3"]); // with the values 'val1' 'val2' 'val3'

 * @example  $("#myselect").selectOptions(/^val/i); // with the value starting with 'val', case insensitive

 *

 */

jQuery.fn.selectOptions = function(value, clear)

{

	var v = value;

	var vT = typeof(value);

	// handle arrays

	if(vT == "object" && v.constructor == Array)

	{

		var $this = this;

		$.each(v, function()

			{

      				$this.selectOptions(this, clear);

    			}

		);

	};

	var c = clear || false;

	// has to be a string or regular expression (object in IE, function in Firefox)

	if(vT != "string" && vT != "function" && vT != "object") return this;

	this.each(

		function()

		{

			if(this.nodeName.toLowerCase() != "select") return this;

			// get options

			var o = this.options;

			// get number of options

			var oL = o.length;

			for(var i = 0; i<oL; i++)

			{

				if(v.constructor == RegExp)

				{

					if(o[i].value.match(v))

					{

						o[i].selected = true;

					}

					else if(c)

					{

						o[i].selected = false;

					}

				}

				else

				{

					if(o[i].value == v)

					{

						o[i].selected = true;

					}

					else if(c)

					{

						o[i].selected = false;

					}

				}

			}

		}

	);

	return this;

};



/**

 * Copy options to another select

 *

 * @name     copyOptions

 * @author   Sam Collett (http://www.texotela.co.uk)

 * @type     jQuery

 * @param    String to  Element to copy to

 * @param    String which  (optional) Specifies which options should be copied - 'all' or 'selected'. Default is 'selected'

 * @example  $("#myselect").copyOptions("#myselect2"); // copy selected options from 'myselect' to 'myselect2'

 * @example  $("#myselect").copyOptions("#myselect2","selected"); // same as above

 * @example  $("#myselect").copyOptions("#myselect2","all"); // copy all options from 'myselect' to 'myselect2'

 *

 */

jQuery.fn.copyOptions = function(to, which)

{

	var w = which || "selected";

	if($(to).size() == 0) return this;

	this.each(

		function()

		{

			if(this.nodeName.toLowerCase() != "select") return this;

			// get options

			var o = this.options;

			// get number of options

			var oL = o.length;

			for(var i = 0; i<oL; i++)

			{

				if(w == "all" || (w == "selected" && o[i].selected))

				{

					$(to).addOption(o[i].value, o[i].text);

				}

			}

		}

	);

	return this;

};



/**

 * Checks if a select box has an option with the supplied value

 *

 * @name     containsOption

 * @author   Sam Collett (http://www.texotela.co.uk)

 * @type     Boolean|jQuery

 * @param    String|RegExp value  Which value to check for. Can be a string or regular expression

 * @param    Function fn          (optional) Function to apply if an option with the given value is found.

 * Use this if you don't want to break the chaining

 * @example  if($("#myselect").containsOption("val1")) alert("Has an option with the value 'val1'");

 * @example  if($("#myselect").containsOption(/^val/i)) alert("Has an option with the value starting with 'val'");

 * @example  $("#myselect").containsOption("val1", copyoption).doSomethingElseWithSelect(); // calls copyoption (user defined function) for any options found, chain is continued

 *

 */

jQuery.fn.containsOption = function(value, fn)

{

	var found = false;

	var v = value;

	var vT = typeof(v);

	var fT = typeof(fn);

	// has to be a string or regular expression (object in IE, function in Firefox)

	if(vT != "string" && vT != "function" && vT != "object") return fT == "function" ? this: found;

	this.each(

		function()

		{

			if(this.nodeName.toLowerCase() != "select") return this;

			// option already found

			if(found && fT != "function") return false;

			// get options

			var o = this.options;

			// get number of options

			var oL = o.length;

			for(var i = 0; i<oL; i++)

			{

				if(v.constructor == RegExp)

				{

					if (o[i].value.match(v))

					{

						found = true;

						if(fT == "function") fn.call(o[i], i);

					}

				}

				else

				{

					if (o[i].value == v)

					{

						found = true;

						if(fT == "function") fn.call(o[i], i);

					}

				}

			}

		}

	);

	return fT == "function" ? this : found;

};



/**

 * Returns values which have been selected

 *

 * @name     selectedValues

 * @author   Sam Collett (http://www.texotela.co.uk)

 * @type     Array

 * @example  $("#myselect").selectedValues();

 *

 */

jQuery.fn.selectedValues = function()

{

	var v = [];

	this.selectedOptions().each(

		function()

		{

			v[v.length] = this.value;

		}

	);

	return v;

};



/**

 * Returns text which has been selected

 *

 * @name     selectedTexts

 * @author   Sam Collett (http://www.texotela.co.uk)

 * @type     Array

 * @example  $("#myselect").selectedTexts();

 *

 */

jQuery.fn.selectedTexts = function()

{

	var t = [];

	this.selectedOptions().each(

		function()

		{

			t[t.length] = this.text;

		}

	);

	return t;

};



/**

 * Returns options which have been selected

 *

 * @name     selectedOptions

 * @author   Sam Collett (http://www.texotela.co.uk)

 * @type     jQuery

 * @example  $("#myselect").selectedOptions();

 *

 */

jQuery.fn.selectedOptions = function()

{

	return this.find("option:selected");

};



})(jQuery);