select2.js 94 KB

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