select2.js 75 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109
  1. /*
  2. Copyright 2012 Igor Vaynberg
  3. Version: @@ver@@ Timestamp: @@timestamp@@
  4. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in
  5. compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:
  6. http://www.apache.org/licenses/LICENSE-2.0
  7. Unless required by applicable law or agreed to in writing, software distributed under the License is
  8. distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  9. See the License for the specific language governing permissions and limitations under the License.
  10. */
  11. (function ($) {
  12. if(typeof $.fn.each2 == "undefined"){
  13. $.fn.extend({
  14. /*
  15. * 4-10 times faster .each replacement
  16. * use it carefully, as it overrides jQuery context of element on each iteration
  17. */
  18. each2 : function (c) {
  19. var j = $([0]), i = -1, l = this.length;
  20. while (
  21. ++i < l
  22. && (j.context = j[0] = this[i])
  23. && c.call(j[0], i, j) !== false //"this"=DOM, i=index, j=jQuery object
  24. );
  25. return this;
  26. }
  27. });
  28. }
  29. })(jQuery);
  30. (function ($, undefined) {
  31. "use strict";
  32. /*global document, window, jQuery, console */
  33. if (window.Select2 !== undefined) {
  34. return;
  35. }
  36. var KEY, AbstractSelect2, SingleSelect2, MultiSelect2, nextUid, sizer;
  37. KEY = {
  38. TAB: 9,
  39. ENTER: 13,
  40. ESC: 27,
  41. SPACE: 32,
  42. LEFT: 37,
  43. UP: 38,
  44. RIGHT: 39,
  45. DOWN: 40,
  46. SHIFT: 16,
  47. CTRL: 17,
  48. ALT: 18,
  49. PAGE_UP: 33,
  50. PAGE_DOWN: 34,
  51. HOME: 36,
  52. END: 35,
  53. BACKSPACE: 8,
  54. DELETE: 46,
  55. isArrow: function (k) {
  56. k = k.which ? k.which : k;
  57. switch (k) {
  58. case KEY.LEFT:
  59. case KEY.RIGHT:
  60. case KEY.UP:
  61. case KEY.DOWN:
  62. return true;
  63. }
  64. return false;
  65. },
  66. isControl: function (k) {
  67. k = k.which ? k.which : k;
  68. switch (k) {
  69. case KEY.SHIFT:
  70. case KEY.CTRL:
  71. case KEY.ALT:
  72. return true;
  73. }
  74. if (k.metaKey) return true;
  75. return false;
  76. },
  77. isFunctionKey: function (k) {
  78. k = k.which ? k.which : k;
  79. return k >= 112 && k <= 123;
  80. }
  81. };
  82. nextUid=(function() { var counter=1; return function() { return counter++; }; }());
  83. function indexOf(value, array) {
  84. var i = 0, l = array.length, v;
  85. if (typeof value === "undefined") {
  86. return -1;
  87. }
  88. if (value.constructor === String) {
  89. for (; i < l; i = i + 1) if (value.localeCompare(array[i]) === 0) return i;
  90. } else {
  91. for (; i < l; i = i + 1) {
  92. v = array[i];
  93. if (v.constructor === String) {
  94. if (v.localeCompare(value) === 0) return i;
  95. } else {
  96. if (v === value) return i;
  97. }
  98. }
  99. }
  100. return -1;
  101. }
  102. /**
  103. * Compares equality of a and b taking into account that a and b may be strings, in which case localeCompare is used
  104. * @param a
  105. * @param b
  106. */
  107. function equal(a, b) {
  108. if (a === b) return true;
  109. if (a === undefined || b === undefined) return false;
  110. if (a === null || b === null) return false;
  111. if (a.constructor === String) return a.localeCompare(b) === 0;
  112. if (b.constructor === String) return b.localeCompare(a) === 0;
  113. return false;
  114. }
  115. /**
  116. * Splits the string into an array of values, trimming each value. An empty array is returned for nulls or empty
  117. * strings
  118. * @param string
  119. * @param separator
  120. */
  121. function splitVal(string, separator) {
  122. var val, i, l;
  123. if (string === null || string.length < 1) return [];
  124. val = string.split(separator);
  125. for (i = 0, l = val.length; i < l; i = i + 1) val[i] = $.trim(val[i]);
  126. return val;
  127. }
  128. function getSideBorderPadding(element) {
  129. return element.outerWidth() - element.width();
  130. }
  131. function installKeyUpChangeEvent(element) {
  132. var key="keyup-change-value";
  133. element.bind("keydown", function () {
  134. if ($.data(element, key) === undefined) {
  135. $.data(element, key, element.val());
  136. }
  137. });
  138. element.bind("keyup", function () {
  139. var val= $.data(element, key);
  140. if (val !== undefined && element.val() !== val) {
  141. $.removeData(element, key);
  142. element.trigger("keyup-change");
  143. }
  144. });
  145. }
  146. $(document).delegate("*", "mousemove", function (e) {
  147. $.data(document, "select2-lastpos", {x: e.pageX, y: e.pageY});
  148. });
  149. /**
  150. * filters mouse events so an event is fired only if the mouse moved.
  151. *
  152. * filters out mouse events that occur when mouse is stationary but
  153. * the elements under the pointer are scrolled.
  154. */
  155. function installFilteredMouseMove(element) {
  156. element.bind("mousemove", function (e) {
  157. var lastpos = $.data(document, "select2-lastpos");
  158. if (lastpos === undefined || lastpos.x !== e.pageX || lastpos.y !== e.pageY) {
  159. $(e.target).trigger("mousemove-filtered", e);
  160. }
  161. });
  162. }
  163. /**
  164. * Debounces a function. Returns a function that calls the original fn function only if no invocations have been made
  165. * within the last quietMillis milliseconds.
  166. *
  167. * @param quietMillis number of milliseconds to wait before invoking fn
  168. * @param fn function to be debounced
  169. * @return debounced version of fn
  170. */
  171. function debounce(quietMillis, fn) {
  172. var timeout;
  173. return function () {
  174. window.clearTimeout(timeout);
  175. timeout = window.setTimeout(fn, quietMillis);
  176. };
  177. }
  178. /**
  179. * A simple implementation of a thunk
  180. * @param formula function used to lazily initialize the thunk
  181. * @return {Function}
  182. */
  183. function thunk(formula) {
  184. var evaluated = false,
  185. value;
  186. return function() {
  187. if (evaluated === false) { value = formula(); evaluated = true; }
  188. return value;
  189. };
  190. };
  191. function installDebouncedScroll(threshold, element) {
  192. var notify = debounce(threshold, function (e) { element.trigger("scroll-debounced", e);});
  193. element.bind("scroll", function (e) {
  194. if (indexOf(e.target, element.get()) >= 0) notify(e);
  195. });
  196. }
  197. function killEvent(event) {
  198. event.preventDefault();
  199. event.stopPropagation();
  200. }
  201. function measureTextWidth(e) {
  202. if (!sizer){
  203. var style = e[0].currentStyle || window.getComputedStyle(e[0], null);
  204. sizer = $("<div></div>").css({
  205. position: "absolute",
  206. left: "-10000px",
  207. top: "-10000px",
  208. display: "none",
  209. fontSize: style.fontSize,
  210. fontFamily: style.fontFamily,
  211. fontStyle: style.fontStyle,
  212. fontWeight: style.fontWeight,
  213. letterSpacing: style.letterSpacing,
  214. textTransform: style.textTransform,
  215. whiteSpace: "nowrap"
  216. });
  217. $("body").append(sizer);
  218. }
  219. sizer.text(e.val());
  220. return sizer.width();
  221. }
  222. function markMatch(text, term, markup) {
  223. var match=text.toUpperCase().indexOf(term.toUpperCase()),
  224. tl=term.length;
  225. if (match<0) {
  226. markup.push(text);
  227. return;
  228. }
  229. markup.push(text.substring(0, match));
  230. markup.push("<span class='select2-match'>");
  231. markup.push(text.substring(match, match + tl));
  232. markup.push("</span>");
  233. markup.push(text.substring(match + tl, text.length));
  234. }
  235. /**
  236. * Produces an ajax-based query function
  237. *
  238. * @param options object containing configuration paramters
  239. * @param options.transport function that will be used to execute the ajax request. must be compatible with parameters supported by $.ajax
  240. * @param options.url url for the data
  241. * @param options.data a function(searchTerm, pageNumber, context) that should return an object containing query string parameters for the above url.
  242. * @param options.dataType request data type: ajax, jsonp, other datatatypes supported by jQuery's $.ajax function or the transport function if specified
  243. * @param options.quietMillis (optional) milliseconds to wait before making the ajaxRequest, helps debounce the ajax function if invoked too often
  244. * @param options.results a function(remoteData, pageNumber) that converts data returned form the remote request to the format expected by Select2.
  245. * The expected format is an object containing the following keys:
  246. * results array of objects that will be used as choices
  247. * more (optional) boolean indicating whether there are more results available
  248. * Example: {results:[{id:1, text:'Red'},{id:2, text:'Blue'}], more:true}
  249. */
  250. function ajax(options) {
  251. var timeout, // current scheduled but not yet executed request
  252. requestSequence = 0, // sequence used to drop out-of-order responses
  253. handler = null,
  254. quietMillis = options.quietMillis || 100;
  255. return function (query) {
  256. window.clearTimeout(timeout);
  257. timeout = window.setTimeout(function () {
  258. requestSequence += 1; // increment the sequence
  259. var requestNumber = requestSequence, // this request's sequence number
  260. data = options.data, // ajax data function
  261. transport = options.transport || $.ajax,
  262. type = options.type || 'GET'; // set type of request (GET or POST)
  263. data = data.call(this, query.term, query.page, query.context);
  264. if( null !== handler) { handler.abort(); }
  265. handler = transport.call(null, {
  266. url: options.url,
  267. dataType: options.dataType,
  268. data: data,
  269. type: type,
  270. success: function (data) {
  271. if (requestNumber < requestSequence) {
  272. return;
  273. }
  274. // TODO 3.0 - replace query.page with query so users have access to term, page, etc.
  275. var results = options.results(data, query.page);
  276. query.callback(results);
  277. }
  278. });
  279. }, quietMillis);
  280. };
  281. }
  282. /**
  283. * Produces a query function that works with a local array
  284. *
  285. * @param options object containing configuration parameters. The options parameter can either be an array or an
  286. * object.
  287. *
  288. * If the array form is used it is assumed that it contains objects with 'id' and 'text' keys.
  289. *
  290. * If the object form is used ti is assumed that it contains 'data' and 'text' keys. The 'data' key should contain
  291. * an array of objects that will be used as choices. These objects must contain at least an 'id' key. The 'text'
  292. * key can either be a String in which case it is expected that each element in the 'data' array has a key with the
  293. * value of 'text' which will be used to match choices. Alternatively, text can be a function(item) that can extract
  294. * the text.
  295. */
  296. function local(options) {
  297. var data = options, // data elements
  298. dataText,
  299. text = function (item) { return ""+item.text; }; // function used to retrieve the text portion of a data item that is matched against the search
  300. if (!$.isArray(data)) {
  301. text = data.text;
  302. // if text is not a function we assume it to be a key name
  303. if (!$.isFunction(text)) {
  304. 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
  305. text = function (item) { return item[dataText]; };
  306. }
  307. data = data.results;
  308. }
  309. return function (query) {
  310. var t = query.term, filtered = {};
  311. if (t === "") {
  312. query.callback({results: data});
  313. return;
  314. }
  315. filtered.results = $(data)
  316. .filter(function () {return query.matcher(t, text(this));})
  317. .get();
  318. query.callback(filtered);
  319. };
  320. }
  321. // TODO javadoc
  322. function tags(data) {
  323. // TODO even for a function we should probably return a wrapper that does the same object/string check as
  324. // the function for arrays. otherwise only functions that return objects are supported.
  325. if ($.isFunction(data)) {
  326. return data;
  327. }
  328. // if not a function we assume it to be an array
  329. return function (query) {
  330. var t = query.term, filtered = {results: []};
  331. $(data).each(function () {
  332. var isObject = this.text !== undefined,
  333. text = isObject ? this.text : this;
  334. if (t === "" || query.matcher(t, text)) {
  335. filtered.results.push(isObject ? this : {id: this, text: this});
  336. }
  337. });
  338. query.callback(filtered);
  339. };
  340. }
  341. /**
  342. * blurs any Select2 container that has focus when an element outside them was clicked or received focus
  343. *
  344. * also takes care of clicks on label tags that point to the source element
  345. */
  346. $(document).ready(function () {
  347. $(document).delegate("*", "mousedown touchend", function (e) {
  348. var target = $(e.target).closest("div.select2-container").get(0);
  349. if (target) {
  350. $(document).find("div.select2-container-active").each(function () {
  351. if (this !== target) $(this).data("select2").blur();
  352. });
  353. } else {
  354. target = $(e.target).closest("div.select2-drop").get(0);
  355. $(document).find("div.select2-drop-active").each(function () {
  356. if (this !== target) $(this).data("select2").blur();
  357. });
  358. }
  359. target=$(e.target);
  360. if ("LABEL" === e.target.tagName && target.attr("for").length > 0) {
  361. target = $("#"+target.attr("for"));
  362. target = target.data("select2");
  363. if (target !== undefined) { target.focus(); e.preventDefault();}
  364. }
  365. });
  366. });
  367. function evaluate(val) {
  368. return $.isFunction(val) ? val() : val;
  369. }
  370. /**
  371. * Creates a new class
  372. *
  373. * @param superClass
  374. * @param methods
  375. */
  376. function clazz(SuperClass, methods) {
  377. var constructor = function () {};
  378. constructor.prototype = new SuperClass;
  379. constructor.prototype.constructor = constructor;
  380. constructor.prototype.parent = SuperClass.prototype;
  381. constructor.prototype = $.extend(constructor.prototype, methods);
  382. return constructor;
  383. }
  384. AbstractSelect2 = clazz(Object, {
  385. // abstract
  386. bind: function (func) {
  387. var self = this;
  388. return function () {
  389. func.apply(self, arguments);
  390. };
  391. },
  392. // abstract
  393. init: function (opts) {
  394. var results, search, resultsSelector = ".select2-results";
  395. // prepare options
  396. this.opts = opts = this.prepareOpts(opts);
  397. this.id=opts.id;
  398. // destroy if called on an existing component
  399. if (opts.element.data("select2") !== undefined &&
  400. opts.element.data("select2") !== null) {
  401. this.destroy();
  402. }
  403. this.enabled=true;
  404. this.container = this.createContainer();
  405. // cache the body so future lookups are cheap
  406. this.body = thunk(function() { return opts.element.closest("body"); });
  407. if (opts.element.attr("class") !== undefined) {
  408. this.container.addClass(opts.element.attr("class"));
  409. }
  410. this.container.css(evaluate(opts.containerCss));
  411. this.container.addClass(evaluate(opts.containerCssClass));
  412. // swap container for the element
  413. this.opts.element
  414. .data("select2", this)
  415. .hide()
  416. .after(this.container);
  417. this.container.data("select2", this);
  418. this.dropdown = this.container.find(".select2-drop");
  419. this.dropdown.css(evaluate(opts.dropdownCss));
  420. this.dropdown.addClass(evaluate(opts.dropdownCssClass));
  421. this.dropdown.data("select2", this);
  422. this.results = results = this.container.find(resultsSelector);
  423. this.search = search = this.container.find("input.select2-input");
  424. this.resultsPage = 0;
  425. this.context = null;
  426. // initialize the container
  427. this.initContainer();
  428. this.initContainerWidth();
  429. installFilteredMouseMove(this.results);
  430. this.dropdown.delegate(resultsSelector, "mousemove-filtered", this.bind(this.highlightUnderEvent));
  431. installDebouncedScroll(80, this.results);
  432. this.dropdown.delegate(resultsSelector, "scroll-debounced", this.bind(this.loadMoreIfNeeded));
  433. // if jquery.mousewheel plugin is installed we can prevent out-of-bounds scrolling of results via mousewheel
  434. if ($.fn.mousewheel) {
  435. results.mousewheel(function (e, delta, deltaX, deltaY) {
  436. var top = results.scrollTop(), height;
  437. if (deltaY > 0 && top - deltaY <= 0) {
  438. results.scrollTop(0);
  439. killEvent(e);
  440. } else if (deltaY < 0 && results.get(0).scrollHeight - results.scrollTop() + deltaY <= results.height()) {
  441. results.scrollTop(results.get(0).scrollHeight - results.height());
  442. killEvent(e);
  443. }
  444. });
  445. }
  446. installKeyUpChangeEvent(search);
  447. search.bind("keyup-change", this.bind(this.updateResults));
  448. search.bind("focus", function () { search.addClass("select2-focused"); if (search.val() === " ") search.val(""); });
  449. search.bind("blur", function () { search.removeClass("select2-focused");});
  450. this.dropdown.delegate(resultsSelector, "click", this.bind(function (e) {
  451. if ($(e.target).closest(".select2-result-selectable:not(.select2-disabled)").length > 0) {
  452. this.highlightUnderEvent(e);
  453. this.selectHighlighted(e);
  454. } else {
  455. this.focusSearch();
  456. }
  457. killEvent(e);
  458. }));
  459. // trap all mouse events from leaving the dropdown. sometimes there may be a modal that is listening
  460. // for mouse events outside of itself so it can close itself. since the dropdown is now outside the select2's
  461. // dom it will trigger the popup close, which is not what we want
  462. this.dropdown.bind("click mouseup mousedown", function (e) { e.stopPropagation(); });
  463. if ($.isFunction(this.opts.initSelection)) {
  464. // initialize selection based on the current value of the source element
  465. this.initSelection();
  466. // if the user has provided a function that can set selection based on the value of the source element
  467. // we monitor the change event on the element and trigger it, allowing for two way synchronization
  468. this.monitorSource();
  469. }
  470. if (opts.element.is(":disabled")) this.disable();
  471. },
  472. // abstract
  473. destroy: function () {
  474. var select2 = this.opts.element.data("select2");
  475. if (select2 !== undefined) {
  476. select2.container.remove();
  477. select2.dropdown.remove();
  478. select2.opts.element
  479. .removeData("select2")
  480. .unbind(".select2")
  481. .show();
  482. }
  483. },
  484. // abstract
  485. prepareOpts: function (opts) {
  486. var element, select, idKey;
  487. element = opts.element;
  488. if (element.get(0).tagName.toLowerCase() === "select") {
  489. this.select = select = opts.element;
  490. }
  491. //Custom tags separator.
  492. opts.separator = opts.separator || ",";
  493. if (select) {
  494. // these options are not allowed when attached to a select because they are picked up off the element itself
  495. $.each(["id", "multiple", "ajax", "query", "createSearchChoice", "initSelection", "data", "tags"], function () {
  496. if (this in opts) {
  497. throw new Error("Option '" + this + "' is not allowed for Select2 when attached to a <select> element.");
  498. }
  499. });
  500. }
  501. opts = $.extend({}, {
  502. populateResults: function(container, results, query) {
  503. var populate, data, result, children, id=this.opts.id;
  504. populate=function(results, container, depth) {
  505. var i, l, result, selectable, compound, node, label, innerContainer, formatted;
  506. for (i = 0, l = results.length; i < l; i = i + 1) {
  507. result=results[i];
  508. selectable=id(result) !== undefined;
  509. compound=("children" in result) && result.children.length > 0;
  510. node=$("<li></li>");
  511. node.addClass("select2-results-dept-"+depth);
  512. node.addClass("select2-result");
  513. node.addClass(selectable ? "select2-result-selectable" : "select2-result-unselectable");
  514. if (compound) { node.addClass("select2-result-with-children"); }
  515. label=$("<div></div>");
  516. label.addClass("select2-result-label");
  517. formatted=opts.formatResult(result, label, query);
  518. if (formatted!==undefined) {
  519. label.html(formatted);
  520. }
  521. node.append(label);
  522. if (compound) {
  523. innerContainer=$("<ul></ul>");
  524. innerContainer.addClass("select2-result-sub");
  525. populate(result.children, innerContainer, depth+1);
  526. node.append(innerContainer);
  527. }
  528. node.data("select2-data", result);
  529. container.append(node);
  530. }
  531. };
  532. populate(results, container, 0);
  533. }
  534. }, $.fn.select2.defaults, opts);
  535. if (typeof(opts.id) !== "function") {
  536. idKey = opts.id;
  537. opts.id = function (e) { return e[idKey]; };
  538. }
  539. if (select) {
  540. opts.query = this.bind(function (query) {
  541. var data = { results: [], more: false },
  542. term = query.term,
  543. children, firstChild, process;
  544. process=function(element, collection) {
  545. var group;
  546. if (element.is("option")) {
  547. if (query.matcher(term, element.text(), element)) {
  548. collection.push({id:element.attr("value"), text:element.text(), element: element.get()});
  549. }
  550. } else if (element.is("optgroup")) {
  551. group={text:element.attr("label"), children:[], element: element.get()};
  552. element.children().each2(function(i, elm) { process(elm, group.children); });
  553. if (group.children.length>0) {
  554. collection.push(group);
  555. }
  556. }
  557. };
  558. children=element.children();
  559. // ignore the placeholder option if there is one
  560. if (this.getPlaceholder() !== undefined && children.length > 0) {
  561. firstChild = children[0];
  562. if ($(firstChild).text() === "") {
  563. children=children.not(firstChild);
  564. }
  565. }
  566. children.each2(function(i, elm) { process(elm, data.results); });
  567. query.callback(data);
  568. });
  569. // this is needed because inside val() we construct choices from options and there id is hardcoded
  570. opts.id=function(e) { return e.id; };
  571. } else {
  572. if (!("query" in opts)) {
  573. if ("ajax" in opts) {
  574. opts.query = ajax(opts.ajax);
  575. } else if ("data" in opts) {
  576. opts.query = local(opts.data);
  577. } else if ("tags" in opts) {
  578. opts.query = tags(opts.tags);
  579. opts.createSearchChoice = function (term) { return {id: term, text: term}; };
  580. opts.initSelection = function (element, callback) {
  581. var data = [];
  582. $(splitVal(element.val(), opts.separator)).each(function () {
  583. data.push({id: this, text: this});
  584. });
  585. callback(data);
  586. };
  587. }
  588. }
  589. }
  590. if (typeof(opts.query) !== "function") {
  591. throw "query function not defined for Select2 " + opts.element.attr("id");
  592. }
  593. return opts;
  594. },
  595. /**
  596. * Monitor the original element for changes and update select2 accordingly
  597. */
  598. // abstract
  599. monitorSource: function () {
  600. this.opts.element.bind("change.select2", this.bind(function (e) {
  601. if (this.opts.element.data("select2-change-triggered") !== true) {
  602. this.initSelection();
  603. }
  604. }));
  605. },
  606. /**
  607. * Triggers the change event on the source element
  608. */
  609. // abstract
  610. triggerChange: function (details) {
  611. details = details || {};
  612. details= $.extend({}, details, { type: "change", val: this.val() });
  613. // prevents recursive triggering
  614. this.opts.element.data("select2-change-triggered", true);
  615. this.opts.element.trigger(details);
  616. this.opts.element.data("select2-change-triggered", false);
  617. },
  618. // abstract
  619. enable: function() {
  620. if (this.enabled) return;
  621. this.enabled=true;
  622. this.container.removeClass("select2-container-disabled");
  623. },
  624. // abstract
  625. disable: function() {
  626. if (!this.enabled) return;
  627. this.close();
  628. this.enabled=false;
  629. this.container.addClass("select2-container-disabled");
  630. },
  631. // abstract
  632. opened: function () {
  633. return this.container.hasClass("select2-dropdown-open");
  634. },
  635. // abstract
  636. positionDropdown: function() {
  637. var offset = this.container.offset(),
  638. height = this.container.outerHeight(),
  639. width = this.container.outerWidth(),
  640. dropHeight = this.dropdown.outerHeight(),
  641. viewportBottom = $(window).scrollTop() + document.documentElement.clientHeight,
  642. dropTop = offset.top + height,
  643. enoughRoomBelow = dropTop + dropHeight <= viewportBottom,
  644. enoughRoomAbove = (offset.top - dropHeight) >= this.body().scrollTop(),
  645. aboveNow = this.dropdown.hasClass("select2-drop-above"),
  646. above,
  647. css;
  648. // console.log("below/ droptop:", dropTop, "dropHeight", dropHeight, "sum", (dropTop+dropHeight)+" viewport bottom", viewportBottom, "enough?", enoughRoomBelow);
  649. // console.log("above/ offset.top", offset.top, "dropHeight", dropHeight, "top", (offset.top-dropHeight), "scrollTop", this.body().scrollTop(), "enough?", enoughRoomAbove);
  650. // always prefer the current above/below alignment, unless there is not enough room
  651. if (aboveNow) {
  652. above = true;
  653. if (!enoughRoomAbove && enoughRoomBelow) above = false;
  654. } else {
  655. above = false;
  656. if (!enoughRoomBelow && enoughRoomAbove) above = true;
  657. }
  658. if (above) {
  659. dropTop = offset.top - dropHeight;
  660. this.container.addClass("select2-drop-above");
  661. this.dropdown.addClass("select2-drop-above");
  662. }
  663. else {
  664. this.container.removeClass("select2-drop-above");
  665. this.dropdown.removeClass("select2-drop-above");
  666. }
  667. css = {
  668. top:dropTop,
  669. left:offset.left,
  670. width:width
  671. };
  672. this.dropdown.css(css);
  673. },
  674. // abstract
  675. shouldOpen: function() {
  676. var event;
  677. if (this.opened()) return false;
  678. event = jQuery.Event("open");
  679. this.opts.element.trigger(event);
  680. return !event.isDefaultPrevented();
  681. },
  682. // abstract
  683. clearDropdownAlignmentPreference: function() {
  684. // clear the classes used to figure out the preference of where the dropdown should be opened
  685. this.container.removeClass("select2-drop-above");
  686. this.dropdown.removeClass("select2-drop-above");
  687. },
  688. /**
  689. * Opens the dropdown
  690. *
  691. * @return {Boolean} whether or not dropdown was opened. This method will return false if, for example,
  692. * the dropdown is already open, or if the 'open' event listener on the element called preventDefault().
  693. */
  694. // abstract
  695. open: function () {
  696. if (!this.shouldOpen()) return false;
  697. window.setTimeout(this.bind(this.opening), 1);
  698. return true;
  699. },
  700. /**
  701. * Performs the opening of the dropdown
  702. */
  703. // abstract
  704. opening: function() {
  705. this.clearDropdownAlignmentPreference();
  706. if (this.search.val() === " ") { this.search.val(""); }
  707. this.dropdown.addClass("select2-drop-active");
  708. this.container.addClass("select2-dropdown-open").addClass("select2-container-active");
  709. this.updateResults(true);
  710. if(this.dropdown[0] !== this.body().children().last()[0]) {
  711. this.dropdown.detach().appendTo(this.body());
  712. }
  713. this.dropdown.show();
  714. this.ensureHighlightVisible();
  715. this.positionDropdown();
  716. this.focusSearch();
  717. },
  718. // abstract
  719. close: function () {
  720. if (!this.opened()) return;
  721. this.clearDropdownAlignmentPreference();
  722. this.dropdown.hide();
  723. this.container.removeClass("select2-dropdown-open");
  724. this.results.empty();
  725. this.clearSearch();
  726. this.opts.element.trigger(jQuery.Event("close"));
  727. },
  728. // abstract
  729. clearSearch: function () {
  730. },
  731. // abstract
  732. ensureHighlightVisible: function () {
  733. var results = this.results, children, index, child, hb, rb, y, more;
  734. index = this.highlight();
  735. if (index < 0) return;
  736. if (index == 0) {
  737. // if the first element is highlighted scroll all the way to the top,
  738. // that way any unselectable headers above it will also be scrolled
  739. // into view
  740. results.scrollTop(0);
  741. return;
  742. }
  743. children = results.find(".select2-result-selectable");
  744. child = $(children[index]);
  745. hb = child.offset().top + child.outerHeight();
  746. // if this is the last child lets also make sure select2-more-results is visible
  747. if (index === children.length - 1) {
  748. more = results.find("li.select2-more-results");
  749. if (more.length > 0) {
  750. hb = more.offset().top + more.outerHeight();
  751. }
  752. }
  753. rb = results.offset().top + results.outerHeight();
  754. if (hb > rb) {
  755. results.scrollTop(results.scrollTop() + (hb - rb));
  756. }
  757. y = child.offset().top - results.offset().top;
  758. // make sure the top of the element is visible
  759. if (y < 0) {
  760. results.scrollTop(results.scrollTop() + y); // y is negative
  761. }
  762. },
  763. // abstract
  764. moveHighlight: function (delta) {
  765. var choices = this.results.find(".select2-result-selectable"),
  766. index = this.highlight();
  767. while (index > -1 && index < choices.length) {
  768. index += delta;
  769. var choice = $(choices[index]);
  770. if (choice.hasClass("select2-result-selectable") && !choice.hasClass("select2-disabled")) {
  771. this.highlight(index);
  772. break;
  773. }
  774. }
  775. },
  776. // abstract
  777. highlight: function (index) {
  778. var choices = this.results.find(".select2-result-selectable").not(".select2-disabled");
  779. if (arguments.length === 0) {
  780. return indexOf(choices.filter(".select2-highlighted")[0], choices.get());
  781. }
  782. if (index >= choices.length) index = choices.length - 1;
  783. if (index < 0) index = 0;
  784. choices.removeClass("select2-highlighted");
  785. $(choices[index]).addClass("select2-highlighted");
  786. this.ensureHighlightVisible();
  787. },
  788. // abstract
  789. countSelectableResults: function() {
  790. return this.results.find(".select2-result-selectable").not(".select2-disabled").length;
  791. },
  792. // abstract
  793. highlightUnderEvent: function (event) {
  794. var el = $(event.target).closest(".select2-result-selectable");
  795. if (el.length > 0 && !el.is(".select2-highlighted")) {
  796. var choices = this.results.find('.select2-result-selectable');
  797. this.highlight(choices.index(el));
  798. } else if (el.length == 0) {
  799. // if we are over an unselectable item remove al highlights
  800. this.results.find(".select2-highlighted").removeClass("select2-highlighted");
  801. }
  802. },
  803. // abstract
  804. loadMoreIfNeeded: function () {
  805. var results = this.results,
  806. more = results.find("li.select2-more-results"),
  807. below, // pixels the element is below the scroll fold, below==0 is when the element is starting to be visible
  808. offset = -1, // index of first element without data
  809. page = this.resultsPage + 1,
  810. self=this,
  811. term=this.search.val(),
  812. context=this.context;
  813. if (more.length === 0) return;
  814. below = more.offset().top - results.offset().top - results.height();
  815. if (below <= 0) {
  816. more.addClass("select2-active");
  817. this.opts.query({
  818. term: term,
  819. page: page,
  820. context: context,
  821. matcher: this.opts.matcher,
  822. callback: this.bind(function (data) {
  823. self.opts.populateResults.call(this, results, data.results, {term: term, page: page, context:context});
  824. if (data.more===true) {
  825. more.detach().appendTo(results.children(":last")).text(self.opts.formatLoadMore(page+1));
  826. window.setTimeout(function() { self.loadMoreIfNeeded(); }, 10);
  827. } else {
  828. more.remove();
  829. }
  830. self.positionDropdown();
  831. self.resultsPage = page;
  832. })});
  833. }
  834. },
  835. /**
  836. * @param initial whether or not this is the call to this method right after the dropdown has been opened
  837. */
  838. // abstract
  839. updateResults: function (initial) {
  840. var search = this.search, results = this.results, opts = this.opts, self=this;
  841. // if the search is currently hidden we do not alter the results
  842. if (initial !== true && (this.showSearchInput === false || !this.opened())) {
  843. return;
  844. }
  845. search.addClass("select2-active");
  846. function postRender() {
  847. results.scrollTop(0);
  848. search.removeClass("select2-active");
  849. self.positionDropdown();
  850. }
  851. function render(html) {
  852. results.html(html);
  853. postRender();
  854. }
  855. if (search.val().length < opts.minimumInputLength) {
  856. render("<li class='select2-no-results'>" + opts.formatInputTooShort(search.val(), opts.minimumInputLength) + "</li>");
  857. return;
  858. }
  859. this.resultsPage = 1;
  860. opts.query({
  861. term: search.val(),
  862. page: this.resultsPage,
  863. context: null,
  864. matcher: opts.matcher,
  865. callback: this.bind(function (data) {
  866. var def; // default choice
  867. // save context, if any
  868. this.context = (data.context===undefined) ? null : data.context;
  869. // create a default choice and prepend it to the list
  870. if (this.opts.createSearchChoice && search.val() !== "") {
  871. def = this.opts.createSearchChoice.call(null, search.val(), data.results);
  872. if (def !== undefined && def !== null && self.id(def) !== undefined && self.id(def) !== null) {
  873. if ($(data.results).filter(
  874. function () {
  875. return equal(self.id(this), self.id(def));
  876. }).length === 0) {
  877. data.results.unshift(def);
  878. }
  879. }
  880. }
  881. if (data.results.length === 0) {
  882. render("<li class='select2-no-results'>" + opts.formatNoMatches(search.val()) + "</li>");
  883. return;
  884. }
  885. results.empty();
  886. self.opts.populateResults.call(this, results, data.results, {term: search.val(), page: this.resultsPage, context:null});
  887. if (data.more === true) {
  888. results.children().filter(":last").append("<li class='select2-more-results'>" + opts.formatLoadMore(this.resultsPage) + "</li>");
  889. window.setTimeout(function() { self.loadMoreIfNeeded(); }, 10);
  890. }
  891. this.postprocessResults(data, initial);
  892. postRender();
  893. })});
  894. },
  895. // abstract
  896. cancel: function () {
  897. this.close();
  898. },
  899. // abstract
  900. blur: function () {
  901. this.close();
  902. this.container.removeClass("select2-container-active");
  903. this.dropdown.removeClass("select2-drop-active");
  904. // synonymous to .is(':focus'), which is available in jquery >= 1.6
  905. if (this.search[0] === document.activeElement) { this.search.blur(); }
  906. this.clearSearch();
  907. this.selection.find(".select2-search-choice-focus").removeClass("select2-search-choice-focus");
  908. },
  909. // abstract
  910. focusSearch: function () {
  911. /* we do this in a timeout so that current event processing can complete before this code is executed.
  912. this makes sure the search field is focussed even if the current event would blur it */
  913. window.setTimeout(this.bind(function () {
  914. this.search.focus();
  915. // reset the value so IE places the cursor at the end of the input box
  916. this.search.val(this.search.val());
  917. }), 10);
  918. },
  919. // abstract
  920. selectHighlighted: function () {
  921. var index=this.highlight(),
  922. highlighted=this.results.find(".select2-highlighted").not(".select2-disabled"),
  923. data = highlighted.closest('.select2-result-selectable').data("select2-data");
  924. if (data) {
  925. highlighted.addClass("select2-disabled");
  926. this.highlight(index);
  927. this.onSelect(data);
  928. }
  929. },
  930. // abstract
  931. getPlaceholder: function () {
  932. return this.opts.element.attr("placeholder") ||
  933. this.opts.element.attr("data-placeholder") || // jquery 1.4 compat
  934. this.opts.element.data("placeholder") ||
  935. this.opts.placeholder;
  936. },
  937. /**
  938. * Get the desired width for the container element. This is
  939. * derived first from option `width` passed to select2, then
  940. * the inline 'style' on the original element, and finally
  941. * falls back to the jQuery calculated element width.
  942. */
  943. // abstract
  944. initContainerWidth: function () {
  945. function resolveContainerWidth() {
  946. var style, attrs, matches, i, l;
  947. if (this.opts.width === "off") {
  948. return null;
  949. } else if (this.opts.width === "element"){
  950. return this.opts.element.outerWidth() === 0 ? 'auto' : this.opts.element.outerWidth() + 'px';
  951. } else if (this.opts.width === "copy" || this.opts.width === "resolve") {
  952. // check if there is inline style on the element that contains width
  953. style = this.opts.element.attr('style');
  954. if (style !== undefined) {
  955. attrs = style.split(';');
  956. for (i = 0, l = attrs.length; i < l; i = i + 1) {
  957. matches = attrs[i].replace(/\s/g, '')
  958. .match(/width:(([-+]?([0-9]*\.)?[0-9]+)(px|em|ex|%|in|cm|mm|pt|pc))/);
  959. if (matches !== null && matches.length >= 1)
  960. return matches[1];
  961. }
  962. }
  963. if (this.opts.width === "resolve") {
  964. // next check if css('width') can resolve a width that is percent based, this is sometimes possible
  965. // when attached to input type=hidden or elements hidden via css
  966. style = this.opts.element.css('width');
  967. if (style.indexOf("%") > 0) return style;
  968. // finally, fallback on the calculated width of the element
  969. return (this.opts.element.outerWidth() === 0 ? 'auto' : this.opts.element.outerWidth() + 'px');
  970. }
  971. return null;
  972. } else if ($.isFunction(this.opts.width)) {
  973. return this.opts.width();
  974. } else {
  975. return this.opts.width;
  976. }
  977. };
  978. var width = resolveContainerWidth.call(this);
  979. if (width !== null) {
  980. this.container.attr("style", "width: "+width);
  981. }
  982. }
  983. });
  984. SingleSelect2 = clazz(AbstractSelect2, {
  985. // single
  986. createContainer: function () {
  987. var container = $("<div></div>", {
  988. "class": "select2-container"
  989. }).html([
  990. " <a href='javascript:void(0)' class='select2-choice'>",
  991. " <span></span><abbr class='select2-search-choice-close' style='display:none;'></abbr>",
  992. " <div><b></b></div>" ,
  993. "</a>",
  994. " <div class='select2-drop select2-offscreen'>" ,
  995. " <div class='select2-search'>" ,
  996. " <input type='text' autocomplete='off' class='select2-input'/>" ,
  997. " </div>" ,
  998. " <ul class='select2-results'>" ,
  999. " </ul>" ,
  1000. "</div>"].join(""));
  1001. return container;
  1002. },
  1003. // single
  1004. opening: function () {
  1005. this.parent.opening.apply(this, arguments);
  1006. this.dropdown.removeClass("select2-offscreen");
  1007. },
  1008. // single
  1009. close: function () {
  1010. if (!this.opened()) return;
  1011. this.parent.close.apply(this, arguments);
  1012. this.dropdown.removeAttr("style").addClass("select2-offscreen").insertAfter(this.selection).show();
  1013. },
  1014. // single
  1015. focus: function () {
  1016. this.close();
  1017. this.container.focus();
  1018. },
  1019. // single
  1020. isFocused: function () {
  1021. return this.selection[0] === document.activeElement;
  1022. },
  1023. // single
  1024. cancel: function () {
  1025. this.parent.cancel.apply(this, arguments);
  1026. this.container.focus();
  1027. },
  1028. // single
  1029. initContainer: function () {
  1030. var selection,
  1031. container = this.container,
  1032. dropdown = this.dropdown,
  1033. clickingInside = false;
  1034. this.selection = selection = container.find(".select2-choice");
  1035. this.search.bind("keydown", this.bind(function (e) {
  1036. if (!this.enabled) return;
  1037. if (e.which === KEY.PAGE_UP || e.which === KEY.PAGE_DOWN) {
  1038. // prevent the page from scrolling
  1039. killEvent(e);
  1040. return;
  1041. }
  1042. if (this.opened()) {
  1043. switch (e.which) {
  1044. case KEY.UP:
  1045. case KEY.DOWN:
  1046. this.moveHighlight((e.which === KEY.UP) ? -1 : 1);
  1047. killEvent(e);
  1048. return;
  1049. case KEY.TAB:
  1050. case KEY.ENTER:
  1051. this.selectHighlighted();
  1052. killEvent(e);
  1053. return;
  1054. case KEY.ESC:
  1055. this.cancel(e);
  1056. killEvent(e);
  1057. return;
  1058. }
  1059. }
  1060. }));
  1061. selection.bind("click", this.bind(function (e) {
  1062. clickingInside = true;
  1063. if (this.opened()) {
  1064. this.close();
  1065. this.container.focus();
  1066. } else if (this.enabled) {
  1067. this.open();
  1068. }
  1069. killEvent(e);
  1070. clickingInside = false;
  1071. }));
  1072. dropdown.bind("click", this.bind(function() { this.search.focus(); }));
  1073. container.bind("focus", this.bind(function() {
  1074. // allows the container to recieve the keyup event
  1075. this.container.attr("tabindex", 1);
  1076. }));
  1077. container.bind("blur", this.bind(function() {
  1078. // remove the tabindex so the tab key works properly
  1079. this.container.attr("tabindex", -1);
  1080. }));
  1081. container.bind("keydown", this.bind(function(e) {
  1082. if (!this.enabled) return;
  1083. this.container.attr("tabindex", -1);
  1084. if (e.which === KEY.PAGE_UP || e.which === KEY.PAGE_DOWN) {
  1085. // prevent the page from scrolling
  1086. killEvent(e);
  1087. return;
  1088. }
  1089. if (!this.opened()) {
  1090. if (e.which === KEY.TAB || KEY.isControl(e) || KEY.isFunctionKey(e) || e.which === KEY.ESC) {
  1091. return;
  1092. }
  1093. this.open();
  1094. if (e.which === KEY.ENTER) {
  1095. // do not propagate the event otherwise we open, and propagate enter which closes
  1096. killEvent(e);
  1097. return;
  1098. }
  1099. var keyWritten = String.fromCharCode(e.which).toLowerCase();
  1100. if (e.shiftKey) {
  1101. keyWritten = keyWritten.toUpperCase();
  1102. }
  1103. this.search.val(keyWritten);
  1104. }
  1105. }));
  1106. selection.delegate("abbr", "click", this.bind(function (e) {
  1107. if (!this.enabled) return;
  1108. this.clear();
  1109. killEvent(e);
  1110. this.close();
  1111. this.triggerChange();
  1112. this.container.focus();
  1113. }));
  1114. selection.bind("focus", this.bind(function() { this.search.focus(); }));
  1115. this.setPlaceholder();
  1116. this.search.bind("focus", this.bind(function() {
  1117. this.container.addClass("select2-container-active");
  1118. }));
  1119. },
  1120. // single
  1121. clear: function() {
  1122. this.opts.element.val("");
  1123. this.selection.find("span").empty();
  1124. this.selection.removeData("select2-data");
  1125. this.setPlaceholder();
  1126. },
  1127. /**
  1128. * Sets selection based on source element's value
  1129. */
  1130. // single
  1131. initSelection: function () {
  1132. var selected;
  1133. if (this.opts.element.val() === "") {
  1134. this.close();
  1135. this.setPlaceholder();
  1136. } else {
  1137. var self = this;
  1138. this.opts.initSelection.call(null, this.opts.element, function(selected){
  1139. if (selected !== undefined && selected !== null) {
  1140. self.updateSelection(selected);
  1141. self.close();
  1142. self.setPlaceholder();
  1143. }
  1144. });
  1145. }
  1146. },
  1147. // single
  1148. prepareOpts: function () {
  1149. var opts = this.parent.prepareOpts.apply(this, arguments);
  1150. if (opts.element.get(0).tagName.toLowerCase() === "select") {
  1151. // install the selection initializer
  1152. opts.initSelection = function (element, callback) {
  1153. var selected = element.find(":selected");
  1154. // a single select box always has a value, no need to null check 'selected'
  1155. if ($.isFunction(callback))
  1156. callback({id: selected.attr("value"), text: selected.text()});
  1157. };
  1158. }
  1159. return opts;
  1160. },
  1161. // single
  1162. setPlaceholder: function () {
  1163. var placeholder = this.getPlaceholder();
  1164. if (this.opts.element.val() === "" && placeholder !== undefined) {
  1165. // check for a first blank option if attached to a select
  1166. if (this.select && this.select.find("option:first").text() !== "") return;
  1167. this.selection.find("span").html(placeholder);
  1168. this.selection.addClass("select2-default");
  1169. this.selection.find("abbr").hide();
  1170. }
  1171. },
  1172. // single
  1173. postprocessResults: function (data, initial) {
  1174. var selected = 0, self = this, showSearchInput = true;
  1175. // find the selected element in the result list
  1176. this.results.find(".select2-result-selectable").each2(function (i, elm) {
  1177. if (equal(self.id(elm.data("select2-data")), self.opts.element.val())) {
  1178. selected = i;
  1179. return false;
  1180. }
  1181. });
  1182. // and highlight it
  1183. this.highlight(selected);
  1184. // hide the search box if this is the first we got the results and there are a few of them
  1185. if (initial === true) {
  1186. // TODO below we use data.results.length, but what we really need is something recursive to calc the length
  1187. // TODO in case there are optgroups
  1188. showSearchInput = this.showSearchInput = data.results.length >= this.opts.minimumResultsForSearch;
  1189. this.dropdown.find(".select2-search")[showSearchInput ? "removeClass" : "addClass"]("select2-search-hidden");
  1190. //add "select2-with-searchbox" to the container if search box is shown
  1191. $(this.dropdown, this.container)[showSearchInput ? "addClass" : "removeClass"]("select2-with-searchbox");
  1192. }
  1193. },
  1194. // single
  1195. onSelect: function (data) {
  1196. var old = this.opts.element.val();
  1197. this.opts.element.val(this.id(data));
  1198. this.updateSelection(data);
  1199. this.close();
  1200. this.container.focus();
  1201. if (!equal(old, this.id(data))) { this.triggerChange(); }
  1202. },
  1203. // single
  1204. updateSelection: function (data) {
  1205. var container=this.selection.find("span"), formatted;
  1206. this.selection.data("select2-data", data);
  1207. container.empty();
  1208. formatted=this.opts.formatSelection(data, container);
  1209. if (formatted !== undefined) {
  1210. container.append(formatted);
  1211. }
  1212. this.selection.removeClass("select2-default");
  1213. if (this.opts.allowClear && this.getPlaceholder() !== undefined) {
  1214. this.selection.find("abbr").show();
  1215. }
  1216. },
  1217. // single
  1218. val: function () {
  1219. var val, data = null, self = this;
  1220. if (arguments.length === 0) {
  1221. return this.opts.element.val();
  1222. }
  1223. val = arguments[0];
  1224. if (this.select) {
  1225. this.select
  1226. .val(val)
  1227. .find(":selected").each2(function (i, elm) {
  1228. data = {id: elm.attr("value"), text: elm.text()};
  1229. return false;
  1230. });
  1231. this.updateSelection(data);
  1232. this.setPlaceholder();
  1233. } else {
  1234. if (this.opts.initSelection === undefined) {
  1235. throw new Error("cannot call val() if initSelection() is not defined");
  1236. }
  1237. // val is an id. !val is true for [undefined,null,'']
  1238. if (!val) {
  1239. this.clear();
  1240. return;
  1241. }
  1242. this.opts.initSelection(this.opts.element, function(data){
  1243. self.opts.element.val(!data ? "" : self.id(data));
  1244. self.updateSelection(data);
  1245. self.setPlaceholder();
  1246. });
  1247. }
  1248. },
  1249. // single
  1250. clearSearch: function () {
  1251. this.search.val("");
  1252. },
  1253. // single
  1254. data: function(value) {
  1255. var data;
  1256. if (arguments.length === 0) {
  1257. data = this.selection.data("select2-data");
  1258. if (data == undefined) data = null;
  1259. return data;
  1260. } else {
  1261. if (!value || value === "") {
  1262. this.clear();
  1263. } else {
  1264. this.opts.element.val(!value ? "" : this.id(value));
  1265. this.updateSelection(value);
  1266. }
  1267. }
  1268. }
  1269. });
  1270. MultiSelect2 = clazz(AbstractSelect2, {
  1271. // multi
  1272. createContainer: function () {
  1273. var container = $("<div></div>", {
  1274. "class": "select2-container select2-container-multi"
  1275. }).html([
  1276. " <ul class='select2-choices'>",
  1277. //"<li class='select2-search-choice'><span>California</span><a href="javascript:void(0)" class="select2-search-choice-close"></a></li>" ,
  1278. " <li class='select2-search-field'>" ,
  1279. " <input type='text' autocomplete='off' style='width: 25px;' class='select2-input'>" ,
  1280. " </li>" ,
  1281. "</ul>" ,
  1282. "<div class='select2-drop select2-drop-multi' style='display:none;'>" ,
  1283. " <ul class='select2-results'>" ,
  1284. " </ul>" ,
  1285. "</div>"].join(""));
  1286. return container;
  1287. },
  1288. // multi
  1289. prepareOpts: function () {
  1290. var opts = this.parent.prepareOpts.apply(this, arguments);
  1291. // TODO validate placeholder is a string if specified
  1292. if (opts.element.get(0).tagName.toLowerCase() === "select") {
  1293. // install sthe selection initializer
  1294. opts.initSelection = function (element,callback) {
  1295. var data = [];
  1296. element.find(":selected").each2(function (i, elm) {
  1297. data.push({id: elm.attr("value"), text: elm.text()});
  1298. });
  1299. if ($.isFunction(callback))
  1300. callback(data);
  1301. };
  1302. }
  1303. return opts;
  1304. },
  1305. // multi
  1306. initContainer: function () {
  1307. var selector = ".select2-choices", selection;
  1308. this.searchContainer = this.container.find(".select2-search-field");
  1309. this.selection = selection = this.container.find(selector);
  1310. this.search.bind("keydown", this.bind(function (e) {
  1311. if (!this.enabled) return;
  1312. if (e.which === KEY.BACKSPACE && this.search.val() === "") {
  1313. this.close();
  1314. var choices,
  1315. selected = selection.find(".select2-search-choice-focus");
  1316. if (selected.length > 0) {
  1317. this.unselect(selected.first());
  1318. this.search.width(10);
  1319. killEvent(e);
  1320. return;
  1321. }
  1322. choices = selection.find(".select2-search-choice");
  1323. if (choices.length > 0) {
  1324. choices.last().addClass("select2-search-choice-focus");
  1325. }
  1326. } else {
  1327. selection.find(".select2-search-choice-focus").removeClass("select2-search-choice-focus");
  1328. }
  1329. if (this.opened()) {
  1330. switch (e.which) {
  1331. case KEY.UP:
  1332. case KEY.DOWN:
  1333. this.moveHighlight((e.which === KEY.UP) ? -1 : 1);
  1334. killEvent(e);
  1335. return;
  1336. case KEY.ENTER:
  1337. case KEY.TAB:
  1338. this.selectHighlighted();
  1339. killEvent(e);
  1340. return;
  1341. case KEY.ESC:
  1342. this.cancel(e);
  1343. killEvent(e);
  1344. return;
  1345. }
  1346. }
  1347. if (e.which === KEY.TAB || KEY.isControl(e) || KEY.isFunctionKey(e) || e.which === KEY.BACKSPACE || e.which === KEY.ESC) {
  1348. return;
  1349. }
  1350. this.open();
  1351. if (e.which === KEY.PAGE_UP || e.which === KEY.PAGE_DOWN) {
  1352. // prevent the page from scrolling
  1353. killEvent(e);
  1354. }
  1355. }));
  1356. this.search.bind("keyup", this.bind(this.resizeSearch));
  1357. this.container.delegate(selector, "click", this.bind(function (e) {
  1358. if (!this.enabled) return;
  1359. this.clearPlaceholder();
  1360. this.open();
  1361. this.focusSearch();
  1362. e.preventDefault();
  1363. }));
  1364. this.container.delegate(selector, "focus", this.bind(function () {
  1365. if (!this.enabled) return;
  1366. this.container.addClass("select2-container-active");
  1367. this.dropdown.addClass("select2-drop-active");
  1368. this.clearPlaceholder();
  1369. }));
  1370. // set the placeholder if necessary
  1371. this.clearSearch();
  1372. },
  1373. // multi
  1374. enable: function() {
  1375. if (this.enabled) return;
  1376. this.parent.enable.apply(this, arguments);
  1377. this.search.show();
  1378. },
  1379. // multi
  1380. disable: function() {
  1381. if (!this.enabled) return;
  1382. this.parent.disable.apply(this, arguments);
  1383. this.search.hide();
  1384. },
  1385. // multi
  1386. initSelection: function () {
  1387. var data;
  1388. if (this.opts.element.val() === "") {
  1389. this.updateSelection([]);
  1390. this.close();
  1391. // set the placeholder if necessary
  1392. this.clearSearch();
  1393. }
  1394. if (this.select || this.opts.element.val() !== "") {
  1395. var self = this;
  1396. this.opts.initSelection.call(null, this.opts.element, function(data){
  1397. if (data !== undefined && data !== null) {
  1398. self.updateSelection(data);
  1399. self.close();
  1400. // set the placeholder if necessary
  1401. self.clearSearch();
  1402. }
  1403. });
  1404. }
  1405. },
  1406. // multi
  1407. clearSearch: function () {
  1408. var placeholder = this.getPlaceholder();
  1409. if (placeholder !== undefined && this.getVal().length === 0 && this.search.hasClass("select2-focused") === false) {
  1410. this.search.val(placeholder).addClass("select2-default");
  1411. // stretch the search box to full width of the container so as much of the placeholder is visible as possible
  1412. this.resizeSearch();
  1413. } else {
  1414. // we set this to " " instead of "" and later clear it on focus() because there is a firefox bug
  1415. // that does not properly render the caret when the field starts out blank
  1416. this.search.val(" ").width(10);
  1417. }
  1418. },
  1419. // multi
  1420. clearPlaceholder: function () {
  1421. if (this.search.hasClass("select2-default")) {
  1422. this.search.val("").removeClass("select2-default");
  1423. } else {
  1424. // work around for the space character we set to avoid firefox caret bug
  1425. if (this.search.val() === " ") this.search.val("");
  1426. }
  1427. },
  1428. // multi
  1429. opening: function () {
  1430. this.parent.opening.apply(this, arguments);
  1431. this.clearPlaceholder();
  1432. this.resizeSearch();
  1433. this.focusSearch();
  1434. },
  1435. // multi
  1436. close: function () {
  1437. if (!this.opened()) return;
  1438. this.parent.close.apply(this, arguments);
  1439. },
  1440. // multi
  1441. focus: function () {
  1442. this.close();
  1443. this.container.focus();
  1444. },
  1445. // multi
  1446. isFocused: function () {
  1447. return this.search.hasClass("select2-focused");
  1448. },
  1449. // multi
  1450. updateSelection: function (data) {
  1451. var ids = [], filtered = [], self = this;
  1452. // filter out duplicates
  1453. $(data).each(function () {
  1454. if (indexOf(self.id(this), ids) < 0) {
  1455. ids.push(self.id(this));
  1456. filtered.push(this);
  1457. }
  1458. });
  1459. data = filtered;
  1460. this.selection.find(".select2-search-choice").remove();
  1461. $(data).each(function () {
  1462. self.addSelectedChoice(this);
  1463. });
  1464. self.postprocessResults();
  1465. },
  1466. // multi
  1467. onSelect: function (data) {
  1468. this.addSelectedChoice(data);
  1469. if (this.select) { this.postprocessResults(); }
  1470. if (this.opts.closeOnSelect) {
  1471. this.close();
  1472. this.search.width(10);
  1473. } else {
  1474. this.search.width(10);
  1475. this.resizeSearch();
  1476. if (this.countSelectableResults()>0) {
  1477. this.positionDropdown();
  1478. } else {
  1479. // if nothing left to select close
  1480. this.close();
  1481. }
  1482. }
  1483. // since its not possible to select an element that has already been
  1484. // added we do not need to check if this is a new element before firing change
  1485. this.triggerChange({ added: data });
  1486. this.focusSearch();
  1487. },
  1488. // multi
  1489. cancel: function () {
  1490. this.close();
  1491. this.focusSearch();
  1492. },
  1493. // multi
  1494. addSelectedChoice: function (data) {
  1495. var choice=$(
  1496. "<li class='select2-search-choice'>" +
  1497. " <div></div>" +
  1498. " <a href='javascript:void(0)' class='select2-search-choice-close' tabindex='-1'></a>" +
  1499. "</li>"),
  1500. id = this.id(data),
  1501. val = this.getVal(),
  1502. formatted;
  1503. formatted=this.opts.formatSelection(data, choice);
  1504. choice.find("div").replaceWith("<div>"+formatted+"</div>");
  1505. choice.find(".select2-search-choice-close")
  1506. .bind("click dblclick", this.bind(function (e) {
  1507. if (!this.enabled) return;
  1508. $(e.target).closest(".select2-search-choice").fadeOut('fast').animate({width: "hide"}, 50, this.bind(function(){
  1509. this.unselect($(e.target));
  1510. this.selection.find(".select2-search-choice-focus").removeClass("select2-search-choice-focus");
  1511. this.close();
  1512. this.focusSearch();
  1513. })).dequeue();
  1514. killEvent(e);
  1515. })).bind("focus", this.bind(function () {
  1516. if (!this.enabled) return;
  1517. this.container.addClass("select2-container-active");
  1518. this.dropdown.addClass("select2-drop-active");
  1519. }));
  1520. choice.data("select2-data", data);
  1521. choice.insertBefore(this.searchContainer);
  1522. val.push(id);
  1523. this.setVal(val);
  1524. },
  1525. // multi
  1526. unselect: function (selected) {
  1527. var val = this.getVal(),
  1528. data,
  1529. index;
  1530. selected = selected.closest(".select2-search-choice");
  1531. if (selected.length === 0) {
  1532. throw "Invalid argument: " + selected + ". Must be .select2-search-choice";
  1533. }
  1534. data = selected.data("select2-data");
  1535. index = indexOf(this.id(data), val);
  1536. if (index >= 0) {
  1537. val.splice(index, 1);
  1538. this.setVal(val);
  1539. if (this.select) this.postprocessResults();
  1540. }
  1541. selected.remove();
  1542. this.triggerChange({ removed: data });
  1543. },
  1544. // multi
  1545. postprocessResults: function () {
  1546. var val = this.getVal(),
  1547. choices = this.results.find(".select2-result-selectable"),
  1548. self = this;
  1549. choices.each2(function (i, choice) {
  1550. var id = self.id(choice.data("select2-data"));
  1551. if (indexOf(id, val) >= 0) {
  1552. choice.addClass("select2-disabled");
  1553. } else {
  1554. choice.removeClass("select2-disabled");
  1555. }
  1556. });
  1557. choices.each2(function (i, choice) {
  1558. if (!choice.hasClass("select2-disabled")) {
  1559. self.highlight(i);
  1560. return false;
  1561. }
  1562. });
  1563. },
  1564. // multi
  1565. resizeSearch: function () {
  1566. var minimumWidth, left, maxWidth, containerLeft, searchWidth,
  1567. sideBorderPadding = getSideBorderPadding(this.search);
  1568. minimumWidth = measureTextWidth(this.search) + 10;
  1569. left = this.search.offset().left;
  1570. maxWidth = this.selection.width();
  1571. containerLeft = this.selection.offset().left;
  1572. searchWidth = maxWidth - (left - containerLeft) - sideBorderPadding;
  1573. if (searchWidth < minimumWidth) {
  1574. searchWidth = maxWidth - sideBorderPadding;
  1575. }
  1576. if (searchWidth < 40) {
  1577. searchWidth = maxWidth - sideBorderPadding;
  1578. }
  1579. this.search.width(searchWidth);
  1580. },
  1581. // multi
  1582. getVal: function () {
  1583. var val;
  1584. if (this.select) {
  1585. val = this.select.val();
  1586. return val === null ? [] : val;
  1587. } else {
  1588. val = this.opts.element.val();
  1589. return splitVal(val, this.opts.separator);
  1590. }
  1591. },
  1592. // multi
  1593. setVal: function (val) {
  1594. var unique;
  1595. if (this.select) {
  1596. this.select.val(val);
  1597. } else {
  1598. unique = [];
  1599. // filter out duplicates
  1600. $(val).each(function () {
  1601. if (indexOf(this, unique) < 0) unique.push(this);
  1602. });
  1603. this.opts.element.val(unique.length === 0 ? "" : unique.join(","));
  1604. }
  1605. },
  1606. // multi
  1607. val: function () {
  1608. var val, data = [], self=this;
  1609. if (arguments.length === 0) {
  1610. return this.getVal();
  1611. }
  1612. val = arguments[0];
  1613. if (!val) {
  1614. this.opts.element.val("");
  1615. this.updateSelection([]);
  1616. this.clearSearch();
  1617. return;
  1618. }
  1619. // val is a list of ids
  1620. this.setVal(val);
  1621. if (this.select) {
  1622. this.select.find(":selected").each(function () {
  1623. data.push({id: $(this).attr("value"), text: $(this).text()});
  1624. });
  1625. this.updateSelection(data);
  1626. } else {
  1627. if (this.opts.initSelection === undefined) {
  1628. throw new Error("val() cannot be called if initSelection() is not defined")
  1629. }
  1630. this.opts.initSelection(this.opts.element, function(data){
  1631. var ids=$(data).map(self.id);
  1632. self.setVal(ids);
  1633. self.updateSelection(data);
  1634. self.clearSearch();
  1635. });
  1636. }
  1637. this.clearSearch();
  1638. },
  1639. // multi
  1640. onSortStart: function() {
  1641. if (this.select) {
  1642. throw new Error("Sorting of elements is not supported when attached to <select>. Attach to <input type='hidden'/> instead.");
  1643. }
  1644. // collapse search field into 0 width so its container can be collapsed as well
  1645. this.search.width(0);
  1646. // hide the container
  1647. this.searchContainer.hide();
  1648. },
  1649. // multi
  1650. onSortEnd:function() {
  1651. var val=[], self=this;
  1652. // show search and move it to the end of the list
  1653. this.searchContainer.show();
  1654. // make sure the search container is the last item in the list
  1655. this.searchContainer.appendTo(this.searchContainer.parent());
  1656. // since we collapsed the width in dragStarted, we resize it here
  1657. this.resizeSearch();
  1658. // update selection
  1659. this.selection.find(".select2-search-choice").each(function() {
  1660. val.push(self.opts.id($(this).data("select2-data")));
  1661. });
  1662. this.setVal(val);
  1663. this.triggerChange();
  1664. },
  1665. // multi
  1666. data: function(values) {
  1667. var self=this, ids;
  1668. if (arguments.length === 0) {
  1669. return this.selection
  1670. .find(".select2-search-choice")
  1671. .map(function() { return $(this).data("select2-data"); })
  1672. .get();
  1673. } else {
  1674. ids = $.map(values, function(e) { return self.opts.id(e)});
  1675. this.setVal(ids);
  1676. this.updateSelection(values);
  1677. this.clearSearch();
  1678. }
  1679. }
  1680. });
  1681. $.fn.select2 = function () {
  1682. var args = Array.prototype.slice.call(arguments, 0),
  1683. opts,
  1684. select2,
  1685. value, multiple, allowedMethods = ["val", "destroy", "open", "close", "focus", "isFocused", "container", "onSortStart", "onSortEnd", "enable", "disable", "positionDropdown", "data"];
  1686. this.each(function () {
  1687. if (args.length === 0 || typeof(args[0]) === "object") {
  1688. opts = args.length === 0 ? {} : $.extend({}, args[0]);
  1689. opts.element = $(this);
  1690. if (opts.element.get(0).tagName.toLowerCase() === "select") {
  1691. multiple = opts.element.attr("multiple");
  1692. } else {
  1693. multiple = opts.multiple || false;
  1694. if ("tags" in opts) {opts.multiple = multiple = true;}
  1695. }
  1696. select2 = multiple ? new MultiSelect2() : new SingleSelect2();
  1697. select2.init(opts);
  1698. } else if (typeof(args[0]) === "string") {
  1699. if (indexOf(args[0], allowedMethods) < 0) {
  1700. throw "Unknown method: " + args[0];
  1701. }
  1702. value = undefined;
  1703. select2 = $(this).data("select2");
  1704. if (select2 === undefined) return;
  1705. if (args[0] === "container") {
  1706. value=select2.container;
  1707. } else {
  1708. value = select2[args[0]].apply(select2, args.slice(1));
  1709. }
  1710. if (value !== undefined) {return false;}
  1711. } else {
  1712. throw "Invalid arguments to select2 plugin: " + args;
  1713. }
  1714. });
  1715. return (value === undefined) ? this : value;
  1716. };
  1717. // plugin defaults, accessible to users
  1718. $.fn.select2.defaults = {
  1719. width: "copy",
  1720. closeOnSelect: true,
  1721. containerCss: {},
  1722. dropdownCss: {},
  1723. containerCssClass: "",
  1724. dropdownCssClass: "",
  1725. formatResult: function(result, container, query) {
  1726. var markup=[];
  1727. markMatch(result.text, query.term, markup);
  1728. return markup.join("");
  1729. },
  1730. formatSelection: function (data, container) {
  1731. return data.text;
  1732. },
  1733. formatNoMatches: function () { return "No matches found"; },
  1734. formatInputTooShort: function (input, min) { return "Please enter " + (min - input.length) + " more characters"; },
  1735. formatLoadMore: function (pageNumber) { return "Loading more results..."; },
  1736. minimumResultsForSearch: 0,
  1737. minimumInputLength: 0,
  1738. id: function (e) { return e.id; },
  1739. matcher: function(term, text) {
  1740. return text.toUpperCase().indexOf(term.toUpperCase()) >= 0;
  1741. }
  1742. };
  1743. // exports
  1744. window.Select2 = {
  1745. query: {
  1746. ajax: ajax,
  1747. local: local,
  1748. tags: tags
  1749. }, util: {
  1750. debounce: debounce,
  1751. markMatch: markMatch
  1752. }, "class": {
  1753. "abstract": AbstractSelect2,
  1754. "single": SingleSelect2,
  1755. "multi": MultiSelect2
  1756. }
  1757. };
  1758. }(jQuery));