/*
 *
 * Copyright (c) 2006-2009 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.4
 * Demo: http://www.texotela.co.uk/code/jquery/select/
 *
 * $LastChangedDate: 2009-02-08 00:28:12 +0000 (Sun, 08 Feb 2009) $
 * $Rev: 6185 $
 *
 */

;
(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
 *
 */
    $.fn.addOption = function()
    {
        var add = function(el, v, t, sO)
        {
            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;
                }
            }
            // 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];
            else if(typeof(a[2]) == "boolean") sO = a[2];
            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);
                    }
                }
                else
                {
                    add(this, v, t, sO);
                }
            }
            );
        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"}]);
 *
 */
    $.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
 *
 */
    $.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);
 *
 */
    $.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
 *
 */
    $.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'
 *
 */
    $.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
 *
 */
    $.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();
 *
 */
    $.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();
 *
 */
    $.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();
 *
 */
    $.fn.selectedOptions = function()
    {
        return this.find("option:selected");
    };

    $.fn.selectAll = function()
    {
        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(o[i].value != null)
                    {
                        o[i].selected = true;
                    }
                    else if(c)
                    {
                        o[i].selected = false;
                    }

                }
            }
        );
        return this;
    }

})(jQuery);