1
0
mirror of synced 2024-11-22 21:16:10 +03:00
select2/select2.js

1967 lines
70 KiB
JavaScript
Raw Normal View History

/*
Copyright 2012 Igor Vaynberg
2012-05-16 20:35:21 +04:00
Version: @@ver@@ Timestamp: @@timestamp@@
2012-03-29 22:08:14 +04:00
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in
compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:
2012-03-29 22:08:14 +04:00
http://www.apache.org/licenses/LICENSE-2.0
2012-05-03 20:01:13 +04:00
Unless required by applicable law or agreed to in writing, software distributed under the License is
distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and limitations under the License.
*/
(function ($) {
if(typeof $.fn.each2 == "undefined"){
$.fn.extend({
/*
* 4-10 times faster .each replacement
* use it carefully, as it overrides jQuery context of element on each iteration
*/
each2 : function (c) {
var j = $([0]), i = -1, l = this.length;
while (
++i < l
&& (j.context = j[0] = this[i])
&& c.call(j[0], i, j) !== false //"this"=DOM, i=index, j=jQuery object
);
return this;
}
});
2012-06-28 08:44:31 +04:00
}
})(jQuery);
2012-04-10 21:42:40 +04:00
(function ($, undefined) {
2012-03-29 22:08:14 +04:00
"use strict";
/*global document, window, jQuery, console */
if (window.Select2 !== undefined) {
return;
}
var KEY, AbstractSelect2, SingleSelect2, MultiSelect2, nextUid, sizer;
KEY = {
2012-03-29 22:08:14 +04:00
TAB: 9,
ENTER: 13,
ESC: 27,
SPACE: 32,
LEFT: 37,
UP: 38,
RIGHT: 39,
DOWN: 40,
SHIFT: 16,
CTRL: 17,
ALT: 18,
PAGE_UP: 33,
PAGE_DOWN: 34,
HOME: 36,
END: 35,
BACKSPACE: 8,
DELETE: 46,
isArrow: function (k) {
k = k.which ? k.which : k;
switch (k) {
case KEY.LEFT:
case KEY.RIGHT:
case KEY.UP:
case KEY.DOWN:
return true;
}
return false;
},
isControl: function (k) {
k = k.which ? k.which : k;
switch (k) {
case KEY.SHIFT:
case KEY.CTRL:
case KEY.ALT:
return true;
}
2012-06-28 13:27:09 +04:00
if (k.metaKey) return true;
2012-03-29 22:08:14 +04:00
return false;
},
isFunctionKey: function (k) {
k = k.which ? k.which : k;
return k >= 112 && k <= 123;
}
};
2012-06-14 23:16:44 +04:00
nextUid=(function() { var counter=1; return function() { return counter++; }; }());
2012-03-29 22:08:14 +04:00
function indexOf(value, array) {
var i = 0, l = array.length, v;
2012-06-13 06:41:21 +04:00
if (typeof value === "undefined") {
return -1;
}
2012-03-29 22:08:14 +04:00
if (value.constructor === String) {
for (; i < l; i = i + 1) if (value.localeCompare(array[i]) === 0) return i;
2012-03-29 22:08:14 +04:00
} else {
for (; i < l; i = i + 1) {
2012-03-29 22:08:14 +04:00
v = array[i];
if (v.constructor === String) {
if (v.localeCompare(value) === 0) return i;
} else {
if (v === value) return i;
}
}
}
return -1;
}
2012-03-31 01:06:34 +04:00
/**
2012-06-14 01:06:37 +04:00
* Compares equality of a and b taking into account that a and b may be strings, in which case localeCompare is used
2012-03-31 01:06:34 +04:00
* @param a
* @param b
*/
function equal(a, b) {
if (a === b) return true;
if (a === undefined || b === undefined) return false;
if (a === null || b === null) return false;
if (a.constructor === String) return a.localeCompare(b) === 0;
if (b.constructor === String) return b.localeCompare(a) === 0;
return false;
}
/**
* Splits the string into an array of values, trimming each value. An empty array is returned for nulls or empty
* strings
* @param string
* @param separator
*/
function splitVal(string, separator) {
var val, i, l;
if (string === null || string.length < 1) return [];
val = string.split(separator);
for (i = 0, l = val.length; i < l; i = i + 1) val[i] = $.trim(val[i]);
return val;
}
2012-03-29 22:08:14 +04:00
function getSideBorderPadding(element) {
return element.outerWidth() - element.width();
}
function installKeyUpChangeEvent(element) {
var key="keyup-change-value";
element.bind("keydown", function () {
if (!$.hasData(element, key)) {
$.data(element, key, element.val());
}
2012-03-29 22:08:14 +04:00
});
element.bind("keyup", function () {
if (element.val() !== $.data(element, key)) {
$.removeData(element, key);
2012-03-29 22:08:14 +04:00
element.trigger("keyup-change");
}
});
}
$(document).delegate("*", "mousemove", function (e) {
$(document).data("select2-lastpos", {x: e.pageX, y: e.pageY});
});
2012-03-29 22:08:14 +04:00
/**
* filters mouse events so an event is fired only if the mouse moved.
*
* filters out mouse events that occur when mouse is stationary but
* the elements under the pointer are scrolled.
2012-06-28 08:44:31 +04:00
*/
2012-03-29 22:08:14 +04:00
function installFilteredMouseMove(element) {
element.bind("mousemove", function (e) {
var lastpos = $(document).data("select2-lastpos");
2012-03-29 22:08:14 +04:00
if (lastpos === undefined || lastpos.x !== e.pageX || lastpos.y !== e.pageY) {
$(e.target).trigger("mousemove-filtered", e);
}
});
}
/**
* Debounces a function. Returns a function that calls the original fn function only if no invocations have been made
* within the last quietMillis milliseconds.
*
* @param quietMillis number of milliseconds to wait before invoking fn
* @param fn function to be debounced
* @return debounced version of fn
*/
function debounce(quietMillis, fn) {
2012-03-29 22:08:14 +04:00
var timeout;
return function () {
window.clearTimeout(timeout);
timeout = window.setTimeout(fn, quietMillis);
2012-03-29 22:08:14 +04:00
};
}
function installDebouncedScroll(threshold, element) {
var notify = debounce(threshold, function (e) { element.trigger("scroll-debounced", e);});
element.bind("scroll", function (e) {
2012-03-29 22:08:14 +04:00
if (indexOf(e.target, element.get()) >= 0) notify(e);
});
}
function killEvent(event) {
event.preventDefault();
event.stopPropagation();
}
2012-06-28 08:44:31 +04:00
function measureTextWidth(e) {
if (!sizer){
var style = e[0].currentStyle || window.getComputedStyle(e[0], null);
sizer = $("<div></div>").css({
position: "absolute",
left: "-1000px",
top: "-1000px",
display: "none",
fontSize: style.fontSize,
fontFamily: style.fontFamily,
fontStyle: style.fontStyle,
fontWeight: style.fontWeight,
letterSpacing: style.letterSpacing,
textTransform: style.textTransform,
whiteSpace: "nowrap"
2012-06-28 08:44:31 +04:00
});
$("body").append(sizer);
}
2012-06-28 08:44:31 +04:00
sizer.text(e.val());
return sizer.width();
2012-03-29 22:08:14 +04:00
}
function markMatch(text, term, markup) {
var match=text.toUpperCase().indexOf(term.toUpperCase()),
tl=term.length;
if (match<0) {
markup.push(text);
return;
}
markup.push(text.substring(0, match));
markup.push("<span class='select2-match'>");
markup.push(text.substring(match, match + tl));
markup.push("</span>");
markup.push(text.substring(match + tl, text.length));
2012-03-29 22:08:14 +04:00
}
/**
* Produces an ajax-based query function
*
* @param options object containing configuration paramters
* @param options.transport function that will be used to execute the ajax request. must be compatible with parameters supported by $.ajax
* @param options.url url for the data
* @param options.data a function(searchTerm, pageNumber, context) that should return an object containing query string parameters for the above url.
* @param options.dataType request data type: ajax, jsonp, other datatatypes supported by jQuery's $.ajax function or the transport function if specified
* @param options.quietMillis (optional) milliseconds to wait before making the ajaxRequest, helps debounce the ajax function if invoked too often
* @param options.results a function(remoteData, pageNumber) that converts data returned form the remote request to the format expected by Select2.
* The expected format is an object containing the following keys:
* results array of objects that will be used as choices
* more (optional) boolean indicating whether there are more results available
* Example: {results:[{id:1, text:'Red'},{id:2, text:'Blue'}], more:true}
*/
function ajax(options) {
var timeout, // current scheduled but not yet executed request
requestSequence = 0, // sequence used to drop out-of-order responses
handler = null,
quietMillis = options.quietMillis || 100;
return function (query) {
window.clearTimeout(timeout);
timeout = window.setTimeout(function () {
requestSequence += 1; // increment the sequence
var requestNumber = requestSequence, // this request's sequence number
data = options.data, // ajax data function
transport = options.transport || $.ajax,
type = options.type || 'GET'; // set type of request (GET or POST)
2012-06-28 08:44:31 +04:00
data = data.call(this, query.term, query.page, query.context);
if( null !== handler) { handler.abort(); }
2012-06-28 08:44:31 +04:00
handler = transport.call(null, {
url: options.url,
dataType: options.dataType,
data: data,
type: type,
success: function (data) {
if (requestNumber < requestSequence) {
return;
}
2012-04-13 22:29:41 +04:00
// TODO 3.0 - replace query.page with query so users have access to term, page, etc.
var results = options.results(data, query.page);
query.callback(results);
}
});
}, quietMillis);
};
}
/**
* Produces a query function that works with a local array
*
* @param options object containing configuration parameters. The options parameter can either be an array or an
* object.
*
* If the array form is used it is assumed that it contains objects with 'id' and 'text' keys.
*
* If the object form is used ti is assumed that it contains 'data' and 'text' keys. The 'data' key should contain
* an array of objects that will be used as choices. These objects must contain at least an 'id' key. The 'text'
* key can either be a String in which case it is expected that each element in the 'data' array has a key with the
* value of 'text' which will be used to match choices. Alternatively, text can be a function(item) that can extract
* the text.
*/
function local(options) {
var data = options, // data elements
2012-06-14 20:39:23 +04:00
dataText,
text = function (item) { return ""+item.text; }; // function used to retrieve the text portion of a data item that is matched against the search
if (!$.isArray(data)) {
text = data.text;
// if text is not a function we assume it to be a key name
if (!$.isFunction(text)) {
2012-06-14 20:39:23 +04:00
dataText = data.text; // we need to store this in a separate variable because in the next step data gets reset and data.text is no longer available
text = function (item) { return item[dataText]; };
}
data = data.results;
}
return function (query) {
var t = query.term, filtered = {};
if (t === "") {
query.callback({results: data});
return;
}
filtered.results = $(data)
.filter(function () {return query.matcher(t, text(this));})
.get();
query.callback(filtered);
};
}
2012-04-03 09:27:58 +04:00
// TODO javadoc
function tags(data) {
// TODO even for a function we should probably return a wrapper that does the same object/string check as
// the function for arrays. otherwise only functions that return objects are supported.
2012-04-03 09:27:58 +04:00
if ($.isFunction(data)) {
return data;
}
// if not a function we assume it to be an array
return function (query) {
var t = query.term, filtered = {results: []};
2012-04-03 09:27:58 +04:00
$(data).each(function () {
var isObject = this.text !== undefined,
text = isObject ? this.text : this;
if (t === "" || query.matcher(t, text)) {
filtered.results.push(isObject ? this : {id: this, text: this});
}
2012-04-03 09:27:58 +04:00
});
query.callback(filtered);
};
2012-04-03 09:27:58 +04:00
}
2012-03-29 22:08:14 +04:00
/**
* blurs any Select2 container that has focus when an element outside them was clicked or received focus
*/
$(document).ready(function () {
$(document).delegate("*", "mousedown focusin touchend", function (e) {
2012-03-29 22:08:14 +04:00
var target = $(e.target).closest("div.select2-container").get(0);
if (target) {
$(document).find("div.select2-container-active").each(function () {
if (this !== target) $(this).data("select2").blur();
});
} else {
target = $(e.target).closest("div.select2-drop").get(0);
$(document).find("div.select2-drop-active").each(function () {
if (this !== target) $(this).data("select2").blur();
});
}
2012-03-29 22:08:14 +04:00
});
});
function evaluate(val) {
return $.isFunction(val) ? val() : val;
}
2012-03-29 22:08:14 +04:00
/**
* Creates a new class
2012-03-29 22:08:14 +04:00
*
* @param superClass
* @param methods
2012-03-29 22:08:14 +04:00
*/
function clazz(SuperClass, methods) {
var constructor = function () {};
constructor.prototype = new SuperClass;
constructor.prototype.constructor = constructor;
constructor.prototype.parent = SuperClass.prototype;
constructor.prototype = $.extend(constructor.prototype, methods);
return constructor;
2012-03-29 22:08:14 +04:00
}
AbstractSelect2 = clazz(Object, {
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
bind: function (func) {
var self = this;
return function () {
func.apply(self, arguments);
};
},
2012-04-12 10:28:54 +04:00
2012-06-22 06:00:29 +04:00
// abstract
init: function (opts) {
var results, search, resultsSelector = ".select2-results";
2012-03-29 22:08:14 +04:00
// prepare options
this.opts = opts = this.prepareOpts(opts);
this.id=opts.id;
2012-03-29 22:08:14 +04:00
// destroy if called on an existing component
if (opts.element.data("select2") !== undefined &&
opts.element.data("select2") !== null) {
this.destroy();
}
2012-03-29 22:08:14 +04:00
2012-06-07 08:52:08 +04:00
this.enabled=true;
this.container = this.createContainer();
this.body = opts.element.closest("body"); // cache for future access
2012-03-29 22:08:14 +04:00
if (opts.element.attr("class") !== undefined) {
this.container.addClass(opts.element.attr("class"));
}
2012-03-29 22:08:14 +04:00
this.container.css(evaluate(opts.containerCss));
this.container.addClass(evaluate(opts.containerCssClass));
// swap container for the element
this.opts.element
.data("select2", this)
.hide()
.after(this.container);
this.container.data("select2", this);
this.dropdown = this.container.find(".select2-drop");
this.dropdown.css(evaluate(opts.dropdownCss));
this.dropdown.addClass(evaluate(opts.dropdownCssClass));
this.dropdown.data("select2", this);
this.results = results = this.container.find(resultsSelector);
2012-06-22 08:36:08 +04:00
this.search = search = this.container.find("input.select2-input");
this.resultsPage = 0;
this.context = null;
// initialize the container
this.initContainer();
installFilteredMouseMove(this.results);
this.dropdown.delegate(resultsSelector, "mousemove-filtered", this.bind(this.highlightUnderEvent));
installDebouncedScroll(80, this.results);
this.dropdown.delegate(resultsSelector, "scroll-debounced", this.bind(this.loadMoreIfNeeded));
// if jquery.mousewheel plugin is installed we can prevent out-of-bounds scrolling of results via mousewheel
if ($.fn.mousewheel) {
results.mousewheel(function (e, delta, deltaX, deltaY) {
var top = results.scrollTop(), height;
if (deltaY > 0 && top - deltaY <= 0) {
results.scrollTop(0);
killEvent(e);
} else if (deltaY < 0 && results.get(0).scrollHeight - results.scrollTop() + deltaY <= results.height()) {
results.scrollTop(results.get(0).scrollHeight - results.height());
killEvent(e);
}
});
}
2012-03-29 22:08:14 +04:00
installKeyUpChangeEvent(search);
search.bind("keyup-change", this.bind(this.updateResults));
2012-07-03 17:56:42 +04:00
search.bind("focus", function () { search.addClass("select2-focused"); if (search.val() === " ") search.val(""); });
search.bind("blur", function () { search.removeClass("select2-focused");});
2012-03-29 22:08:14 +04:00
this.dropdown.delegate(resultsSelector, "click", this.bind(function (e) {
if ($(e.target).closest(".select2-result-selectable:not(.select2-disabled)").length > 0) {
this.highlightUnderEvent(e);
this.selectHighlighted(e);
} else {
2012-03-29 22:08:14 +04:00
killEvent(e);
this.focusSearch();
2012-03-29 22:08:14 +04:00
}
}));
2012-03-29 22:08:14 +04:00
if ($.isFunction(this.opts.initSelection)) {
// initialize selection based on the current value of the source element
this.initSelection();
2012-03-29 22:08:14 +04:00
// if the user has provided a function that can set selection based on the value of the source element
// we monitor the change event on the element and trigger it, allowing for two way synchronization
this.monitorSource();
2012-03-29 22:08:14 +04:00
}
2012-06-07 08:52:08 +04:00
if (opts.element.is(":disabled")) this.disable();
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
destroy: function () {
var select2 = this.opts.element.data("select2");
if (select2 !== undefined) {
select2.container.remove();
select2.dropdown.remove();
select2.opts.element
.removeData("select2")
.unbind(".select2")
2012-06-28 08:44:31 +04:00
.show();
}
},
2012-04-12 10:28:54 +04:00
2012-06-22 06:00:29 +04:00
// abstract
prepareOpts: function (opts) {
var element, select, idKey;
2012-06-28 08:44:31 +04:00
element = opts.element;
if (element.get(0).tagName.toLowerCase() === "select") {
this.select = select = opts.element;
}
if (select) {
// these options are not allowed when attached to a select because they are picked up off the element itself
$.each(["id", "multiple", "ajax", "query", "createSearchChoice", "initSelection", "data", "tags"], function () {
if (this in opts) {
throw new Error("Option '" + this + "' is not allowed for Select2 when attached to a <select> element.");
}
});
}
opts = $.extend({}, {
containerCss: {},
dropdownCss: {},
containerCssClass: "",
dropdownCssClass: "",
populateResults: function(container, results, query) {
var uidToData={}, populate, markup=[], uid, data, result, children, formatted, id=this.opts.id;
populate=function(results, depth) {
var i, l, uid, result, selectable, compound;
for (i = 0, l = results.length; i < l; i = i + 1) {
result=results[i];
selectable=id(result) !== undefined;
compound=("children" in result) && result.children.length > 0;
markup.push("<li class='select2-result-depth-" + depth);
markup.push(" select2-result");
markup.push(selectable ? " select2-result-selectable" : " select2-result-unselectable");
if (compound) { markup.push(" select2-result-with-children"); }
markup.push("'");
uid=nextUid();
markup.push(" id='select2-result-"+uid+"'");
uidToData[uid]=result;
markup.push("><div class='select2-result-label'>");
formatted=opts.formatResult(result, query, markup);
// for backwards compat with <3.0 versions
if (formatted!==undefined) {
markup.push(formatted);
}
markup.push("</div>");
if (compound) {
markup.push("<ul class='select2-result-sub'>");
populate(result.children, depth + 1);
markup.push("</ul>");
}
markup.push("</li>");
}
};
populate(results, 0);
2012-06-29 16:20:06 +04:00
container.append(markup.join(""));
for (uid in uidToData) {
$("#select2-result-"+uid, container).data("select2-data", uidToData[uid]);
}
},
formatResult: function(result, query, markup) {
markMatch(result.text, query.term, markup);
},
formatSelection: function (data) {
return data.fullText || data.text;
},
formatNoMatches: function () { return "No matches found"; },
formatInputTooShort: function (input, min) { return "Please enter " + (min - input.length) + " more characters"; },
formatLoadMore: function (pageNumber) { return "Loading more results..."; },
minimumResultsForSearch: 0,
minimumInputLength: 0,
id: function (e) { return e.id; },
matcher: function(term, text) {
return text.toUpperCase().indexOf(term.toUpperCase()) >= 0;
}
}, opts);
2012-03-29 22:08:14 +04:00
if (typeof(opts.id) !== "function") {
idKey = opts.id;
opts.id = function (e) { return e[idKey]; };
}
2012-03-29 22:08:14 +04:00
if (select) {
opts.query = this.bind(function (query) {
var data = { results: [], more: false },
term = query.term,
children, firstChild, process;
2012-03-29 22:08:14 +04:00
process=function(element, collection) {
var group;
if (element.is("option")) {
if (query.matcher(term, element.text())) {
collection.push({id:element.attr("value"), text:element.text(), element: element.get()});
}
} else if (element.is("optgroup")) {
group={text:element.attr("label"), children:[], element: element.get()};
element.children().each2(function(i, elm) { process(elm, group.children); });
if (group.children.length>0) {
collection.push(group);
}
}
};
2012-03-29 22:08:14 +04:00
children=element.children();
2012-03-29 22:08:14 +04:00
// ignore the placeholder option if there is one
if (this.getPlaceholder() !== undefined && children.length > 0) {
firstChild = children[0];
if ($(firstChild).text() === "") {
children=children.not(firstChild);
}
}
children.each2(function(i, elm) { process(elm, data.results); });
2012-03-29 22:08:14 +04:00
query.callback(data);
2012-03-29 22:08:14 +04:00
});
// this is needed because inside val() we construct choices from options and there id is hardcoded
opts.id=function(e) { return e.id; };
} else {
if (!("query" in opts)) {
if ("ajax" in opts) {
opts.query = ajax(opts.ajax);
} else if ("data" in opts) {
opts.query = local(opts.data);
} else if ("tags" in opts) {
opts.query = tags(opts.tags);
opts.createSearchChoice = function (term) { return {id: term, text: term}; };
opts.initSelection = function (element, callback) {
var data = [];
$(splitVal(element.val(), ",")).each(function () {
data.push({id: this, text: this});
});
2012-06-28 08:44:31 +04:00
callback(data);
};
}
2012-03-29 22:08:14 +04:00
}
}
if (typeof(opts.query) !== "function") {
throw "query function not defined for Select2 " + opts.element.attr("id");
}
2012-03-31 01:06:34 +04:00
return opts;
},
2012-03-29 22:08:14 +04:00
/**
* Monitor the original element for changes and update select2 accordingly
*/
2012-06-22 06:00:29 +04:00
// abstract
monitorSource: function () {
this.opts.element.bind("change.select2", this.bind(function (e) {
if (this.opts.element.data("select2-change-triggered") !== true) {
this.initSelection();
}
}));
},
2012-03-29 22:08:14 +04:00
/**
* Triggers the change event on the source element
*/
2012-06-22 06:00:29 +04:00
// abstract
triggerChange: function (details) {
details = details || {};
details= $.extend({}, details, { type: "change", val: this.val() });
// prevents recursive triggering
this.opts.element.data("select2-change-triggered", true);
this.opts.element.trigger(details);
this.opts.element.data("select2-change-triggered", false);
},
2012-03-29 22:08:14 +04:00
2012-06-07 08:52:08 +04:00
2012-06-22 06:00:29 +04:00
// abstract
2012-06-07 08:52:08 +04:00
enable: function() {
if (this.enabled) return;
this.enabled=true;
this.container.removeClass("select2-container-disabled");
},
2012-06-22 06:00:29 +04:00
// abstract
2012-06-07 08:52:08 +04:00
disable: function() {
if (!this.enabled) return;
this.close();
this.enabled=false;
this.container.addClass("select2-container-disabled");
},
2012-06-22 06:00:29 +04:00
// abstract
opened: function () {
return this.container.hasClass("select2-dropdown-open");
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
positionDropdown: function() {
var offset = this.container.offset(),
height = this.container.outerHeight(),
width = this.container.outerWidth(),
dropHeight = this.dropdown.outerHeight(),
viewportBottom = document.body.scrollTop + document.documentElement.clientHeight,
dropTop = offset.top + height,
enoughRoomBelow = dropTop + dropHeight <= viewportBottom,
enoughRoomAbove = (offset.top - dropHeight) >= document.body.scrollTop,
aboveNow = this.dropdown.hasClass("select2-drop-above"),
above,
css;
// always prefer the current above/below alignment, unless there is not enough room
if (aboveNow) {
above = true;
if (!enoughRoomAbove && enoughRoomBelow) above = false;
} else {
above = false;
if (!enoughRoomBelow && enoughRoomAbove) above = true;
}
if (above) {
dropTop = offset.top - dropHeight;
this.container.addClass("select2-drop-above");
this.dropdown.addClass("select2-drop-above");
}
else {
this.container.removeClass("select2-drop-above");
this.dropdown.removeClass("select2-drop-above");
}
css = {
top:dropTop,
left:offset.left,
width:width
};
this.dropdown.css(css);
},
2012-07-05 12:07:31 +04:00
// abstract
shouldOpen: function() {
var event;
if (this.opened()) return false;
event = jQuery.Event("open");
this.opts.element.trigger(event);
return !event.isDefaultPrevented();
},
// abstract
clearDropdownAlignmentPreference: function() {
// clear the classes used to figure out the preference of where the dropdown should be opened
this.container.removeClass("select2-drop-above");
this.dropdown.removeClass("select2-drop-above");
},
2012-07-05 12:07:31 +04:00
/**
* Opens the dropdown
*
* @return {Boolean} whether or not dropdown was opened. This method will return false if, for example,
* the dropdown is already open, or if the 'open' event listener on the element called preventDefault().
*/
2012-06-22 06:00:29 +04:00
// abstract
open: function () {
2012-07-05 12:07:31 +04:00
if (!this.shouldOpen()) return false;
2012-03-29 22:08:14 +04:00
this.clearDropdownAlignmentPreference();
2012-07-05 12:24:36 +04:00
if (this.search.val() === " ") { this.search.val(""); }
this.container.addClass("select2-dropdown-open").addClass("select2-container-active");
2012-06-28 08:44:31 +04:00
if(this.dropdown[0] !== this.body.children().last()[0]) {
// ensure the dropdown is the last child of body, so the z-index is always respected correctly
this.dropdown.detach().appendTo(this.body);
}
2012-06-28 08:44:31 +04:00
this.dropdown.addClass("select2-drop-active");
this.positionDropdown();
2012-03-29 22:08:14 +04:00
this.updateResults(true);
this.dropdown.show();
2012-05-19 01:50:35 +04:00
this.ensureHighlightVisible();
this.focusSearch();
2012-07-05 12:07:31 +04:00
return true;
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
close: function () {
if (!this.opened()) return;
2012-03-29 22:08:14 +04:00
this.clearDropdownAlignmentPreference();
this.dropdown.hide();
this.container.removeClass("select2-dropdown-open");
this.results.empty();
this.clearSearch();
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
clearSearch: function () {
2012-03-29 22:08:14 +04:00
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
ensureHighlightVisible: function () {
var results = this.results, children, index, child, hb, rb, y, more;
2012-06-28 08:44:31 +04:00
index = this.highlight();
2012-03-29 22:08:14 +04:00
if (index < 0) return;
2012-06-28 08:44:31 +04:00
if (index == 0) {
// if the first element is highlighted scroll all the way to the top,
// that way any unselectable headers above it will also be scrolled
// into view
results.scrollTop(0);
return;
}
children = results.find(".select2-result-selectable");
2012-03-29 22:08:14 +04:00
child = $(children[index]);
2012-03-29 22:08:14 +04:00
hb = child.offset().top + child.outerHeight();
2012-03-29 22:08:14 +04:00
// if this is the last child lets also make sure select2-more-results is visible
if (index === children.length - 1) {
more = results.find("li.select2-more-results");
if (more.length > 0) {
hb = more.offset().top + more.outerHeight();
}
}
2012-03-29 22:08:14 +04:00
rb = results.offset().top + results.outerHeight();
if (hb > rb) {
results.scrollTop(results.scrollTop() + (hb - rb));
2012-03-29 22:08:14 +04:00
}
y = child.offset().top - results.offset().top;
2012-03-29 22:08:14 +04:00
// make sure the top of the element is visible
if (y < 0) {
results.scrollTop(results.scrollTop() + y); // y is negative
}
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
moveHighlight: function (delta) {
var choices = this.results.find(".select2-result-selectable"),
index = this.highlight();
2012-03-29 22:08:14 +04:00
while (index > -1 && index < choices.length) {
index += delta;
var choice = $(choices[index]);
if (choice.hasClass("select2-result-selectable") && !choice.hasClass("select2-disabled")) {
this.highlight(index);
break;
}
}
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
highlight: function (index) {
var choices = this.results.find(".select2-result-selectable");
2012-03-29 22:08:14 +04:00
if (arguments.length === 0) {
return indexOf(choices.filter(".select2-highlighted")[0], choices.get());
}
2012-03-29 22:08:14 +04:00
if (index >= choices.length) index = choices.length - 1;
if (index < 0) index = 0;
2012-03-29 22:08:14 +04:00
choices.removeClass("select2-highlighted");
$(choices[index]).addClass("select2-highlighted");
this.ensureHighlightVisible();
2012-03-29 22:08:14 +04:00
//if (this.opened()) this.focusSearch();
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
highlightUnderEvent: function (event) {
var el = $(event.target).closest(".select2-result-selectable");
if (el.length > 0 && !el.is(".select2-highlighted")) {
var choices = this.results.find('.select2-result-selectable');
this.highlight(choices.index(el));
} else if (el.length == 0) {
// if we are over an unselectable item remove al highlights
this.results.find(".select2-highlighted").removeClass("select2-highlighted");
}
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
loadMoreIfNeeded: function () {
var results = this.results,
more = results.find("li.select2-more-results"),
below, // pixels the element is below the scroll fold, below==0 is when the element is starting to be visible
offset = -1, // index of first element without data
page = this.resultsPage + 1,
2012-06-22 09:08:56 +04:00
self=this,
term=this.search.val(),
context=this.context;
if (more.length === 0) return;
below = more.offset().top - results.offset().top - results.height();
if (below <= 0) {
more.addClass("select2-active");
this.opts.query({
2012-06-22 09:09:33 +04:00
term: term,
page: page,
2012-06-22 09:09:33 +04:00
context: context,
2012-06-13 06:41:21 +04:00
matcher: this.opts.matcher,
callback: this.bind(function (data) {
self.opts.populateResults.call(this, results, data.results, {term: term, page: page, context:context});
if (data.more===true) {
more.detach().appendTo(results.children(":last")).text(self.opts.formatLoadMore(page+1));
window.setTimeout(function() { self.loadMoreIfNeeded(); }, 10);
} else {
more.remove();
2012-03-29 22:08:14 +04:00
}
self.positionDropdown();
self.resultsPage = page;
})});
}
},
2012-03-29 22:08:14 +04:00
/**
* @param initial whether or not this is the call to this method right after the dropdown has been opened
*/
2012-06-22 06:00:29 +04:00
// abstract
updateResults: function (initial) {
var search = this.search, results = this.results, opts = this.opts, self=this;
2012-03-29 22:08:14 +04:00
// if the search is currently hidden we do not alter the results
if (initial !== true && this.showSearchInput === false) {
return;
}
search.addClass("select2-active");
2012-03-29 22:08:14 +04:00
function postRender() {
results.scrollTop(0);
search.removeClass("select2-active");
self.positionDropdown();
2012-04-03 09:27:58 +04:00
}
2012-03-29 22:08:14 +04:00
function render(html) {
results.html(html);
postRender();
}
if (search.val().length < opts.minimumInputLength) {
render("<li class='select2-no-results'>" + opts.formatInputTooShort(search.val(), opts.minimumInputLength) + "</li>");
2012-03-29 22:08:14 +04:00
return;
}
this.resultsPage = 1;
opts.query({
term: search.val(),
page: this.resultsPage,
context: null,
matcher: opts.matcher,
callback: this.bind(function (data) {
var def; // default choice
2012-06-13 06:41:21 +04:00
// save context, if any
this.context = (data.context===undefined) ? null : data.context;
// create a default choice and prepend it to the list
if (this.opts.createSearchChoice && search.val() !== "") {
def = this.opts.createSearchChoice.call(null, search.val(), data.results);
if (def !== undefined && def !== null && self.id(def) !== undefined && self.id(def) !== null) {
if ($(data.results).filter(
function () {
return equal(self.id(this), self.id(def));
}).length === 0) {
data.results.unshift(def);
}
}
}
2012-03-29 22:08:14 +04:00
if (data.results.length === 0) {
render("<li class='select2-no-results'>" + opts.formatNoMatches(search.val()) + "</li>");
return;
}
2012-03-29 22:08:14 +04:00
results.empty();
self.opts.populateResults.call(this, results, data.results, {term: search.val(), page: this.resultsPage, context:null});
postRender();
2012-03-29 22:08:14 +04:00
if (data.more === true) {
results.children().filter(":last").append("<li class='select2-more-results'>" + opts.formatLoadMore(this.resultsPage) + "</li>");
window.setTimeout(function() { self.loadMoreIfNeeded(); }, 10);
}
this.postprocessResults(data, initial);
})});
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
cancel: function () {
2012-03-29 22:08:14 +04:00
this.close();
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
blur: function () {
this.close();
this.container.removeClass("select2-container-active");
this.dropdown.removeClass("select2-drop-active");
// synonymous to .is(':focus'), which is available in jquery >= 1.6
if (this.search[0] === document.activeElement) { this.search.blur(); }
this.clearSearch();
this.selection.find(".select2-search-choice-focus").removeClass("select2-search-choice-focus");
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
focusSearch: function () {
/* we do this in a timeout so that current event processing can complete before this code is executed.
this makes sure the search field is focussed even if the current event would blur it */
window.setTimeout(this.bind(function () {
this.search.focus();
}), 10);
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
selectHighlighted: function () {
var data = this.results.find(".select2-highlighted").not(".select2-disabled").closest('.select2-result-selectable').data("select2-data");
if (data) {
this.onSelect(data);
}
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// abstract
getPlaceholder: function () {
return this.opts.element.attr("placeholder") ||
this.opts.element.attr("data-placeholder") || // jquery 1.4 compat
this.opts.element.data("placeholder") ||
this.opts.placeholder;
},
/**
* Get the desired width for the container element. This is
* derived first from option `width` passed to select2, then
* the inline 'style' on the original element, and finally
* falls back to the jQuery calculated element width.
*
* @returns The width string (with units) for the container.
*/
2012-06-22 06:00:29 +04:00
// abstract
getContainerWidth: function () {
var style, attrs, matches, i, l;
// see if there is width specified in opts
if (this.opts.width !== undefined)
return this.opts.width;
// next check if there is inline style on the element that contains width
style = this.opts.element.attr('style');
if (style !== undefined) {
attrs = style.split(';');
for (i = 0, l = attrs.length; i < l; i = i + 1) {
matches = attrs[i].replace(/\s/g, '')
.match(/width:(([-+]?([0-9]*\.)?[0-9]+)(px|em|ex|%|in|cm|mm|pt|pc))/);
if (matches !== null && matches.length >= 1)
return matches[1];
}
}
// next check if css('width') can resolve a width that is percent based, this is sometimes possible
// when attached to input type=hidden or elements hidden via css
style = this.opts.element.css('width');
if (style.indexOf("%") > 0) return style;
// finally, fallback on the calculated width of the element
return (this.opts.element.width() === 0 ? 'auto' : this.opts.element.outerWidth() + 'px');
}
});
SingleSelect2 = clazz(AbstractSelect2, {
2012-06-22 06:00:29 +04:00
// single
createContainer: function () {
return $("<div></div>", {
"class": "select2-container",
"style": "width: " + this.getContainerWidth()
}).html([
" <a href='javascript:void(0)' class='select2-choice'><input type='text' class='select2-offscreen select2-focusser'/>",
" <span></span><abbr class='select2-search-choice-close' style='display:none;'></abbr>",
" <div><b></b></div>" ,
"</a>",
" <div class='select2-drop' style='display:none;'>" ,
" <div class='select2-search'>" ,
2012-06-22 08:36:08 +04:00
" <input type='text' autocomplete='off' class='select2-input'/>" ,
" </div>" ,
" <ul class='select2-results'>" ,
" </ul>" ,
"</div>"].join(""));
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// single
close: function () {
if (!this.opened()) return;
this.parent.close.apply(this, arguments);
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// single
focus: function () {
this.close();
this.selection.focus();
},
2012-06-22 06:00:29 +04:00
// single
isFocused: function () {
return this.selection[0] === document.activeElement;
},
2012-06-22 06:00:29 +04:00
// single
cancel: function () {
this.parent.cancel.apply(this, arguments);
this.selection.focus();
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// single
initContainer: function () {
2012-03-29 22:08:14 +04:00
var selection,
container = this.container,
dropdown = this.dropdown,
2012-06-13 09:12:53 +04:00
containers = $([this.container.get(0), this.dropdown.get(0)]),
clickingInside = false,
selector = ".select2-choice",
focusser=container.find("input.select2-focusser");
this.selection = selection = container.find(selector);
2012-03-29 22:08:14 +04:00
this.search.bind("keydown", this.bind(function (e) {
switch (e.which) {
case KEY.UP:
case KEY.DOWN:
this.moveHighlight((e.which === KEY.UP) ? -1 : 1);
killEvent(e);
return;
case KEY.TAB:
case KEY.ENTER:
this.selectHighlighted();
killEvent(e);
return;
case KEY.ESC:
this.cancel(e);
killEvent(e);
return;
}
}));
2012-03-29 22:08:14 +04:00
2012-06-13 09:12:53 +04:00
containers.delegate(selector, "click", this.bind(function (e) {
clickingInside = true;
2012-03-29 22:08:14 +04:00
if (this.opened()) {
this.close();
selection.focus();
2012-06-07 08:52:08 +04:00
} else if (this.enabled) {
this.open();
}
e.preventDefault();
2012-03-29 22:08:14 +04:00
clickingInside = false;
}));
2012-06-13 09:12:53 +04:00
containers.delegate(selector, "keydown", this.bind(function (e) {
2012-06-07 08:52:08 +04:00
if (!this.enabled || e.which === KEY.TAB || KEY.isControl(e) || KEY.isFunctionKey(e) || e.which === KEY.ESC) {
return;
}
this.open();
if (e.which === KEY.PAGE_UP || e.which === KEY.PAGE_DOWN || e.which === KEY.SPACE) {
// prevent the page from scrolling
killEvent(e);
}
if (e.which === KEY.ENTER) {
// do not propagate the event otherwise we open, and propagate enter which closes
killEvent(e);
}
}));
2012-06-14 23:16:44 +04:00
containers.delegate(selector, "focus", function () { if (this.enabled) { containers.addClass("select2-container-active"); dropdown.addClass("select2-drop-active"); }});
containers.delegate(selector, "blur", this.bind(function (e) {
if (clickingInside) return;
if (e.target===focusser.get(0)) return; // ignore blurs from focusser
if (!this.opened()) { this.blur(); }
}));
selection.delegate("abbr", "click", this.bind(function (e) {
2012-06-07 08:52:08 +04:00
if (!this.enabled) return;
this.clear();
2012-03-29 22:08:14 +04:00
killEvent(e);
this.close();
this.triggerChange();
selection.focus();
}));
2012-03-29 22:08:14 +04:00
this.setPlaceholder();
focusser.bind("focus", function() { selection.focus(); });
selection.bind("focus", this.bind(function() {
focusser.hide();
this.container.addClass("select2-container-active");
}));
selection.bind("blur", function() { focusser.show(); });
this.opts.element.bind("open", function() { focusser.hide(); });
},
2012-03-29 22:08:14 +04:00
clear: function() {
this.opts.element.val("");
this.selection.find("span").empty();
this.selection.removeData("select2-data");
this.setPlaceholder();
},
/**
* Sets selection based on source element's value
*/
2012-06-22 06:00:29 +04:00
// single
initSelection: function () {
var selected;
if (this.opts.element.val() === "") {
this.updateSelection({id: "", text: ""});
this.close();
this.setPlaceholder();
2012-03-29 22:08:14 +04:00
} else {
var self = this;
this.opts.initSelection.call(null, this.opts.element, function(selected){
if (selected !== undefined && selected !== null) {
self.updateSelection(selected);
self.close();
self.setPlaceholder();
2012-06-28 08:44:31 +04:00
}
});
2012-03-29 22:08:14 +04:00
}
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// single
prepareOpts: function () {
var opts = this.parent.prepareOpts.apply(this, arguments);
if (opts.element.get(0).tagName.toLowerCase() === "select") {
// install the selection initializer
opts.initSelection = function (element, callback) {
var selected = element.find(":selected");
// a single select box always has a value, no need to null check 'selected'
if ($.isFunction(callback))
callback({id: selected.attr("value"), text: selected.text()});
};
}
return opts;
},
2012-06-22 06:00:29 +04:00
// single
setPlaceholder: function () {
var placeholder = this.getPlaceholder();
if (this.opts.element.val() === "" && placeholder !== undefined) {
2012-03-29 22:08:14 +04:00
// check for a first blank option if attached to a select
if (this.select && this.select.find("option:first").text() !== "") return;
2012-03-29 22:08:14 +04:00
if (typeof(placeholder) === "object") {
this.updateSelection(placeholder);
} else {
this.selection.find("span").html(placeholder);
}
this.selection.addClass("select2-default");
2012-03-29 22:08:14 +04:00
this.selection.find("abbr").hide();
2012-03-29 22:08:14 +04:00
}
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// single
postprocessResults: function (data, initial) {
2012-04-16 19:28:54 +04:00
var selected = 0, self = this, showSearchInput = true;
2012-03-29 22:08:14 +04:00
// find the selected element in the result list
2012-03-29 22:08:14 +04:00
this.results.find(".select2-result-selectable").each2(function (i, elm) {
if (equal(self.id(elm.data("select2-data")), self.opts.element.val())) {
selected = i;
return false;
}
});
2012-03-29 22:08:14 +04:00
// and highlight it
2012-03-29 22:08:14 +04:00
this.highlight(selected);
2012-03-29 22:08:14 +04:00
// hide the search box if this is the first we got the results and there are a few of them
2012-03-29 22:08:14 +04:00
if (initial === true) {
// TODO below we use data.results.length, but what we really need is something recursive to calc the length
// TODO in case there are optgroups
showSearchInput = this.showSearchInput = data.results.length >= this.opts.minimumResultsForSearch;
this.dropdown.find(".select2-search")[showSearchInput ? "removeClass" : "addClass"]("select2-search-hidden");
//add "select2-with-searchbox" to the container if search box is shown
$(this.dropdown, this.container)[showSearchInput ? "addClass" : "removeClass"]("select2-with-searchbox");
}
2012-03-31 01:06:34 +04:00
},
2012-03-31 01:06:34 +04:00
2012-06-22 06:00:29 +04:00
// single
onSelect: function (data) {
var old = this.opts.element.val();
2012-03-29 22:08:14 +04:00
this.opts.element.val(this.id(data));
this.updateSelection(data);
this.close();
this.selection.focus();
if (!equal(old, this.id(data))) { this.triggerChange(); }
},
2012-06-22 06:00:29 +04:00
// single
updateSelection: function (data) {
this.selection.data("select2-data", data);
this.selection
.find("span")
.html(this.opts.formatSelection(data));
2012-03-29 22:08:14 +04:00
this.selection.removeClass("select2-default");
2012-03-29 22:08:14 +04:00
if (this.opts.allowClear && this.getPlaceholder() !== undefined) {
this.selection.find("abbr").show();
}
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// single
val: function () {
var val, data = null;
2012-03-29 22:08:14 +04:00
if (arguments.length === 0) {
return this.opts.element.val();
}
2012-03-29 22:08:14 +04:00
val = arguments[0];
2012-03-29 22:08:14 +04:00
if (this.select) {
// val is an id
this.select
.val(val)
.find(":selected").each2(function (i, elm) {
data = {id: elm.attr("value"), text: elm.text()};
return false;
});
this.updateSelection(data);
} else {
// val is an object. !val is true for [undefined,null,'']
this.opts.element.val(!val ? "" : this.id(val));
this.updateSelection(val);
}
this.setPlaceholder();
2012-03-29 22:08:14 +04:00
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// single
clearSearch: function () {
this.search.val("");
},
// single
data: function(value) {
if (arguments.length === 0) {
return this.selection.data("select2-data");
} else {
if (!value || value === "") {
this.clear();
} else {
this.opts.element.val(!value ? "" : this.id(value));
this.updateSelection(value);
}
}
}
});
2012-03-29 22:08:14 +04:00
MultiSelect2 = clazz(AbstractSelect2, {
2012-06-22 06:00:29 +04:00
// multi
createContainer: function () {
return $("<div></div>", {
"class": "select2-container select2-container-multi",
"style": "width: " + this.getContainerWidth()
}).html([
" <ul class='select2-choices'>",
//"<li class='select2-search-choice'><span>California</span><a href="javascript:void(0)" class="select2-search-choice-close"></a></li>" ,
" <li class='select2-search-field'>" ,
2012-06-22 08:36:08 +04:00
" <input type='text' autocomplete='off' style='width: 25px;' class='select2-input'>" ,
" </li>" ,
"</ul>" ,
"<div class='select2-drop select2-drop-multi' style='display:none;'>" ,
" <ul class='select2-results'>" ,
" </ul>" ,
"</div>"].join(""));
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// multi
prepareOpts: function () {
var opts = this.parent.prepareOpts.apply(this, arguments);
2012-04-24 21:46:21 +04:00
opts = $.extend({}, {
closeOnSelect: true
}, opts);
2012-04-17 19:04:00 +04:00
// TODO validate placeholder is a string if specified
if (opts.element.get(0).tagName.toLowerCase() === "select") {
// install sthe selection initializer
opts.initSelection = function (element,callback) {
var data = [];
element.find(":selected").each2(function (i, elm) {
data.push({id: elm.attr("value"), text: elm.text()});
});
if ($.isFunction(callback))
callback(data);
};
}
return opts;
},
2012-06-22 06:00:29 +04:00
// multi
initContainer: function () {
var selector = ".select2-choices", selection;
2012-03-29 22:08:14 +04:00
this.searchContainer = this.container.find(".select2-search-field");
this.selection = selection = this.container.find(selector);
2012-03-29 22:08:14 +04:00
this.search.bind("keydown", this.bind(function (e) {
2012-06-07 08:52:08 +04:00
if (!this.enabled) return;
if (e.which === KEY.BACKSPACE && this.search.val() === "") {
this.close();
2012-03-29 22:08:14 +04:00
var choices,
selected = selection.find(".select2-search-choice-focus");
if (selected.length > 0) {
this.unselect(selected.first());
this.search.width(10);
killEvent(e);
return;
}
2012-03-29 22:08:14 +04:00
choices = selection.find(".select2-search-choice");
if (choices.length > 0) {
choices.last().addClass("select2-search-choice-focus");
}
} else {
selection.find(".select2-search-choice-focus").removeClass("select2-search-choice-focus");
2012-03-29 22:08:14 +04:00
}
if (this.opened()) {
switch (e.which) {
case KEY.UP:
case KEY.DOWN:
this.moveHighlight((e.which === KEY.UP) ? -1 : 1);
killEvent(e);
return;
case KEY.ENTER:
case KEY.TAB:
this.selectHighlighted();
killEvent(e);
return;
case KEY.ESC:
this.cancel(e);
killEvent(e);
return;
}
2012-03-29 22:08:14 +04:00
}
if (e.which === KEY.TAB || KEY.isControl(e) || KEY.isFunctionKey(e) || e.which === KEY.BACKSPACE || e.which === KEY.ESC) {
2012-03-29 22:08:14 +04:00
return;
}
this.open();
2012-03-29 22:08:14 +04:00
if (e.which === KEY.PAGE_UP || e.which === KEY.PAGE_DOWN) {
// prevent the page from scrolling
killEvent(e);
}
}));
2012-03-29 22:08:14 +04:00
this.search.bind("keyup", this.bind(this.resizeSearch));
2012-03-29 22:08:14 +04:00
this.container.delegate(selector, "click", this.bind(function (e) {
2012-06-07 08:52:08 +04:00
if (!this.enabled) return;
this.clearPlaceholder();
this.open();
this.focusSearch();
e.preventDefault();
}));
2012-03-29 22:08:14 +04:00
this.container.delegate(selector, "focus", this.bind(function () {
2012-06-07 08:52:08 +04:00
if (!this.enabled) return;
this.container.addClass("select2-container-active");
this.dropdown.addClass("select2-drop-active");
this.clearPlaceholder();
}));
2012-03-29 22:08:14 +04:00
// set the placeholder if necessary
this.clearSearch();
},
2012-06-22 06:00:29 +04:00
// multi
2012-06-07 08:52:08 +04:00
enable: function() {
if (this.enabled) return;
this.parent.enable.apply(this, arguments);
this.search.show();
},
2012-06-22 06:00:29 +04:00
// multi
2012-06-07 08:52:08 +04:00
disable: function() {
if (!this.enabled) return;
this.parent.disable.apply(this, arguments);
this.search.hide();
},
2012-06-22 06:00:29 +04:00
// multi
initSelection: function () {
var data;
if (this.opts.element.val() === "") {
this.updateSelection([]);
this.close();
// set the placeholder if necessary
this.clearSearch();
}
if (this.select || this.opts.element.val() !== "") {
var self = this;
this.opts.initSelection.call(null, this.opts.element, function(data){
if (data !== undefined && data !== null) {
self.updateSelection(data);
self.close();
// set the placeholder if necessary
self.clearSearch();
2012-06-28 08:44:31 +04:00
}
});
2012-06-28 08:44:31 +04:00
}
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// multi
clearSearch: function () {
var placeholder = this.getPlaceholder();
2012-03-29 22:08:14 +04:00
2012-06-14 23:16:44 +04:00
if (placeholder !== undefined && this.getVal().length === 0 && this.search.hasClass("select2-focused") === false) {
this.search.val(placeholder).addClass("select2-default");
// stretch the search box to full width of the container so as much of the placeholder is visible as possible
2012-07-14 01:34:33 +04:00
this.resizeSearch();
} else {
2012-06-30 09:38:34 +04:00
// we set this to " " instead of "" and later clear it on focus() because there is a firefox bug
// that does not properly render the caret when the field starts out blank
this.search.val(" ").width(10);
}
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// multi
clearPlaceholder: function () {
if (this.search.hasClass("select2-default")) {
this.search.val("").removeClass("select2-default");
} else {
// work around for the space character we set to avoid firefox caret bug
if (this.search.val() === " ") this.search.val("");
}
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// multi
open: function () {
2012-07-05 12:07:31 +04:00
if (this.parent.open.apply(this, arguments) === false) return false;
this.clearPlaceholder();
2012-06-19 07:21:36 +04:00
this.resizeSearch();
this.focusSearch();
2012-07-05 12:07:31 +04:00
return true;
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// multi
close: function () {
if (!this.opened()) return;
this.parent.close.apply(this, arguments);
},
2012-06-22 06:00:29 +04:00
// multi
focus: function () {
this.close();
this.search.focus();
},
2012-06-22 06:00:29 +04:00
// multi
isFocused: function () {
2012-05-03 09:52:05 +04:00
return this.search.hasClass("select2-focused");
},
2012-06-22 06:00:29 +04:00
// multi
updateSelection: function (data) {
var ids = [], filtered = [], self = this;
// filter out duplicates
$(data).each(function () {
if (indexOf(self.id(this), ids) < 0) {
ids.push(self.id(this));
filtered.push(this);
}
});
data = filtered;
2012-03-29 22:08:14 +04:00
this.selection.find(".select2-search-choice").remove();
$(data).each(function () {
self.addSelectedChoice(this);
});
self.postprocessResults();
},
2012-03-31 01:06:34 +04:00
2012-06-22 06:00:29 +04:00
// multi
onSelect: function (data) {
this.addSelectedChoice(data);
if (this.select) { this.postprocessResults(); }
2012-04-24 21:46:21 +04:00
if (this.opts.closeOnSelect) {
this.close();
this.search.width(10);
} else {
this.search.width(10);
this.resizeSearch();
}
2012-03-31 01:06:34 +04:00
// since its not possible to select an element that has already been
// added we do not need to check if this is a new element before firing change
this.triggerChange({ added: data });
2012-03-29 22:08:14 +04:00
this.focusSearch();
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// multi
cancel: function () {
2012-03-29 22:08:14 +04:00
this.close();
this.focusSearch();
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// multi
addSelectedChoice: function (data) {
var choice,
id = this.id(data),
parts,
val = this.getVal();
parts = ["<li class='select2-search-choice'>",
this.opts.formatSelection(data),
"<a href='javascript:void(0)' class='select2-search-choice-close' tabindex='-1'></a>",
"</li>"
];
choice = $(parts.join(""));
choice.find("a")
.bind("click dblclick", this.bind(function (e) {
2012-06-07 08:52:08 +04:00
if (!this.enabled) return;
this.unselect($(e.target));
this.selection.find(".select2-search-choice-focus").removeClass("select2-search-choice-focus");
killEvent(e);
this.close();
this.focusSearch();
})).bind("focus", this.bind(function () {
2012-06-07 08:52:08 +04:00
if (!this.enabled) return;
this.container.addClass("select2-container-active");
this.dropdown.addClass("select2-drop-active");
}));
2012-03-29 22:08:14 +04:00
choice.data("select2-data", data);
choice.insertBefore(this.searchContainer);
2012-03-29 22:08:14 +04:00
val.push(id);
this.setVal(val);
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// multi
unselect: function (selected) {
var val = this.getVal(),
data,
index;
2012-03-29 22:08:14 +04:00
selected = selected.closest(".select2-search-choice");
2012-03-29 22:08:14 +04:00
if (selected.length === 0) {
throw "Invalid argument: " + selected + ". Must be .select2-search-choice";
}
2012-03-29 22:08:14 +04:00
data = selected.data("select2-data");
index = indexOf(this.id(data), val);
2012-03-29 22:08:14 +04:00
if (index >= 0) {
val.splice(index, 1);
this.setVal(val);
if (this.select) this.postprocessResults();
2012-03-29 22:08:14 +04:00
}
selected.remove();
this.triggerChange({ removed: data });
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// multi
postprocessResults: function () {
var val = this.getVal(),
choices = this.results.find(".select2-result-selectable"),
self = this;
2012-03-29 22:08:14 +04:00
choices.each2(function (i, choice) {
var id = self.id(choice.data("select2-data"));
if (indexOf(id, val) >= 0) {
choice.addClass("select2-disabled");
} else {
choice.removeClass("select2-disabled");
}
});
2012-03-29 22:08:14 +04:00
choices.each2(function (i, choice) {
if (!choice.hasClass("select2-disabled")) {
self.highlight(i);
return false;
}
});
2012-03-29 22:08:14 +04:00
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// multi
resizeSearch: function () {
2012-03-29 22:08:14 +04:00
var minimumWidth, left, maxWidth, containerLeft, searchWidth,
sideBorderPadding = getSideBorderPadding(this.search);
2012-03-29 22:08:14 +04:00
minimumWidth = measureTextWidth(this.search) + 10;
2012-03-29 22:08:14 +04:00
left = this.search.offset().left;
2012-03-29 22:08:14 +04:00
maxWidth = this.selection.width();
containerLeft = this.selection.offset().left;
2012-03-29 22:08:14 +04:00
searchWidth = maxWidth - (left - containerLeft) - sideBorderPadding;
2012-03-29 22:08:14 +04:00
if (searchWidth < minimumWidth) {
searchWidth = maxWidth - sideBorderPadding;
}
2012-03-29 22:08:14 +04:00
if (searchWidth < 40) {
searchWidth = maxWidth - sideBorderPadding;
}
this.search.width(searchWidth);
},
2012-06-22 06:00:29 +04:00
// multi
getVal: function () {
var val;
if (this.select) {
val = this.select.val();
return val === null ? [] : val;
} else {
val = this.opts.element.val();
return splitVal(val, ",");
}
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// multi
setVal: function (val) {
var unique;
if (this.select) {
this.select.val(val);
} else {
unique = [];
// filter out duplicates
$(val).each(function () {
if (indexOf(this, unique) < 0) unique.push(this);
});
this.opts.element.val(unique.length === 0 ? "" : unique.join(","));
}
},
2012-03-29 22:08:14 +04:00
2012-06-22 06:00:29 +04:00
// multi
val: function () {
var val, data = [], self=this;
2012-03-29 22:08:14 +04:00
if (arguments.length === 0) {
return this.getVal();
}
2012-03-29 22:08:14 +04:00
val = arguments[0];
if (this.select) {
// val is a list of ids
this.setVal(val);
this.select.find(":selected").each(function () {
data.push({id: $(this).attr("value"), text: $(this).text()});
});
this.updateSelection(data);
} else {
val = (val === null) ? [] : val;
// val is a list of objects
$(val).each(function () { data.push(self.id(this)); });
this.setVal(data);
this.updateSelection(val);
}
this.clearSearch();
},
2012-06-22 06:00:29 +04:00
// multi
onSortStart: function() {
if (this.select) {
throw new Error("Sorting of elements is not supported when attached to <select>. Attach to <input type='hidden'/> instead.");
}
// collapse search field into 0 width so its container can be collapsed as well
this.search.width(0);
// hide the container
this.searchContainer.hide();
},
2012-06-22 06:00:29 +04:00
// multi
onSortEnd:function() {
var val=[], self=this;
// show search and move it to the end of the list
this.searchContainer.show();
// make sure the search container is the last item in the list
this.searchContainer.appendTo(this.searchContainer.parent());
// since we collapsed the width in dragStarted, we resize it here
this.resizeSearch();
// update selection
this.selection.find(".select2-search-choice").each(function() {
val.push(self.opts.id($(this).data("select2-data")));
});
this.setVal(val);
this.triggerChange();
},
// multi
data: function(values) {
var self=this, ids;
if (arguments.length === 0) {
return this.selection
.find(".select2-search-choice")
.map(function() { return $(this).data("select2-data"); })
.get();
} else {
ids = $.map(values, function(e) { return self.opts.id(e)});
this.setVal(ids);
this.updateSelection(values);
this.clearSearch();
}
2012-03-29 22:08:14 +04:00
}
});
2012-03-29 22:08:14 +04:00
$.fn.select2 = function () {
var args = Array.prototype.slice.call(arguments, 0),
opts,
select2,
value, multiple, allowedMethods = ["val", "destroy", "open", "close", "focus", "isFocused", "container", "onSortStart", "onSortEnd", "enable", "disable", "positionDropdown", "data"];
2012-03-29 22:08:14 +04:00
this.each(function () {
if (args.length === 0 || typeof(args[0]) === "object") {
opts = args.length === 0 ? {} : $.extend({}, args[0]);
2012-03-29 22:08:14 +04:00
opts.element = $(this);
if (opts.element.get(0).tagName.toLowerCase() === "select") {
multiple = opts.element.attr("multiple");
2012-03-29 22:08:14 +04:00
} else {
multiple = opts.multiple || false;
2012-04-03 09:27:58 +04:00
if ("tags" in opts) {opts.multiple = multiple = true;}
2012-03-29 22:08:14 +04:00
}
select2 = multiple ? new MultiSelect2() : new SingleSelect2();
select2.init(opts);
} else if (typeof(args[0]) === "string") {
if (indexOf(args[0], allowedMethods) < 0) {
throw "Unknown method: " + args[0];
}
value = undefined;
select2 = $(this).data("select2");
2012-04-12 10:28:54 +04:00
if (select2 === undefined) return;
if (args[0] === "container") {
value=select2.container;
} else {
value = select2[args[0]].apply(select2, args.slice(1));
}
2012-03-29 22:08:14 +04:00
if (value !== undefined) {return false;}
} else {
throw "Invalid arguments to select2 plugin: " + args;
}
});
return (value === undefined) ? this : value;
};
2012-04-10 20:46:20 +04:00
// exports
2012-04-02 19:36:55 +04:00
window.Select2 = {
query: {
ajax: ajax,
2012-04-10 20:12:19 +04:00
local: local,
tags: tags
2012-04-02 19:36:55 +04:00
}, util: {
debounce: debounce,
markMatch: markMatch
2012-04-02 19:36:55 +04:00
}, "class": {
"abstract": AbstractSelect2,
"single": SingleSelect2,
"multi": MultiSelect2
2012-04-02 19:36:55 +04:00
}
};
2012-04-10 20:46:20 +04:00
}(jQuery));