| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332 |
- /**
- * sifter.js
- * Copyright (c) 2013 Brian Reavis & contributors
- *
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
- * file except in compliance with the License. You may obtain a copy of the License at:
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software distributed under
- * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
- * ANY KIND, either express or implied. See the License for the specific language
- * governing permissions and limitations under the License.
- *
- * @author Brian Reavis <brian@thirdroute.com>
- */
- (function(root, factory) {
- if (typeof define === 'function' && define.amd) {
- define('sifter', factory);
- } else if (typeof exports === 'object') {
- module.exports = factory();
- } else {
- root.Sifter = factory();
- }
- }(this, function() {
- /**
- * Textually searches arrays and hashes of objects
- * by property (or multiple properties). Designed
- * specifically for autocomplete.
- *
- * @constructor
- * @param {array|object} items
- * @param {object} items
- */
- var Sifter = function(items, settings) {
- this.items = items;
- this.settings = settings || {diacritics: true};
- };
- /**
- * Splits a search string into an array of individual
- * regexps to be used to match results.
- *
- * @param {string} query
- * @returns {array}
- */
- Sifter.prototype.tokenize = function(query) {
- query = trim(String(query || '').toLowerCase());
- if (!query || !query.length) return [];
- var i, n, regex, letter;
- var tokens = [];
- var words = query.split(/ +/);
- for (i = 0, n = words.length; i < n; i++) {
- regex = escape_regex(words[i]);
- if (this.settings.diacritics) {
- for (letter in DIACRITICS) {
- if (DIACRITICS.hasOwnProperty(letter)) {
- regex = regex.replace(new RegExp(letter, 'g'), DIACRITICS[letter]);
- }
- }
- }
- tokens.push({
- string : words[i],
- regex : new RegExp(regex, 'i')
- });
- }
- return tokens;
- };
- /**
- * Iterates over arrays and hashes.
- *
- * ```
- * this.iterator(this.items, function(item, id) {
- * // invoked for each item
- * });
- * ```
- *
- * @param {array|object} object
- */
- Sifter.prototype.iterator = function(object, callback) {
- var iterator;
- if (is_array(object)) {
- iterator = Array.prototype.forEach || function(callback) {
- for (var i = 0, n = this.length; i < n; i++) {
- callback(this[i], i, this);
- }
- };
- } else {
- iterator = function(callback) {
- for (var key in this) {
- if (this.hasOwnProperty(key)) {
- callback(this[key], key, this);
- }
- }
- };
- }
- iterator.apply(object, [callback]);
- };
- /**
- * Returns a function to be used to score individual results.
- *
- * Good matches will have a higher score than poor matches.
- * If an item is not a match, 0 will be returned by the function.
- *
- * @param {object|string} search
- * @param {object} options (optional)
- * @returns {function}
- */
- Sifter.prototype.getScoreFunction = function(search, options) {
- var self, fields, tokens, token_count;
- self = this;
- search = self.prepareSearch(search, options);
- tokens = search.tokens;
- fields = search.options.fields;
- token_count = tokens.length;
- /**
- * Calculates how close of a match the
- * given value is against a search token.
- *
- * @param {mixed} value
- * @param {object} token
- * @return {number}
- */
- var scoreValue = function(value, token) {
- var score, pos;
- if (!value) return 0;
- value = String(value || '');
- pos = value.search(token.regex);
- if (pos === -1) return 0;
- score = token.string.length / value.length;
- if (pos === 0) score += 0.5;
- return score;
- };
- /**
- * Calculates the score of an object
- * against the search query.
- *
- * @param {object} token
- * @param {object} data
- * @return {number}
- */
- var scoreObject = (function() {
- var field_count = fields.length;
- if (!field_count) {
- return function() { return 0; };
- }
- if (field_count === 1) {
- return function(token, data) {
- return scoreValue(data[fields[0]], token);
- };
- }
- return function(token, data) {
- for (var i = 0, sum = 0; i < field_count; i++) {
- sum += scoreValue(data[fields[i]], token);
- }
- return sum / field_count;
- };
- })();
- if (!token_count) {
- return function() { return 0; };
- }
- if (token_count === 1) {
- return function(data) {
- return scoreObject(tokens[0], data);
- };
- }
- if (search.options.conjunction === 'and') {
- return function(data) {
- var score;
- for (var i = 0, sum = 0; i < token_count; i++) {
- score = scoreObject(tokens[i], data);
- if (score <= 0) return 0;
- sum += score;
- }
- return sum / token_count;
- };
- } else {
- return function(data) {
- for (var i = 0, sum = 0; i < token_count; i++) {
- sum += scoreObject(tokens[i], data);
- }
- return sum / token_count;
- };
- }
- };
- /**
- * Returns a function that can be used to compare two
- * results, for sorting purposes. If no sorting should
- * be performed, `null` will be returned.
- *
- * @param {string|object} search
- * @param {object} options
- * @return function(a,b)
- */
- Sifter.prototype.getSortFunction = function(search, options) {
- var i, n, self, field, fields, fields_count, multiplier, multipliers, get_field, implicit_score, sort;
- self = this;
- search = self.prepareSearch(search, options);
- sort = (!search.query && options.sort_empty) || options.sort;
- /**
- * Fetches the specified sort field value
- * from a search result item.
- *
- * @param {string} name
- * @param {object} result
- * @return {mixed}
- */
- get_field = function(name, result) {
- if (name === '$score') return result.score;
- return self.items[result.id][name];
- };
- // parse options
- fields = [];
- if (sort) {
- for (i = 0, n = sort.length; i < n; i++) {
- if (search.query || sort[i].field !== '$score') {
- fields.push(sort[i]);
- }
- }
- }
- // the "$score" field is implied to be the primary
- // sort field, unless it's manually specified
- if (search.query) {
- implicit_score = true;
- for (i = 0, n = fields.length; i < n; i++) {
- if (fields[i].field === '$score') {
- implicit_score = false;
- break;
- }
- }
- if (implicit_score) {
- fields.unshift({field: '$score', direction: 'desc'});
- }
- } else {
- for (i = 0, n = fields.length; i < n; i++) {
- if (fields[i].field === '$score') {
- fields.splice(i, 1);
- break;
- }
- }
- }
- multipliers = [];
- for (i = 0, n = fields.length; i < n; i++) {
- multipliers.push(fields[i].direction === 'desc' ? -1 : 1);
- }
- // build function
- fields_count = fields.length;
- if (!fields_count) {
- return null;
- } else if (fields_count === 1) {
- field = fields[0].field;
- multiplier = multipliers[0];
- return function(a, b) {
- return multiplier * cmp(
- get_field(field, a),
- get_field(field, b)
- );
- };
- } else {
- return function(a, b) {
- var i, result, a_value, b_value, field;
- for (i = 0; i < fields_count; i++) {
- field = fields[i].field;
- result = multipliers[i] * cmp(
- get_field(field, a),
- get_field(field, b)
- );
- if (result) return result;
- }
- return 0;
- };
- }
- };
- /**
- * Parses a search query and returns an object
- * with tokens and fields ready to be populated
- * with results.
- *
- * @param {string} query
- * @param {object} options
- * @returns {object}
- */
- Sifter.prototype.prepareSearch = function(query, options) {
- if (typeof query === 'object') return query;
- options = extend({}, options);
- var option_fields = options.fields;
- var option_sort = options.sort;
- var option_sort_empty = options.sort_empty;
- if (option_fields && !is_array(option_fields)) options.fields = [option_fields];
- if (option_sort && !is_array(option_sort)) options.sort = [option_sort];
- if (option_sort_empty && !is_array(option_sort_empty)) options.sort_empty = [option_sort_empty];
- return {
- options : options,
- query : String(query || '').toLowerCase(),
- tokens : this.tokenize(query),
- total : 0,
- items : []
- };
- };
- /**
- * Searches through all items and returns a sorted array of matches.
- *
- * The `options` parameter can contain:
- *
- * - fields {string|array}
- * - sort {array}
- * - score {function}
- * - filter {bool}
- * - limit {integer}
- *
- * Returns an object containing:
- *
- * - options {object}
- * - query {string}
- * - tokens {array}
- * - total {int}
- * - items {array}
- *
- * @param {string} query
- * @param {object} options
- * @returns {object}
- */
- Sifter.prototype.search = function(query, options) {
- var self = this, value, score, search, calculateScore;
- var fn_sort;
- var fn_score;
- search = this.prepareSearch(query, options);
- options = search.options;
- query = search.query;
- // generate result scoring function
- fn_score = options.score || self.getScoreFunction(search);
- // perform search and sort
- if (query.length) {
- self.iterator(self.items, function(item, id) {
- score = fn_score(item);
- if (options.filter === false || score > 0) {
- search.items.push({'score': score, 'id': id});
- }
- });
- } else {
- self.iterator(self.items, function(item, id) {
- search.items.push({'score': 1, 'id': id});
- });
- }
- fn_sort = self.getSortFunction(search, options);
- if (fn_sort) search.items.sort(fn_sort);
- // apply limits
- search.total = search.items.length;
- if (typeof options.limit === 'number') {
- search.items = search.items.slice(0, options.limit);
- }
- return search;
- };
- // utilities
- // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- var cmp = function(a, b) {
- if (typeof a === 'number' && typeof b === 'number') {
- return a > b ? 1 : (a < b ? -1 : 0);
- }
- a = String(a || '').toLowerCase();
- b = String(b || '').toLowerCase();
- if (a > b) return 1;
- if (b > a) return -1;
- return 0;
- };
- var extend = function(a, b) {
- var i, n, k, object;
- for (i = 1, n = arguments.length; i < n; i++) {
- object = arguments[i];
- if (!object) continue;
- for (k in object) {
- if (object.hasOwnProperty(k)) {
- a[k] = object[k];
- }
- }
- }
- return a;
- };
- var trim = function(str) {
- return (str + '').replace(/^\s+|\s+$|/g, '');
- };
- var escape_regex = function(str) {
- return (str + '').replace(/([.?*+^$[\]\\(){}|-])/g, '\\$1');
- };
- var is_array = Array.isArray || ($ && $.isArray) || function(object) {
- return Object.prototype.toString.call(object) === '[object Array]';
- };
- var DIACRITICS = {
- 'a': '[aÀÁÂÃÄÅàáâãäå]',
- 'c': '[cÇçćĆčČ]',
- 'd': '[dđĐ]',
- 'e': '[eÈÉÊËèéêë]',
- 'i': '[iÌÍÎÏìíîï]',
- 'n': '[nÑñ]',
- 'o': '[oÒÓÔÕÕÖØòóôõöø]',
- 's': '[sŠš]',
- 'u': '[uÙÚÛÜùúûü]',
- 'y': '[yŸÿý]',
- 'z': '[zŽž]'
- };
- // export
- // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- return Sifter;
- }));
- /**
- * microplugin.js
- * Copyright (c) 2013 Brian Reavis & contributors
- *
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
- * file except in compliance with the License. You may obtain a copy of the License at:
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software distributed under
- * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
- * ANY KIND, either express or implied. See the License for the specific language
- * governing permissions and limitations under the License.
- *
- * @author Brian Reavis <brian@thirdroute.com>
- */
- (function(root, factory) {
- if (typeof define === 'function' && define.amd) {
- define('microplugin', factory);
- } else if (typeof exports === 'object') {
- module.exports = factory();
- } else {
- root.MicroPlugin = factory();
- }
- }(this, function() {
- var MicroPlugin = {};
- MicroPlugin.mixin = function(Interface) {
- Interface.plugins = {};
- /**
- * Initializes the listed plugins (with options).
- * Acceptable formats:
- *
- * List (without options):
- * ['a', 'b', 'c']
- *
- * List (with options):
- * [{'name': 'a', options: {}}, {'name': 'b', options: {}}]
- *
- * Hash (with options):
- * {'a': { ... }, 'b': { ... }, 'c': { ... }}
- *
- * @param {mixed} plugins
- */
- Interface.prototype.initializePlugins = function(plugins) {
- var i, n, key;
- var self = this;
- var queue = [];
- self.plugins = {
- names : [],
- settings : {},
- requested : {},
- loaded : {}
- };
- if (utils.isArray(plugins)) {
- for (i = 0, n = plugins.length; i < n; i++) {
- if (typeof plugins[i] === 'string') {
- queue.push(plugins[i]);
- } else {
- self.plugins.settings[plugins[i].name] = plugins[i].options;
- queue.push(plugins[i].name);
- }
- }
- } else if (plugins) {
- for (key in plugins) {
- if (plugins.hasOwnProperty(key)) {
- self.plugins.settings[key] = plugins[key];
- queue.push(key);
- }
- }
- }
- while (queue.length) {
- self.require(queue.shift());
- }
- };
- Interface.prototype.loadPlugin = function(name) {
- var self = this;
- var plugins = self.plugins;
- var plugin = Interface.plugins[name];
- if (!Interface.plugins.hasOwnProperty(name)) {
- throw new Error('Unable to find "' + name + '" plugin');
- }
- plugins.requested[name] = true;
- plugins.loaded[name] = plugin.fn.apply(self, [self.plugins.settings[name] || {}]);
- plugins.names.push(name);
- };
- /**
- * Initializes a plugin.
- *
- * @param {string} name
- */
- Interface.prototype.require = function(name) {
- var self = this;
- var plugins = self.plugins;
- if (!self.plugins.loaded.hasOwnProperty(name)) {
- if (plugins.requested[name]) {
- throw new Error('Plugin has circular dependency ("' + name + '")');
- }
- self.loadPlugin(name);
- }
- return plugins.loaded[name];
- };
- /**
- * Registers a plugin.
- *
- * @param {string} name
- * @param {function} fn
- */
- Interface.define = function(name, fn) {
- Interface.plugins[name] = {
- 'name' : name,
- 'fn' : fn
- };
- };
- };
- var utils = {
- isArray: Array.isArray || function(vArg) {
- return Object.prototype.toString.call(vArg) === '[object Array]';
- }
- };
- return MicroPlugin;
- }));
- /**
- * selectize.js (v0.8.5)
- * Copyright (c) 2013 Brian Reavis & contributors
- *
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
- * file except in compliance with the License. You may obtain a copy of the License at:
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software distributed under
- * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
- * ANY KIND, either express or implied. See the License for the specific language
- * governing permissions and limitations under the License.
- *
- * @author Brian Reavis <brian@thirdroute.com>
- */
- /*jshint curly:false */
- /*jshint browser:true */
- (function(root, factory) {
- if (typeof define === 'function' && define.amd) {
- define('selectize', ['jquery','sifter','microplugin'], factory);
- } else {
- root.Selectize = factory(root.jQuery, root.Sifter, root.MicroPlugin);
- }
- }(this, function($, Sifter, MicroPlugin) {
- 'use strict';
- var highlight = function($element, pattern) {
- if (typeof pattern === 'string' && !pattern.length) return;
- var regex = (typeof pattern === 'string') ? new RegExp(pattern, 'i') : pattern;
-
- var highlight = function(node) {
- var skip = 0;
- if (node.nodeType === 3) {
- var pos = node.data.search(regex);
- if (pos >= 0 && node.data.length > 0) {
- var match = node.data.match(regex);
- var spannode = document.createElement('span');
- spannode.className = 'highlight';
- var middlebit = node.splitText(pos);
- var endbit = middlebit.splitText(match[0].length);
- var middleclone = middlebit.cloneNode(true);
- spannode.appendChild(middleclone);
- middlebit.parentNode.replaceChild(spannode, middlebit);
- skip = 1;
- }
- } else if (node.nodeType === 1 && node.childNodes && !/(script|style)/i.test(node.tagName)) {
- for (var i = 0; i < node.childNodes.length; ++i) {
- i += highlight(node.childNodes[i]);
- }
- }
- return skip;
- };
-
- return $element.each(function() {
- highlight(this);
- });
- };
-
- var MicroEvent = function() {};
- MicroEvent.prototype = {
- on: function(event, fct){
- this._events = this._events || {};
- this._events[event] = this._events[event] || [];
- this._events[event].push(fct);
- },
- off: function(event, fct){
- var n = arguments.length;
- if (n === 0) return delete this._events;
- if (n === 1) return delete this._events[event];
-
- this._events = this._events || {};
- if (event in this._events === false) return;
- this._events[event].splice(this._events[event].indexOf(fct), 1);
- },
- trigger: function(event /* , args... */){
- this._events = this._events || {};
- if (event in this._events === false) return;
- for (var i = 0; i < this._events[event].length; i++){
- this._events[event][i].apply(this, Array.prototype.slice.call(arguments, 1));
- }
- }
- };
-
- /**
- * Mixin will delegate all MicroEvent.js function in the destination object.
- *
- * - MicroEvent.mixin(Foobar) will make Foobar able to use MicroEvent
- *
- * @param {object} the object which will support MicroEvent
- */
- MicroEvent.mixin = function(destObject){
- var props = ['on', 'off', 'trigger'];
- for (var i = 0; i < props.length; i++){
- destObject.prototype[props[i]] = MicroEvent.prototype[props[i]];
- }
- };
-
- var IS_MAC = /Mac/.test(navigator.userAgent);
-
- var KEY_A = 65;
- var KEY_COMMA = 188;
- var KEY_RETURN = 13;
- var KEY_ESC = 27;
- var KEY_LEFT = 37;
- var KEY_UP = 38;
- var KEY_RIGHT = 39;
- var KEY_DOWN = 40;
- var KEY_BACKSPACE = 8;
- var KEY_DELETE = 46;
- var KEY_SHIFT = 16;
- var KEY_CMD = IS_MAC ? 91 : 17;
- var KEY_CTRL = IS_MAC ? 18 : 17;
- var KEY_TAB = 9;
-
- var TAG_SELECT = 1;
- var TAG_INPUT = 2;
-
- var isset = function(object) {
- return typeof object !== 'undefined';
- };
-
- /**
- * Converts a scalar to its best string representation
- * for hash keys and HTML attribute values.
- *
- * Transformations:
- * 'str' -> 'str'
- * null -> ''
- * undefined -> ''
- * true -> '1'
- * false -> '0'
- * 0 -> '0'
- * 1 -> '1'
- *
- * @param {string} value
- * @returns {string}
- */
- var hash_key = function(value) {
- if (typeof value === 'undefined' || value === null) return '';
- if (typeof value === 'boolean') return value ? '1' : '0';
- return value + '';
- };
-
- /**
- * Escapes a string for use within HTML.
- *
- * @param {string} str
- * @returns {string}
- */
- var escape_html = function(str) {
- return (str + '')
- .replace(/&/g, '&')
- .replace(/</g, '<')
- .replace(/>/g, '>')
- .replace(/"/g, '"');
- };
-
- /**
- * Escapes "$" characters in replacement strings.
- *
- * @param {string} str
- * @returns {string}
- */
- var escape_replace = function(str) {
- return (str + '').replace(/\$/g, '$$$$');
- };
-
- var hook = {};
-
- /**
- * Wraps `method` on `self` so that `fn`
- * is invoked before the original method.
- *
- * @param {object} self
- * @param {string} method
- * @param {function} fn
- */
- hook.before = function(self, method, fn) {
- var original = self[method];
- self[method] = function() {
- fn.apply(self, arguments);
- return original.apply(self, arguments);
- };
- };
-
- /**
- * Wraps `method` on `self` so that `fn`
- * is invoked after the original method.
- *
- * @param {object} self
- * @param {string} method
- * @param {function} fn
- */
- hook.after = function(self, method, fn) {
- var original = self[method];
- self[method] = function() {
- var result = original.apply(self, arguments);
- fn.apply(self, arguments);
- return result;
- };
- };
-
- /**
- * Builds a hash table out of an array of
- * objects, using the specified `key` within
- * each object.
- *
- * @param {string} key
- * @param {mixed} objects
- */
- var build_hash_table = function(key, objects) {
- if (!$.isArray(objects)) return objects;
- var i, n, table = {};
- for (i = 0, n = objects.length; i < n; i++) {
- if (objects[i].hasOwnProperty(key)) {
- table[objects[i][key]] = objects[i];
- }
- }
- return table;
- };
-
- /**
- * Wraps `fn` so that it can only be invoked once.
- *
- * @param {function} fn
- * @returns {function}
- */
- var once = function(fn) {
- var called = false;
- return function() {
- if (called) return;
- called = true;
- fn.apply(this, arguments);
- };
- };
-
- /**
- * Wraps `fn` so that it can only be called once
- * every `delay` milliseconds (invoked on the falling edge).
- *
- * @param {function} fn
- * @param {int} delay
- * @returns {function}
- */
- var debounce = function(fn, delay) {
- var timeout;
- return function() {
- var self = this;
- var args = arguments;
- window.clearTimeout(timeout);
- timeout = window.setTimeout(function() {
- fn.apply(self, args);
- }, delay);
- };
- };
-
- /**
- * Debounce all fired events types listed in `types`
- * while executing the provided `fn`.
- *
- * @param {object} self
- * @param {array} types
- * @param {function} fn
- */
- var debounce_events = function(self, types, fn) {
- var type;
- var trigger = self.trigger;
- var event_args = {};
-
- // override trigger method
- self.trigger = function() {
- var type = arguments[0];
- if (types.indexOf(type) !== -1) {
- event_args[type] = arguments;
- } else {
- return trigger.apply(self, arguments);
- }
- };
-
- // invoke provided function
- fn.apply(self, []);
- self.trigger = trigger;
-
- // trigger queued events
- for (type in event_args) {
- if (event_args.hasOwnProperty(type)) {
- trigger.apply(self, event_args[type]);
- }
- }
- };
-
- /**
- * A workaround for http://bugs.jquery.com/ticket/6696
- *
- * @param {object} $parent - Parent element to listen on.
- * @param {string} event - Event name.
- * @param {string} selector - Descendant selector to filter by.
- * @param {function} fn - Event handler.
- */
- var watchChildEvent = function($parent, event, selector, fn) {
- $parent.on(event, selector, function(e) {
- var child = e.target;
- while (child && child.parentNode !== $parent[0]) {
- child = child.parentNode;
- }
- e.currentTarget = child;
- return fn.apply(this, [e]);
- });
- };
-
- /**
- * Determines the current selection within a text input control.
- * Returns an object containing:
- * - start
- * - length
- *
- * @param {object} input
- * @returns {object}
- */
- var getSelection = function(input) {
- var result = {};
- if ('selectionStart' in input) {
- result.start = input.selectionStart;
- result.length = input.selectionEnd - result.start;
- } else if (document.selection) {
- input.focus();
- var sel = document.selection.createRange();
- var selLen = document.selection.createRange().text.length;
- sel.moveStart('character', -input.value.length);
- result.start = sel.text.length - selLen;
- result.length = selLen;
- }
- return result;
- };
-
- /**
- * Copies CSS properties from one element to another.
- *
- * @param {object} $from
- * @param {object} $to
- * @param {array} properties
- */
- var transferStyles = function($from, $to, properties) {
- var i, n, styles = {};
- if (properties) {
- for (i = 0, n = properties.length; i < n; i++) {
- styles[properties[i]] = $from.css(properties[i]);
- }
- } else {
- styles = $from.css();
- }
- $to.css(styles);
- };
-
- /**
- * Measures the width of a string within a
- * parent element (in pixels).
- *
- * @param {string} str
- * @param {object} $parent
- * @returns {int}
- */
- var measureString = function(str, $parent) {
- var $test = $('<test>').css({
- position: 'absolute',
- top: -99999,
- left: -99999,
- width: 'auto',
- padding: 0,
- whiteSpace: 'pre'
- }).text(str).appendTo('body');
-
- transferStyles($parent, $test, [
- 'letterSpacing',
- 'fontSize',
- 'fontFamily',
- 'fontWeight',
- 'textTransform'
- ]);
-
- var width = $test.width();
- $test.remove();
-
- return width;
- };
-
- /**
- * Sets up an input to grow horizontally as the user
- * types. If the value is changed manually, you can
- * trigger the "update" handler to resize:
- *
- * $input.trigger('update');
- *
- * @param {object} $input
- */
- var autoGrow = function($input) {
- var update = function(e) {
- var value, keyCode, printable, placeholder, width;
- var shift, character, selection;
- e = e || window.event || {};
-
- if (e.metaKey || e.altKey) return;
- if ($input.data('grow') === false) return;
-
- value = $input.val();
- if (e.type && e.type.toLowerCase() === 'keydown') {
- keyCode = e.keyCode;
- printable = (
- (keyCode >= 97 && keyCode <= 122) || // a-z
- (keyCode >= 65 && keyCode <= 90) || // A-Z
- (keyCode >= 48 && keyCode <= 57) || // 0-9
- keyCode === 32 // space
- );
-
- if (keyCode === KEY_DELETE || keyCode === KEY_BACKSPACE) {
- selection = getSelection($input[0]);
- if (selection.length) {
- value = value.substring(0, selection.start) + value.substring(selection.start + selection.length);
- } else if (keyCode === KEY_BACKSPACE && selection.start) {
- value = value.substring(0, selection.start - 1) + value.substring(selection.start + 1);
- } else if (keyCode === KEY_DELETE && typeof selection.start !== 'undefined') {
- value = value.substring(0, selection.start) + value.substring(selection.start + 1);
- }
- } else if (printable) {
- shift = e.shiftKey;
- character = String.fromCharCode(e.keyCode);
- if (shift) character = character.toUpperCase();
- else character = character.toLowerCase();
- value += character;
- }
- }
-
- placeholder = $input.attr('placeholder') || '';
- if (!value.length && placeholder.length) {
- value = placeholder;
- }
-
- width = measureString(value, $input) + 4;
- if (width !== $input.width()) {
- $input.width(width);
- $input.triggerHandler('resize');
- }
- };
-
- $input.on('keydown keyup update blur', update);
- update();
- };
-
- var Selectize = function($input, settings) {
- var key, i, n, dir, input, self = this;
- input = $input[0];
- input.selectize = self;
-
- // detect rtl environment
- dir = window.getComputedStyle ? window.getComputedStyle(input, null).getPropertyValue('direction') : input.currentStyle && input.currentStyle.direction;
- dir = dir || $input.parents('[dir]:first').attr('dir') || '';
-
- // setup default state
- $.extend(self, {
- settings : settings,
- $input : $input,
- tagType : input.tagName.toLowerCase() === 'select' ? TAG_SELECT : TAG_INPUT,
- rtl : /rtl/i.test(dir),
-
- eventNS : '.selectize' + (++Selectize.count),
- highlightedValue : null,
- isOpen : false,
- isDisabled : false,
- isRequired : $input.is('[required]'),
- isInvalid : false,
- isLocked : false,
- isFocused : false,
- isInputHidden : false,
- isSetup : false,
- isShiftDown : false,
- isCmdDown : false,
- isCtrlDown : false,
- ignoreFocus : false,
- ignoreHover : false,
- hasOptions : false,
- currentResults : null,
- lastValue : '',
- caretPos : 0,
- loading : 0,
- loadedSearches : {},
-
- $activeOption : null,
- $activeItems : [],
-
- optgroups : {},
- options : {},
- userOptions : {},
- items : [],
- renderCache : {},
- onSearchChange : debounce(self.onSearchChange, settings.loadThrottle)
- });
-
- // search system
- self.sifter = new Sifter(this.options, {diacritics: settings.diacritics});
-
- // build options table
- $.extend(self.options, build_hash_table(settings.valueField, settings.options));
- delete self.settings.options;
-
- // build optgroup table
- $.extend(self.optgroups, build_hash_table(settings.optgroupValueField, settings.optgroups));
- delete self.settings.optgroups;
-
- // option-dependent defaults
- self.settings.mode = self.settings.mode || (self.settings.maxItems === 1 ? 'single' : 'multi');
- if (typeof self.settings.hideSelected !== 'boolean') {
- self.settings.hideSelected = self.settings.mode === 'multi';
- }
-
- self.initializePlugins(self.settings.plugins);
- self.setupCallbacks();
- self.setupTemplates();
- self.setup();
- };
-
- // mixins
- // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- MicroEvent.mixin(Selectize);
- MicroPlugin.mixin(Selectize);
-
- // methods
- // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- $.extend(Selectize.prototype, {
-
- /**
- * Creates all elements and sets up event bindings.
- */
- setup: function() {
- var self = this;
- var settings = self.settings;
- var eventNS = self.eventNS;
- var $window = $(window);
- var $document = $(document);
-
- var $wrapper;
- var $control;
- var $control_input;
- var $dropdown;
- var $dropdown_content;
- var $dropdown_parent;
- var inputMode;
- var timeout_blur;
- var timeout_focus;
- var tab_index;
- var classes;
- var classes_plugins;
-
- inputMode = self.settings.mode;
- tab_index = self.$input.attr('tabindex') || '';
- classes = self.$input.attr('class') || '';
-
- $wrapper = $('<div>').addClass(settings.wrapperClass).addClass(classes).addClass(inputMode);
- $control = $('<div>').addClass(settings.inputClass).addClass('items').appendTo($wrapper);
- $control_input = $('<input type="text" autocomplete="off">').appendTo($control).attr('tabindex', tab_index);
- $dropdown_parent = $(settings.dropdownParent || $wrapper);
- $dropdown = $('<div>').addClass(settings.dropdownClass).addClass(classes).addClass(inputMode).hide().appendTo($dropdown_parent);
- $dropdown_content = $('<div>').addClass(settings.dropdownContentClass).appendTo($dropdown);
-
- $wrapper.css({
- width: self.$input[0].style.width
- });
-
- if (self.plugins.names.length) {
- classes_plugins = 'plugin-' + self.plugins.names.join(' plugin-');
- $wrapper.addClass(classes_plugins);
- $dropdown.addClass(classes_plugins);
- }
-
- if ((settings.maxItems === null || settings.maxItems > 1) && self.tagType === TAG_SELECT) {
- self.$input.attr('multiple', 'multiple');
- }
-
- if (self.settings.placeholder) {
- $control_input.attr('placeholder', settings.placeholder);
- }
-
- self.$wrapper = $wrapper;
- self.$control = $control;
- self.$control_input = $control_input;
- self.$dropdown = $dropdown;
- self.$dropdown_content = $dropdown_content;
-
- $dropdown.on('mouseenter', '[data-selectable]', function() { return self.onOptionHover.apply(self, arguments); });
- $dropdown.on('mousedown', '[data-selectable]', function() { return self.onOptionSelect.apply(self, arguments); });
- watchChildEvent($control, 'mousedown', '*:not(input)', function() { return self.onItemSelect.apply(self, arguments); });
- autoGrow($control_input);
-
- $control.on({
- mousedown : function() { return self.onMouseDown.apply(self, arguments); },
- click : function() { return self.onClick.apply(self, arguments); }
- });
-
- $control_input.on({
- mousedown : function(e) { e.stopPropagation(); },
- keydown : function() { return self.onKeyDown.apply(self, arguments); },
- keyup : function() { return self.onKeyUp.apply(self, arguments); },
- keypress : function() { return self.onKeyPress.apply(self, arguments); },
- resize : function() { self.positionDropdown.apply(self, []); },
- blur : function() { return self.onBlur.apply(self, arguments); },
- focus : function() { return self.onFocus.apply(self, arguments); }
- });
-
- $document.on('keydown' + eventNS, function(e) {
- self.isCmdDown = e[IS_MAC ? 'metaKey' : 'ctrlKey'];
- self.isCtrlDown = e[IS_MAC ? 'altKey' : 'ctrlKey'];
- self.isShiftDown = e.shiftKey;
- });
-
- $document.on('keyup' + eventNS, function(e) {
- if (e.keyCode === KEY_CTRL) self.isCtrlDown = false;
- if (e.keyCode === KEY_SHIFT) self.isShiftDown = false;
- if (e.keyCode === KEY_CMD) self.isCmdDown = false;
- });
-
- $document.on('mousedown' + eventNS, function(e) {
- if (self.isFocused) {
- // prevent events on the dropdown scrollbar from causing the control to blur
- if (e.target === self.$dropdown[0] || e.target.parentNode === self.$dropdown[0]) {
- return false;
- }
- // blur on click outside
- if (!self.$control.has(e.target).length && e.target !== self.$control[0]) {
- self.blur();
- }
- }
- });
-
- $window.on(['scroll' + eventNS, 'resize' + eventNS].join(' '), function() {
- if (self.isOpen) {
- self.positionDropdown.apply(self, arguments);
- }
- });
- $window.on('mousemove' + eventNS, function() {
- self.ignoreHover = false;
- });
-
- // store original children and tab index so that they can be
- // restored when the destroy() method is called.
- this.revertSettings = {
- $children : self.$input.children().detach(),
- tabindex : self.$input.attr('tabindex')
- };
-
- self.$input.attr('tabindex', -1).hide().after(self.$wrapper);
-
- if ($.isArray(settings.items)) {
- self.setValue(settings.items);
- delete settings.items;
- }
-
- // feature detect for the validation API
- if (self.$input[0].validity) {
- self.$input.on('invalid' + eventNS, function(e) {
- e.preventDefault();
- self.isInvalid = true;
- self.refreshState();
- });
- }
-
- self.updateOriginalInput();
- self.refreshItems();
- self.refreshState();
- self.updatePlaceholder();
- self.isSetup = true;
-
- if (self.$input.is(':disabled')) {
- self.disable();
- }
-
- self.on('change', this.onChange);
- self.trigger('initialize');
-
- // preload options
- if (settings.preload) {
- self.onSearchChange('');
- }
- },
-
- /**
- * Sets up default rendering functions.
- */
- setupTemplates: function() {
- var self = this;
- var field_label = self.settings.labelField;
- var field_optgroup = self.settings.optgroupLabelField;
-
- var templates = {
- 'optgroup': function(data) {
- return '<div class="optgroup">' + data.html + '</div>';
- },
- 'optgroup_header': function(data, escape) {
- return '<div class="optgroup-header">' + escape(data[field_optgroup]) + '</div>';
- },
- 'option': function(data, escape) {
- return '<div class="option">' + escape(data[field_label]) + '</div>';
- },
- 'item': function(data, escape) {
- return '<div class="item">' + escape(data[field_label]) + '</div>';
- },
- 'option_create': function(data, escape) {
- return '<div class="create">Add <strong>' + escape(data.input) + '</strong>…</div>';
- }
- };
-
- self.settings.render = $.extend({}, templates, self.settings.render);
- },
-
- /**
- * Maps fired events to callbacks provided
- * in the settings used when creating the control.
- */
- setupCallbacks: function() {
- var key, fn, callbacks = {
- 'initialize' : 'onInitialize',
- 'change' : 'onChange',
- 'item_add' : 'onItemAdd',
- 'item_remove' : 'onItemRemove',
- 'clear' : 'onClear',
- 'option_add' : 'onOptionAdd',
- 'option_remove' : 'onOptionRemove',
- 'option_clear' : 'onOptionClear',
- 'dropdown_open' : 'onDropdownOpen',
- 'dropdown_close' : 'onDropdownClose',
- 'type' : 'onType'
- };
-
- for (key in callbacks) {
- if (callbacks.hasOwnProperty(key)) {
- fn = this.settings[callbacks[key]];
- if (fn) this.on(key, fn);
- }
- }
- },
-
- /**
- * Triggered when the main control element
- * has a click event.
- *
- * @param {object} e
- * @return {boolean}
- */
- onClick: function(e) {
- var self = this;
-
- // necessary for mobile webkit devices (manual focus triggering
- // is ignored unless invoked within a click event)
- if (!self.isFocused) {
- self.focus();
- e.preventDefault();
- }
- },
-
- /**
- * Triggered when the main control element
- * has a mouse down event.
- *
- * @param {object} e
- * @return {boolean}
- */
- onMouseDown: function(e) {
- var self = this;
- var defaultPrevented = e.isDefaultPrevented();
- var $target = $(e.target);
-
- if (self.isFocused) {
- // retain focus by preventing native handling. if the
- // event target is the input it should not be modified.
- // otherwise, text selection within the input won't work.
- if (e.target !== self.$control_input[0]) {
- if (self.settings.mode === 'single') {
- // toggle dropdown
- self.isOpen ? self.close() : self.open();
- } else if (!defaultPrevented) {
- self.setActiveItem(null);
- }
- return false;
- }
- } else {
- // give control focus
- if (!defaultPrevented) {
- window.setTimeout(function() {
- self.focus();
- }, 0);
- }
- }
- },
-
- /**
- * Triggered when the value of the control has been changed.
- * This should propagate the event to the original DOM
- * input / select element.
- */
- onChange: function() {
- this.$input.trigger('change');
- },
-
- /**
- * Triggered on <input> keypress.
- *
- * @param {object} e
- * @returns {boolean}
- */
- onKeyPress: function(e) {
- if (this.isLocked) return e && e.preventDefault();
- var character = String.fromCharCode(e.keyCode || e.which);
- if (this.settings.create && character === this.settings.delimiter) {
- this.createItem();
- e.preventDefault();
- return false;
- }
- },
-
- /**
- * Triggered on <input> keydown.
- *
- * @param {object} e
- * @returns {boolean}
- */
- onKeyDown: function(e) {
- var isInput = e.target === this.$control_input[0];
- var self = this;
-
- if (self.isLocked) {
- if (e.keyCode !== KEY_TAB) {
- e.preventDefault();
- }
- return;
- }
-
- switch (e.keyCode) {
- case KEY_A:
- if (self.isCmdDown) {
- self.selectAll();
- return;
- }
- break;
- case KEY_ESC:
- self.close();
- return;
- case KEY_DOWN:
- if (!self.isOpen && self.hasOptions) {
- self.open();
- } else if (self.$activeOption) {
- self.ignoreHover = true;
- var $next = self.getAdjacentOption(self.$activeOption, 1);
- if ($next.length) self.setActiveOption($next, true, true);
- }
- e.preventDefault();
- return;
- case KEY_UP:
- if (self.$activeOption) {
- self.ignoreHover = true;
- var $prev = self.getAdjacentOption(self.$activeOption, -1);
- if ($prev.length) self.setActiveOption($prev, true, true);
- }
- e.preventDefault();
- return;
- case KEY_RETURN:
- if (self.isOpen && self.$activeOption) {
- self.onOptionSelect({currentTarget: self.$activeOption});
- }
- e.preventDefault();
- return;
- case KEY_LEFT:
- self.advanceSelection(-1, e);
- return;
- case KEY_RIGHT:
- self.advanceSelection(1, e);
- return;
- case KEY_TAB:
- if (self.settings.create && self.createItem()) {
- e.preventDefault();
- }
- return;
- case KEY_BACKSPACE:
- case KEY_DELETE:
- self.deleteSelection(e);
- return;
- }
- if (self.isFull() || self.isInputHidden) {
- e.preventDefault();
- return;
- }
- },
-
- /**
- * Triggered on <input> keyup.
- *
- * @param {object} e
- * @returns {boolean}
- */
- onKeyUp: function(e) {
- var self = this;
-
- if (self.isLocked) return e && e.preventDefault();
- var value = self.$control_input.val() || '';
- if (self.lastValue !== value) {
- self.lastValue = value;
- self.onSearchChange(value);
- self.refreshOptions();
- self.trigger('type', value);
- }
- },
-
- /**
- * Invokes the user-provide option provider / loader.
- *
- * Note: this function is debounced in the Selectize
- * constructor (by `settings.loadDelay` milliseconds)
- *
- * @param {string} value
- */
- onSearchChange: function(value) {
- var self = this;
- var fn = self.settings.load;
- if (!fn) return;
- if (self.loadedSearches.hasOwnProperty(value)) return;
- self.loadedSearches[value] = true;
- self.load(function(callback) {
- fn.apply(self, [value, callback]);
- });
- },
-
- /**
- * Triggered on <input> focus.
- *
- * @param {object} e (optional)
- * @returns {boolean}
- */
- onFocus: function(e) {
- var self = this;
-
- self.isFocused = true;
- if (self.isDisabled) {
- self.blur();
- e && e.preventDefault();
- return false;
- }
-
- if (self.ignoreFocus) return;
- if (self.settings.preload === 'focus') self.onSearchChange('');
-
- if (!self.$activeItems.length) {
- self.showInput();
- self.setActiveItem(null);
- self.refreshOptions(!!self.settings.openOnFocus);
- }
-
- self.refreshState();
- },
-
- /**
- * Triggered on <input> blur.
- *
- * @param {object} e
- * @returns {boolean}
- */
- onBlur: function(e) {
- var self = this;
- self.isFocused = false;
- if (self.ignoreFocus) return;
-
- if (self.settings.create && self.settings.createOnBlur) {
- self.createItem();
- }
-
- self.close();
- self.setTextboxValue('');
- self.setActiveItem(null);
- self.setActiveOption(null);
- self.setCaret(self.items.length);
- self.refreshState();
- },
-
- /**
- * Triggered when the user rolls over
- * an option in the autocomplete dropdown menu.
- *
- * @param {object} e
- * @returns {boolean}
- */
- onOptionHover: function(e) {
- if (this.ignoreHover) return;
- this.setActiveOption(e.currentTarget, false);
- },
-
- /**
- * Triggered when the user clicks on an option
- * in the autocomplete dropdown menu.
- *
- * @param {object} e
- * @returns {boolean}
- */
- onOptionSelect: function(e) {
- var value, $target, $option, self = this;
-
- if (e.preventDefault) {
- e.preventDefault();
- e.stopPropagation();
- }
-
- $target = $(e.currentTarget);
- if ($target.hasClass('create')) {
- self.createItem();
- } else {
- value = $target.attr('data-value');
- if (value) {
- self.lastQuery = null;
- self.setTextboxValue('');
- self.addItem(value);
- if (!self.settings.hideSelected && e.type && /mouse/.test(e.type)) {
- self.setActiveOption(self.getOption(value));
- }
- }
- }
- },
-
- /**
- * Triggered when the user clicks on an item
- * that has been selected.
- *
- * @param {object} e
- * @returns {boolean}
- */
- onItemSelect: function(e) {
- var self = this;
-
- if (self.isLocked) return;
- if (self.settings.mode === 'multi') {
- e.preventDefault();
- self.setActiveItem(e.currentTarget, e);
- }
- },
-
- /**
- * Invokes the provided method that provides
- * results to a callback---which are then added
- * as options to the control.
- *
- * @param {function} fn
- */
- load: function(fn) {
- var self = this;
- var $wrapper = self.$wrapper.addClass('loading');
-
- self.loading++;
- fn.apply(self, [function(results) {
- self.loading = Math.max(self.loading - 1, 0);
- if (results && results.length) {
- self.addOption(results);
- self.refreshOptions(self.isFocused && !self.isInputHidden);
- }
- if (!self.loading) {
- $wrapper.removeClass('loading');
- }
- self.trigger('load', results);
- }]);
- },
-
- /**
- * Sets the input field of the control to the specified value.
- *
- * @param {string} value
- */
- setTextboxValue: function(value) {
- this.$control_input.val(value).triggerHandler('update');
- this.lastValue = value;
- },
-
- /**
- * Returns the value of the control. If multiple items
- * can be selected (e.g. <select multiple>), this returns
- * an array. If only one item can be selected, this
- * returns a string.
- *
- * @returns {mixed}
- */
- getValue: function() {
- if (this.tagType === TAG_SELECT && this.$input.attr('multiple')) {
- return this.items;
- } else {
- return this.items.join(this.settings.delimiter);
- }
- },
-
- /**
- * Resets the selected items to the given value.
- *
- * @param {mixed} value
- */
- setValue: function(value) {
- debounce_events(this, ['change'], function() {
- this.clear();
- var items = $.isArray(value) ? value : [value];
- for (var i = 0, n = items.length; i < n; i++) {
- this.addItem(items[i]);
- }
- });
- },
-
- /**
- * Sets the selected item.
- *
- * @param {object} $item
- * @param {object} e (optional)
- */
- setActiveItem: function($item, e) {
- var self = this;
- var eventName;
- var i, idx, begin, end, item, swap;
- var $last;
-
- if (self.settings.mode === 'single') return;
- $item = $($item);
-
- // clear the active selection
- if (!$item.length) {
- $(self.$activeItems).removeClass('active');
- self.$activeItems = [];
- if (self.isFocused) {
- self.showInput();
- }
- return;
- }
-
- // modify selection
- eventName = e && e.type.toLowerCase();
-
- if (eventName === 'mousedown' && self.isShiftDown && self.$activeItems.length) {
- $last = self.$control.children('.active:last');
- begin = Array.prototype.indexOf.apply(self.$control[0].childNodes, [$last[0]]);
- end = Array.prototype.indexOf.apply(self.$control[0].childNodes, [$item[0]]);
- if (begin > end) {
- swap = begin;
- begin = end;
- end = swap;
- }
- for (i = begin; i <= end; i++) {
- item = self.$control[0].childNodes[i];
- if (self.$activeItems.indexOf(item) === -1) {
- $(item).addClass('active');
- self.$activeItems.push(item);
- }
- }
- e.preventDefault();
- } else if ((eventName === 'mousedown' && self.isCtrlDown) || (eventName === 'keydown' && this.isShiftDown)) {
- if ($item.hasClass('active')) {
- idx = self.$activeItems.indexOf($item[0]);
- self.$activeItems.splice(idx, 1);
- $item.removeClass('active');
- } else {
- self.$activeItems.push($item.addClass('active')[0]);
- }
- } else {
- $(self.$activeItems).removeClass('active');
- self.$activeItems = [$item.addClass('active')[0]];
- }
-
- // ensure control has focus
- self.hideInput();
- if (!this.isFocused) {
- self.focus();
- }
- },
-
- /**
- * Sets the selected item in the dropdown menu
- * of available options.
- *
- * @param {object} $object
- * @param {boolean} scroll
- * @param {boolean} animate
- */
- setActiveOption: function($option, scroll, animate) {
- var height_menu, height_item, y;
- var scroll_top, scroll_bottom;
- var self = this;
-
- if (self.$activeOption) self.$activeOption.removeClass('active');
- self.$activeOption = null;
-
- $option = $($option);
- if (!$option.length) return;
-
- self.$activeOption = $option.addClass('active');
-
- if (scroll || !isset(scroll)) {
-
- height_menu = self.$dropdown_content.height();
- height_item = self.$activeOption.outerHeight(true);
- scroll = self.$dropdown_content.scrollTop() || 0;
- y = self.$activeOption.offset().top - self.$dropdown_content.offset().top + scroll;
- scroll_top = y;
- scroll_bottom = y - height_menu + height_item;
-
- if (y + height_item > height_menu + scroll) {
- self.$dropdown_content.stop().animate({scrollTop: scroll_bottom}, animate ? self.settings.scrollDuration : 0);
- } else if (y < scroll) {
- self.$dropdown_content.stop().animate({scrollTop: scroll_top}, animate ? self.settings.scrollDuration : 0);
- }
-
- }
- },
-
- /**
- * Selects all items (CTRL + A).
- */
- selectAll: function() {
- var self = this;
- if (self.settings.mode === 'single') return;
-
- self.$activeItems = Array.prototype.slice.apply(self.$control.children(':not(input)').addClass('active'));
- if (self.$activeItems.length) {
- self.hideInput();
- self.close();
- }
- self.focus();
- },
-
- /**
- * Hides the input element out of view, while
- * retaining its focus.
- */
- hideInput: function() {
- var self = this;
-
- self.setTextboxValue('');
- self.$control_input.css({opacity: 0, position: 'absolute', left: self.rtl ? 10000 : -10000});
- self.isInputHidden = true;
- },
-
- /**
- * Restores input visibility.
- */
- showInput: function() {
- this.$control_input.css({opacity: 1, position: 'relative', left: 0});
- this.isInputHidden = false;
- },
-
- /**
- * Gives the control focus. If "trigger" is falsy,
- * focus handlers won't be fired--causing the focus
- * to happen silently in the background.
- *
- * @param {boolean} trigger
- */
- focus: function() {
- var self = this;
- if (self.isDisabled) return;
-
- self.ignoreFocus = true;
- self.$control_input[0].focus();
- window.setTimeout(function() {
- self.ignoreFocus = false;
- self.onFocus();
- }, 0);
- },
-
- /**
- * Forces the control out of focus.
- */
- blur: function() {
- this.$control_input.trigger('blur');
- },
-
- /**
- * Returns a function that scores an object
- * to show how good of a match it is to the
- * provided query.
- *
- * @param {string} query
- * @param {object} options
- * @return {function}
- */
- getScoreFunction: function(query) {
- return this.sifter.getScoreFunction(query, this.getSearchOptions());
- },
-
- /**
- * Returns search options for sifter (the system
- * for scoring and sorting results).
- *
- * @see https://github.com/brianreavis/sifter.js
- * @return {object}
- */
- getSearchOptions: function() {
- var settings = this.settings;
- var sort = settings.sortField;
- if (typeof sort === 'string') {
- sort = {field: sort};
- }
-
- return {
- fields : settings.searchField,
- conjunction : settings.searchConjunction,
- sort : sort
- };
- },
-
- /**
- * Searches through available options and returns
- * a sorted array of matches.
- *
- * Returns an object containing:
- *
- * - query {string}
- * - tokens {array}
- * - total {int}
- * - items {array}
- *
- * @param {string} query
- * @returns {object}
- */
- search: function(query) {
- var i, value, score, result, calculateScore;
- var self = this;
- var settings = self.settings;
- var options = this.getSearchOptions();
-
- // validate user-provided result scoring function
- if (settings.score) {
- calculateScore = self.settings.score.apply(this, [query]);
- if (typeof calculateScore !== 'function') {
- throw new Error('Selectize "score" setting must be a function that returns a function');
- }
- }
-
- // perform search
- if (query !== self.lastQuery) {
- self.lastQuery = query;
- result = self.sifter.search(query, $.extend(options, {score: calculateScore}));
- self.currentResults = result;
- } else {
- result = $.extend(true, {}, self.currentResults);
- }
-
- // filter out selected items
- if (settings.hideSelected) {
- for (i = result.items.length - 1; i >= 0; i--) {
- if (self.items.indexOf(hash_key(result.items[i].id)) !== -1) {
- result.items.splice(i, 1);
- }
- }
- }
-
- return result;
- },
-
- /**
- * Refreshes the list of available options shown
- * in the autocomplete dropdown menu.
- *
- * @param {boolean} triggerDropdown
- */
- refreshOptions: function(triggerDropdown) {
- var i, j, k, n, groups, groups_order, option, option_html, optgroup, optgroups, html, html_children, has_create_option;
- var $active, $active_before, $create;
-
- if (typeof triggerDropdown === 'undefined') {
- triggerDropdown = true;
- }
-
- var self = this;
- var query = self.$control_input.val();
- var results = self.search(query);
- var $dropdown_content = self.$dropdown_content;
- var active_before = self.$activeOption && hash_key(self.$activeOption.attr('data-value'));
-
- // build markup
- n = results.items.length;
- if (typeof self.settings.maxOptions === 'number') {
- n = Math.min(n, self.settings.maxOptions);
- }
-
- // render and group available options individually
- groups = {};
-
- if (self.settings.optgroupOrder) {
- groups_order = self.settings.optgroupOrder;
- for (i = 0; i < groups_order.length; i++) {
- groups[groups_order[i]] = [];
- }
- } else {
- groups_order = [];
- }
-
- for (i = 0; i < n; i++) {
- option = self.options[results.items[i].id];
- option_html = self.render('option', option);
- optgroup = option[self.settings.optgroupField] || '';
- optgroups = $.isArray(optgroup) ? optgroup : [optgroup];
-
- for (j = 0, k = optgroups && optgroups.length; j < k; j++) {
- optgroup = optgroups[j];
- if (!self.optgroups.hasOwnProperty(optgroup)) {
- optgroup = '';
- }
- if (!groups.hasOwnProperty(optgroup)) {
- groups[optgroup] = [];
- groups_order.push(optgroup);
- }
- groups[optgroup].push(option_html);
- }
- }
-
- // render optgroup headers & join groups
- html = [];
- for (i = 0, n = groups_order.length; i < n; i++) {
- optgroup = groups_order[i];
- if (self.optgroups.hasOwnProperty(optgroup) && groups[optgroup].length) {
- // render the optgroup header and options within it,
- // then pass it to the wrapper template
- html_children = self.render('optgroup_header', self.optgroups[optgroup]) || '';
- html_children += groups[optgroup].join('');
- html.push(self.render('optgroup', $.extend({}, self.optgroups[optgroup], {
- html: html_children
- })));
- } else {
- html.push(groups[optgroup].join(''));
- }
- }
-
- $dropdown_content.html(html.join(''));
-
- // highlight matching terms inline
- if (self.settings.highlight && results.query.length && results.tokens.length) {
- for (i = 0, n = results.tokens.length; i < n; i++) {
- highlight($dropdown_content, results.tokens[i].regex);
- }
- }
-
- // add "selected" class to selected options
- if (!self.settings.hideSelected) {
- for (i = 0, n = self.items.length; i < n; i++) {
- self.getOption(self.items[i]).addClass('selected');
- }
- }
-
- // add create option
- has_create_option = self.settings.create && results.query.length;
- if (has_create_option) {
- $dropdown_content.prepend(self.render('option_create', {input: query}));
- $create = $($dropdown_content[0].childNodes[0]);
- }
-
- // activate
- self.hasOptions = results.items.length > 0 || has_create_option;
- if (self.hasOptions) {
- if (results.items.length > 0) {
- $active_before = active_before && self.getOption(active_before);
- if ($active_before && $active_before.length) {
- $active = $active_before;
- } else if (self.settings.mode === 'single' && self.items.length) {
- $active = self.getOption(self.items[0]);
- }
- if (!$active || !$active.length) {
- if ($create && !self.settings.addPrecedence) {
- $active = self.getAdjacentOption($create, 1);
- } else {
- $active = $dropdown_content.find('[data-selectable]:first');
- }
- }
- } else {
- $active = $create;
- }
- self.setActiveOption($active);
- if (triggerDropdown && !self.isOpen) { self.open(); }
- } else {
- self.setActiveOption(null);
- if (triggerDropdown && self.isOpen) { self.close(); }
- }
- },
-
- /**
- * Adds an available option. If it already exists,
- * nothing will happen. Note: this does not refresh
- * the options list dropdown (use `refreshOptions`
- * for that).
- *
- * Usage:
- *
- * this.addOption(data)
- *
- * @param {object} data
- */
- addOption: function(data) {
- var i, n, optgroup, value, self = this;
-
- if ($.isArray(data)) {
- for (i = 0, n = data.length; i < n; i++) {
- self.addOption(data[i]);
- }
- return;
- }
-
- value = hash_key(data[self.settings.valueField]);
- if (!value || self.options.hasOwnProperty(value)) return;
-
- self.userOptions[value] = true;
- self.options[value] = data;
- self.lastQuery = null;
- self.trigger('option_add', value, data);
- },
-
- /**
- * Registers a new optgroup for options
- * to be bucketed into.
- *
- * @param {string} id
- * @param {object} data
- */
- addOptionGroup: function(id, data) {
- this.optgroups[id] = data;
- this.trigger('optgroup_add', id, data);
- },
-
- /**
- * Updates an option available for selection. If
- * it is visible in the selected items or options
- * dropdown, it will be re-rendered automatically.
- *
- * @param {string} value
- * @param {object} data
- */
- updateOption: function(value, data) {
- var self = this;
- var $item, $item_new;
- var value_new, index_item, cache_items, cache_options;
-
- value = hash_key(value);
- value_new = hash_key(data[self.settings.valueField]);
-
- // sanity checks
- if (!self.options.hasOwnProperty(value)) return;
- if (!value_new) throw new Error('Value must be set in option data');
-
- // update references
- if (value_new !== value) {
- delete self.options[value];
- index_item = self.items.indexOf(value);
- if (index_item !== -1) {
- self.items.splice(index_item, 1, value_new);
- }
- }
- self.options[value_new] = data;
-
- // invalidate render cache
- cache_items = self.renderCache['item'];
- cache_options = self.renderCache['option'];
-
- if (isset(cache_items)) {
- delete cache_items[value];
- delete cache_items[value_new];
- }
- if (isset(cache_options)) {
- delete cache_options[value];
- delete cache_options[value_new];
- }
-
- // update the item if it's selected
- if (self.items.indexOf(value_new) !== -1) {
- $item = self.getItem(value);
- $item_new = $(self.render('item', data));
- if ($item.hasClass('active')) $item_new.addClass('active');
- $item.replaceWith($item_new);
- }
-
- // update dropdown contents
- if (self.isOpen) {
- self.refreshOptions(false);
- }
- },
-
- /**
- * Removes a single option.
- *
- * @param {string} value
- */
- removeOption: function(value) {
- var self = this;
-
- value = hash_key(value);
- delete self.userOptions[value];
- delete self.options[value];
- self.lastQuery = null;
- self.trigger('option_remove', value);
- self.removeItem(value);
- },
-
- /**
- * Clears all options.
- */
- clearOptions: function() {
- var self = this;
-
- self.loadedSearches = {};
- self.userOptions = {};
- self.options = self.sifter.items = {};
- self.lastQuery = null;
- self.trigger('option_clear');
- self.clear();
- },
-
- /**
- * Returns the jQuery element of the option
- * matching the given value.
- *
- * @param {string} value
- * @returns {object}
- */
- getOption: function(value) {
- return this.getElementWithValue(value, this.$dropdown_content.find('[data-selectable]'));
- },
-
- /**
- * Returns the jQuery element of the next or
- * previous selectable option.
- *
- * @param {object} $option
- * @param {int} direction can be 1 for next or -1 for previous
- * @return {object}
- */
- getAdjacentOption: function($option, direction) {
- var $options = this.$dropdown.find('[data-selectable]');
- var index = $options.index($option) + direction;
-
- return index >= 0 && index < $options.length ? $options.eq(index) : $();
- },
-
- /**
- * Finds the first element with a "data-value" attribute
- * that matches the given value.
- *
- * @param {mixed} value
- * @param {object} $els
- * @return {object}
- */
- getElementWithValue: function(value, $els) {
- value = hash_key(value);
-
- if (value) {
- for (var i = 0, n = $els.length; i < n; i++) {
- if ($els[i].getAttribute('data-value') === value) {
- return $($els[i]);
- }
- }
- }
-
- return $();
- },
-
- /**
- * Returns the jQuery element of the item
- * matching the given value.
- *
- * @param {string} value
- * @returns {object}
- */
- getItem: function(value) {
- return this.getElementWithValue(value, this.$control.children());
- },
-
- /**
- * "Selects" an item. Adds it to the list
- * at the current caret position.
- *
- * @param {string} value
- */
- addItem: function(value) {
- debounce_events(this, ['change'], function() {
- var $item, $option;
- var self = this;
- var inputMode = self.settings.mode;
- var i, active, options, value_next;
- value = hash_key(value);
-
- if (self.items.indexOf(value) !== -1) {
- if (inputMode === 'single') self.close();
- return;
- }
-
- if (!self.options.hasOwnProperty(value)) return;
- if (inputMode === 'single') self.clear();
- if (inputMode === 'multi' && self.isFull()) return;
-
- $item = $(self.render('item', self.options[value]));
- self.items.splice(self.caretPos, 0, value);
- self.insertAtCaret($item);
- self.refreshState();
-
- if (self.isSetup) {
- options = self.$dropdown_content.find('[data-selectable]');
-
- // update menu / remove the option
- $option = self.getOption(value);
- value_next = self.getAdjacentOption($option, 1).attr('data-value');
- self.refreshOptions(self.isFocused && inputMode !== 'single');
- if (value_next) {
- self.setActiveOption(self.getOption(value_next));
- }
-
- // hide the menu if the maximum number of items have been selected or no options are left
- if (!options.length || (self.settings.maxItems !== null && self.items.length >= self.settings.maxItems)) {
- self.close();
- } else {
- self.positionDropdown();
- }
-
- self.updatePlaceholder();
- self.trigger('item_add', value, $item);
- self.updateOriginalInput();
- }
- });
- },
-
- /**
- * Removes the selected item matching
- * the provided value.
- *
- * @param {string} value
- */
- removeItem: function(value) {
- var self = this;
- var $item, i, idx;
-
- $item = (typeof value === 'object') ? value : self.getItem(value);
- value = hash_key($item.attr('data-value'));
- i = self.items.indexOf(value);
-
- if (i !== -1) {
- $item.remove();
- if ($item.hasClass('active')) {
- idx = self.$activeItems.indexOf($item[0]);
- self.$activeItems.splice(idx, 1);
- }
-
- self.items.splice(i, 1);
- self.lastQuery = null;
- if (!self.settings.persist && self.userOptions.hasOwnProperty(value)) {
- self.removeOption(value);
- }
-
- if (i < self.caretPos) {
- self.setCaret(self.caretPos - 1);
- }
-
- self.refreshState();
- self.updatePlaceholder();
- self.updateOriginalInput();
- self.positionDropdown();
- self.trigger('item_remove', value);
- }
- },
-
- /**
- * Invokes the `create` method provided in the
- * selectize options that should provide the data
- * for the new item, given the user input.
- *
- * Once this completes, it will be added
- * to the item list.
- *
- * @return {boolean}
- */
- createItem: function() {
- var self = this;
- var input = $.trim(self.$control_input.val() || '');
- var caret = self.caretPos;
- if (!input.length) return false;
- self.lock();
-
- var setup = (typeof self.settings.create === 'function') ? this.settings.create : function(input) {
- var data = {};
- data[self.settings.labelField] = input;
- data[self.settings.valueField] = input;
- return data;
- };
-
- var create = once(function(data) {
- self.unlock();
-
- if (!data || typeof data !== 'object') return;
- var value = hash_key(data[self.settings.valueField]);
- if (!value) return;
-
- self.setTextboxValue('');
- self.addOption(data);
- self.setCaret(caret);
- self.addItem(value);
- self.refreshOptions(self.settings.mode !== 'single');
- });
-
- var output = setup.apply(this, [input, create]);
- if (typeof output !== 'undefined') {
- create(output);
- }
-
- return true;
- },
-
- /**
- * Re-renders the selected item lists.
- */
- refreshItems: function() {
- this.lastQuery = null;
-
- if (this.isSetup) {
- for (var i = 0; i < this.items.length; i++) {
- this.addItem(this.items);
- }
- }
-
- this.refreshState();
- this.updateOriginalInput();
- },
-
- /**
- * Updates all state-dependent attributes
- * and CSS classes.
- */
- refreshState: function() {
- var self = this;
- var invalid = self.isRequired && !self.items.length;
- if (!invalid) self.isInvalid = false;
- self.$control_input.prop('required', invalid);
- self.refreshClasses();
- },
-
- /**
- * Updates all state-dependent CSS classes.
- */
- refreshClasses: function() {
- var self = this;
- var isFull = self.isFull();
- var isLocked = self.isLocked;
-
- self.$wrapper
- .toggleClass('rtl', self.rtl);
-
- self.$control
- .toggleClass('focus', self.isFocused)
- .toggleClass('disabled', self.isDisabled)
- .toggleClass('required', self.isRequired)
- .toggleClass('invalid', self.isInvalid)
- .toggleClass('locked', isLocked)
- .toggleClass('full', isFull).toggleClass('not-full', !isFull)
- .toggleClass('input-active', self.isFocused && !self.isInputHidden)
- .toggleClass('dropdown-active', self.isOpen)
- .toggleClass('has-options', !$.isEmptyObject(self.options))
- .toggleClass('has-items', self.items.length > 0);
-
- self.$control_input.data('grow', !isFull && !isLocked);
- },
-
- /**
- * Determines whether or not more items can be added
- * to the control without exceeding the user-defined maximum.
- *
- * @returns {boolean}
- */
- isFull: function() {
- return this.settings.maxItems !== null && this.items.length >= this.settings.maxItems;
- },
-
- /**
- * Refreshes the original <select> or <input>
- * element to reflect the current state.
- */
- updateOriginalInput: function() {
- var i, n, options, self = this;
-
- if (self.$input[0].tagName.toLowerCase() === 'select') {
- options = [];
- for (i = 0, n = self.items.length; i < n; i++) {
- options.push('<option value="' + escape_html(self.items[i]) + '" selected="selected"></option>');
- }
- if (!options.length && !this.$input.attr('multiple')) {
- options.push('<option value="" selected="selected"></option>');
- }
- self.$input.html(options.join(''));
- } else {
- self.$input.val(self.getValue());
- }
-
- if (self.isSetup) {
- self.trigger('change', self.$input.val());
- }
- },
-
- /**
- * Shows/hide the input placeholder depending
- * on if there items in the list already.
- */
- updatePlaceholder: function() {
- if (!this.settings.placeholder) return;
- var $input = this.$control_input;
-
- if (this.items.length) {
- $input.removeAttr('placeholder');
- } else {
- $input.attr('placeholder', this.settings.placeholder);
- }
- $input.triggerHandler('update');
- },
-
- /**
- * Shows the autocomplete dropdown containing
- * the available options.
- */
- open: function() {
- var self = this;
-
- if (self.isLocked || self.isOpen || (self.settings.mode === 'multi' && self.isFull())) return;
- self.focus();
- self.isOpen = true;
- self.refreshState();
- self.$dropdown.css({visibility: 'hidden', display: 'block'});
- self.positionDropdown();
- self.$dropdown.css({visibility: 'visible'});
- self.trigger('dropdown_open', self.$dropdown);
- },
-
- /**
- * Closes the autocomplete dropdown menu.
- */
- close: function() {
- var self = this;
- var trigger = self.isOpen;
-
- if (self.settings.mode === 'single' && self.items.length) {
- self.hideInput();
- }
-
- self.isOpen = false;
- self.$dropdown.hide();
- self.setActiveOption(null);
- self.refreshState();
-
- if (trigger) self.trigger('dropdown_close', self.$dropdown);
- },
-
- /**
- * Calculates and applies the appropriate
- * position of the dropdown.
- */
- positionDropdown: function() {
- var $control = this.$control;
- var offset = this.settings.dropdownParent === 'body' ? $control.offset() : $control.position();
- offset.top += $control.outerHeight(true);
-
- this.$dropdown.css({
- width : $control.outerWidth(),
- top : offset.top,
- left : offset.left
- });
- },
-
- /**
- * Resets / clears all selected items
- * from the control.
- */
- clear: function() {
- var self = this;
-
- if (!self.items.length) return;
- self.$control.children(':not(input)').remove();
- self.items = [];
- self.setCaret(0);
- self.updatePlaceholder();
- self.updateOriginalInput();
- self.refreshState();
- self.showInput();
- self.trigger('clear');
- },
-
- /**
- * A helper method for inserting an element
- * at the current caret position.
- *
- * @param {object} $el
- */
- insertAtCaret: function($el) {
- var caret = Math.min(this.caretPos, this.items.length);
- if (caret === 0) {
- this.$control.prepend($el);
- } else {
- $(this.$control[0].childNodes[caret]).before($el);
- }
- this.setCaret(caret + 1);
- },
-
- /**
- * Removes the current selected item(s).
- *
- * @param {object} e (optional)
- * @returns {boolean}
- */
- deleteSelection: function(e) {
- var i, n, direction, selection, values, caret, option_select, $option_select, $tail;
- var self = this;
-
- direction = (e && e.keyCode === KEY_BACKSPACE) ? -1 : 1;
- selection = getSelection(self.$control_input[0]);
-
- if (self.$activeOption && !self.settings.hideSelected) {
- option_select = self.getAdjacentOption(self.$activeOption, -1).attr('data-value');
- }
-
- // determine items that will be removed
- values = [];
-
- if (self.$activeItems.length) {
- $tail = self.$control.children('.active:' + (direction > 0 ? 'last' : 'first'));
- caret = self.$control.children(':not(input)').index($tail);
- if (direction > 0) { caret++; }
-
- for (i = 0, n = self.$activeItems.length; i < n; i++) {
- values.push($(self.$activeItems[i]).attr('data-value'));
- }
- if (e) {
- e.preventDefault();
- e.stopPropagation();
- }
- } else if ((self.isFocused || self.settings.mode === 'single') && self.items.length) {
- if (direction < 0 && selection.start === 0 && selection.length === 0) {
- values.push(self.items[self.caretPos - 1]);
- } else if (direction > 0 && selection.start === self.$control_input.val().length) {
- values.push(self.items[self.caretPos]);
- }
- }
-
- // allow the callback to abort
- if (!values.length || (typeof self.settings.onDelete === 'function' && self.settings.onDelete.apply(self, [values]) === false)) {
- return false;
- }
-
- // perform removal
- if (typeof caret !== 'undefined') {
- self.setCaret(caret);
- }
- while (values.length) {
- self.removeItem(values.pop());
- }
-
- self.showInput();
- self.positionDropdown();
- self.refreshOptions(true);
-
- // select previous option
- if (option_select) {
- $option_select = self.getOption(option_select);
- if ($option_select.length) {
- self.setActiveOption($option_select);
- }
- }
-
- return true;
- },
-
- /**
- * Selects the previous / next item (depending
- * on the `direction` argument).
- *
- * > 0 - right
- * < 0 - left
- *
- * @param {int} direction
- * @param {object} e (optional)
- */
- advanceSelection: function(direction, e) {
- var tail, selection, idx, valueLength, cursorAtEdge, $tail;
- var self = this;
-
- if (direction === 0) return;
- if (self.rtl) direction *= -1;
-
- tail = direction > 0 ? 'last' : 'first';
- selection = getSelection(self.$control_input[0]);
-
- if (self.isFocused && !self.isInputHidden) {
- valueLength = self.$control_input.val().length;
- cursorAtEdge = direction < 0
- ? selection.start === 0 && selection.length === 0
- : selection.start === valueLength;
-
- if (cursorAtEdge && !valueLength) {
- self.advanceCaret(direction, e);
- }
- } else {
- $tail = self.$control.children('.active:' + tail);
- if ($tail.length) {
- idx = self.$control.children(':not(input)').index($tail);
- self.setActiveItem(null);
- self.setCaret(direction > 0 ? idx + 1 : idx);
- }
- }
- },
-
- /**
- * Moves the caret left / right.
- *
- * @param {int} direction
- * @param {object} e (optional)
- */
- advanceCaret: function(direction, e) {
- var self = this, fn, $adj;
-
- if (direction === 0) return;
-
- fn = direction > 0 ? 'next' : 'prev';
- if (self.isShiftDown) {
- $adj = self.$control_input[fn]();
- if ($adj.length) {
- self.hideInput();
- self.setActiveItem($adj);
- e && e.preventDefault();
- }
- } else {
- self.setCaret(self.caretPos + direction);
- }
- },
-
- /**
- * Moves the caret to the specified index.
- *
- * @param {int} i
- */
- setCaret: function(i) {
- var self = this;
-
- if (self.settings.mode === 'single') {
- i = self.items.length;
- } else {
- i = Math.max(0, Math.min(self.items.length, i));
- }
-
- // the input must be moved by leaving it in place and moving the
- // siblings, due to the fact that focus cannot be restored once lost
- // on mobile webkit devices
- var j, n, fn, $children, $child;
- $children = self.$control.children(':not(input)');
- for (j = 0, n = $children.length; j < n; j++) {
- $child = $($children[j]).detach();
- if (j < i) {
- self.$control_input.before($child);
- } else {
- self.$control.append($child);
- }
- }
-
- self.caretPos = i;
- },
-
- /**
- * Disables user input on the control. Used while
- * items are being asynchronously created.
- */
- lock: function() {
- this.close();
- this.isLocked = true;
- this.refreshState();
- },
-
- /**
- * Re-enables user input on the control.
- */
- unlock: function() {
- this.isLocked = false;
- this.refreshState();
- },
-
- /**
- * Disables user input on the control completely.
- * While disabled, it cannot receive focus.
- */
- disable: function() {
- var self = this;
- self.$input.prop('disabled', true);
- self.isDisabled = true;
- self.lock();
- },
-
- /**
- * Enables the control so that it can respond
- * to focus and user input.
- */
- enable: function() {
- var self = this;
- self.$input.prop('disabled', false);
- self.isDisabled = false;
- self.unlock();
- },
-
- /**
- * Completely destroys the control and
- * unbinds all event listeners so that it can
- * be garbage collected.
- */
- destroy: function() {
- var self = this;
- var eventNS = self.eventNS;
- var revertSettings = self.revertSettings;
-
- self.trigger('destroy');
- self.off();
- self.$wrapper.remove();
- self.$dropdown.remove();
-
- self.$input
- .html('')
- .append(revertSettings.$children)
- .removeAttr('tabindex')
- .attr({tabindex: revertSettings.tabindex})
- .show();
-
- $(window).off(eventNS);
- $(document).off(eventNS);
- $(document.body).off(eventNS);
-
- delete self.$input[0].selectize;
- },
-
- /**
- * A helper method for rendering "item" and
- * "option" templates, given the data.
- *
- * @param {string} templateName
- * @param {object} data
- * @returns {string}
- */
- render: function(templateName, data) {
- var value, id, label;
- var html = '';
- var cache = false;
- var self = this;
- var regex_tag = /^[\t ]*<([a-z][a-z0-9\-_]*(?:\:[a-z][a-z0-9\-_]*)?)/i;
-
- if (templateName === 'option' || templateName === 'item') {
- value = hash_key(data[self.settings.valueField]);
- cache = !!value;
- }
-
- // pull markup from cache if it exists
- if (cache) {
- if (!isset(self.renderCache[templateName])) {
- self.renderCache[templateName] = {};
- }
- if (self.renderCache[templateName].hasOwnProperty(value)) {
- return self.renderCache[templateName][value];
- }
- }
-
- // render markup
- html = self.settings.render[templateName].apply(this, [data, escape_html]);
-
- // add mandatory attributes
- if (templateName === 'option' || templateName === 'option_create') {
- html = html.replace(regex_tag, '<$1 data-selectable');
- }
- if (templateName === 'optgroup') {
- id = data[self.settings.optgroupValueField] || '';
- html = html.replace(regex_tag, '<$1 data-group="' + escape_replace(escape_html(id)) + '"');
- }
- if (templateName === 'option' || templateName === 'item') {
- html = html.replace(regex_tag, '<$1 data-value="' + escape_replace(escape_html(value || '')) + '"');
- }
-
- // update cache
- if (cache) {
- self.renderCache[templateName][value] = html;
- }
-
- return html;
- }
-
- });
-
-
- Selectize.count = 0;
- Selectize.defaults = {
- plugins: [],
- delimiter: ',',
- persist: true,
- diacritics: true,
- create: false,
- createOnBlur: false,
- highlight: true,
- openOnFocus: true,
- maxOptions: 1000,
- maxItems: null,
- hideSelected: null,
- addPrecedence: false,
- preload: false,
-
- scrollDuration: 60,
- loadThrottle: 300,
-
- dataAttr: 'data-data',
- optgroupField: 'optgroup',
- valueField: 'value',
- labelField: 'text',
- optgroupLabelField: 'label',
- optgroupValueField: 'value',
- optgroupOrder: null,
-
- sortField: '$order',
- searchField: ['text'],
- searchConjunction: 'and',
-
- mode: null,
- wrapperClass: 'selectize-control',
- inputClass: 'selectize-input',
- dropdownClass: 'selectize-dropdown',
- dropdownContentClass: 'selectize-dropdown-content',
-
- dropdownParent: null,
-
- /*
- load : null, // function(query, callback) { ... }
- score : null, // function(search) { ... }
- onInitialize : null, // function() { ... }
- onChange : null, // function(value) { ... }
- onItemAdd : null, // function(value, $item) { ... }
- onItemRemove : null, // function(value) { ... }
- onClear : null, // function() { ... }
- onOptionAdd : null, // function(value, data) { ... }
- onOptionRemove : null, // function(value) { ... }
- onOptionClear : null, // function() { ... }
- onDropdownOpen : null, // function($dropdown) { ... }
- onDropdownClose : null, // function($dropdown) { ... }
- onType : null, // function(str) { ... }
- onDelete : null, // function(values) { ... }
- */
-
- render: {
- /*
- item: null,
- optgroup: null,
- optgroup_header: null,
- option: null,
- option_create: null
- */
- }
- };
-
- $.fn.selectize = function(settings_user) {
- var defaults = $.fn.selectize.defaults;
- var settings = $.extend({}, defaults, settings_user);
- var attr_data = settings.dataAttr;
- var field_label = settings.labelField;
- var field_value = settings.valueField;
- var field_optgroup = settings.optgroupField;
- var field_optgroup_label = settings.optgroupLabelField;
- var field_optgroup_value = settings.optgroupValueField;
-
- /**
- * Initializes selectize from a <input type="text"> element.
- *
- * @param {object} $input
- * @param {object} settings_element
- */
- var init_textbox = function($input, settings_element) {
- var i, n, values, option, value = $.trim($input.val() || '');
- if (!value.length) return;
-
- values = value.split(settings.delimiter);
- for (i = 0, n = values.length; i < n; i++) {
- option = {};
- option[field_label] = values[i];
- option[field_value] = values[i];
-
- settings_element.options[values[i]] = option;
- }
-
- settings_element.items = values;
- };
-
- /**
- * Initializes selectize from a <select> element.
- *
- * @param {object} $input
- * @param {object} settings_element
- */
- var init_select = function($input, settings_element) {
- var i, n, tagName, $children, order = 0;
- var options = settings_element.options;
-
- var readData = function($el) {
- var data = attr_data && $el.attr(attr_data);
- if (typeof data === 'string' && data.length) {
- return JSON.parse(data);
- }
- return null;
- };
-
- var addOption = function($option, group) {
- var value, option;
-
- $option = $($option);
-
- value = $option.attr('value') || '';
- if (!value.length) return;
-
- // if the option already exists, it's probably been
- // duplicated in another optgroup. in this case, push
- // the current group to the "optgroup" property on the
- // existing option so that it's rendered in both places.
- if (options.hasOwnProperty(value)) {
- if (group) {
- if (!options[value].optgroup) {
- options[value].optgroup = group;
- } else if (!$.isArray(options[value].optgroup)) {
- options[value].optgroup = [options[value].optgroup, group];
- } else {
- options[value].optgroup.push(group);
- }
- }
- return;
- }
-
- option = readData($option) || {};
- option[field_label] = option[field_label] || $option.text();
- option[field_value] = option[field_value] || value;
- option[field_optgroup] = option[field_optgroup] || group;
-
- option.$order = ++order;
- options[value] = option;
-
- if ($option.is(':selected')) {
- settings_element.items.push(value);
- }
- };
-
- var addGroup = function($optgroup) {
- var i, n, id, optgroup, $options;
-
- $optgroup = $($optgroup);
- id = $optgroup.attr('label');
-
- if (id) {
- optgroup = readData($optgroup) || {};
- optgroup[field_optgroup_label] = id;
- optgroup[field_optgroup_value] = id;
- settings_element.optgroups[id] = optgroup;
- }
-
- $options = $('option', $optgroup);
- for (i = 0, n = $options.length; i < n; i++) {
- addOption($options[i], id);
- }
- };
-
- settings_element.maxItems = $input.attr('multiple') ? null : 1;
-
- $children = $input.children();
- for (i = 0, n = $children.length; i < n; i++) {
- tagName = $children[i].tagName.toLowerCase();
- if (tagName === 'optgroup') {
- addGroup($children[i]);
- } else if (tagName === 'option') {
- addOption($children[i]);
- }
- }
- };
-
- return this.each(function() {
- if (this.selectize) return;
-
- var instance;
- var $input = $(this);
- var tag_name = this.tagName.toLowerCase();
- var settings_element = {
- 'placeholder' : $input.children('option[value=""]').text() || $input.attr('placeholder'),
- 'options' : {},
- 'optgroups' : {},
- 'items' : []
- };
-
- if (tag_name === 'select') {
- init_select($input, settings_element);
- } else {
- init_textbox($input, settings_element);
- }
-
- instance = new Selectize($input, $.extend(true, {}, defaults, settings_element, settings_user));
- $input.data('selectize', instance);
- $input.addClass('selectized');
- });
- };
-
- $.fn.selectize.defaults = Selectize.defaults;
-
- Selectize.define('drag_drop', function(options) {
- if (!$.fn.sortable) throw new Error('The "drag_drop" plugin requires jQuery UI "sortable".');
- if (this.settings.mode !== 'multi') return;
- var self = this;
-
- self.lock = (function() {
- var original = self.lock;
- return function() {
- var sortable = self.$control.data('sortable');
- if (sortable) sortable.disable();
- return original.apply(self, arguments);
- };
- })();
-
- self.unlock = (function() {
- var original = self.unlock;
- return function() {
- var sortable = self.$control.data('sortable');
- if (sortable) sortable.enable();
- return original.apply(self, arguments);
- };
- })();
-
- self.setup = (function() {
- var original = self.setup;
- return function() {
- original.apply(this, arguments);
-
- var $control = self.$control.sortable({
- items: '[data-value]',
- forcePlaceholderSize: true,
- disabled: self.isLocked,
- start: function(e, ui) {
- ui.placeholder.css('width', ui.helper.css('width'));
- $control.css({overflow: 'visible'});
- },
- stop: function() {
- $control.css({overflow: 'hidden'});
- var active = self.$activeItems ? self.$activeItems.slice() : null;
- var values = [];
- $control.children('[data-value]').each(function() {
- values.push($(this).attr('data-value'));
- });
- self.setValue(values);
- self.setActiveItem(active);
- }
- });
- };
- })();
-
- });
-
- Selectize.define('dropdown_header', function(options) {
- var self = this;
-
- options = $.extend({
- title : 'Untitled',
- headerClass : 'selectize-dropdown-header',
- titleRowClass : 'selectize-dropdown-header-title',
- labelClass : 'selectize-dropdown-header-label',
- closeClass : 'selectize-dropdown-header-close',
-
- html: function(data) {
- return (
- '<div class="' + data.headerClass + '">' +
- '<div class="' + data.titleRowClass + '">' +
- '<span class="' + data.labelClass + '">' + data.title + '</span>' +
- '<a href="javascript:void(0)" class="' + data.closeClass + '">×</a>' +
- '</div>' +
- '</div>'
- );
- }
- }, options);
-
- self.setup = (function() {
- var original = self.setup;
- return function() {
- original.apply(self, arguments);
- self.$dropdown_header = $(options.html(options));
- self.$dropdown.prepend(self.$dropdown_header);
- };
- })();
-
- });
-
- Selectize.define('optgroup_columns', function(options) {
- var self = this;
-
- options = $.extend({
- equalizeWidth : true,
- equalizeHeight : true
- }, options);
-
- this.getAdjacentOption = function($option, direction) {
- var $options = $option.closest('[data-group]').find('[data-selectable]');
- var index = $options.index($option) + direction;
-
- return index >= 0 && index < $options.length ? $options.eq(index) : $();
- };
-
- this.onKeyDown = (function() {
- var original = self.onKeyDown;
- return function(e) {
- var index, $option, $options, $optgroup;
-
- if (this.isOpen && (e.keyCode === KEY_LEFT || e.keyCode === KEY_RIGHT)) {
- self.ignoreHover = true;
- $optgroup = this.$activeOption.closest('[data-group]');
- index = $optgroup.find('[data-selectable]').index(this.$activeOption);
-
- if(e.keyCode === KEY_LEFT) {
- $optgroup = $optgroup.prev('[data-group]');
- } else {
- $optgroup = $optgroup.next('[data-group]');
- }
-
- $options = $optgroup.find('[data-selectable]');
- $option = $options.eq(Math.min($options.length - 1, index));
- if ($option.length) {
- this.setActiveOption($option);
- }
- return;
- }
-
- return original.apply(this, arguments);
- };
- })();
-
- var equalizeSizes = function() {
- var i, n, height_max, width, width_last, width_parent, $optgroups;
-
- $optgroups = $('[data-group]', self.$dropdown_content);
- n = $optgroups.length;
- if (!n || !self.$dropdown_content.width()) return;
-
- if (options.equalizeHeight) {
- height_max = 0;
- for (i = 0; i < n; i++) {
- height_max = Math.max(height_max, $optgroups.eq(i).height());
- }
- $optgroups.css({height: height_max});
- }
-
- if (options.equalizeWidth) {
- width_parent = self.$dropdown_content.innerWidth();
- width = Math.round(width_parent / n);
- $optgroups.css({width: width});
- if (n > 1) {
- width_last = width_parent - width * (n - 1);
- $optgroups.eq(n - 1).css({width: width_last});
- }
- }
- };
-
- if (options.equalizeHeight || options.equalizeWidth) {
- hook.after(this, 'positionDropdown', equalizeSizes);
- hook.after(this, 'refreshOptions', equalizeSizes);
- }
-
-
- });
-
- Selectize.define('remove_button', function(options) {
- if (this.settings.mode === 'single') return;
-
- options = $.extend({
- label : '×',
- title : 'Remove',
- className : 'remove',
- append : true
- }, options);
-
- var self = this;
- var html = '<a href="javascript:void(0)" class="' + options.className + '" tabindex="-1" title="' + escape_html(options.title) + '">' + options.label + '</a>';
-
- /**
- * Appends an element as a child (with raw HTML).
- *
- * @param {string} html_container
- * @param {string} html_element
- * @return {string}
- */
- var append = function(html_container, html_element) {
- var pos = html_container.search(/(<\/[^>]+>\s*)$/);
- return html_container.substring(0, pos) + html_element + html_container.substring(pos);
- };
-
- this.setup = (function() {
- var original = self.setup;
- return function() {
- // override the item rendering method to add the button to each
- if (options.append) {
- var render_item = self.settings.render.item;
- self.settings.render.item = function(data) {
- return append(render_item.apply(this, arguments), html);
- };
- }
-
- original.apply(this, arguments);
-
- // add event listener
- this.$control.on('click', '.' + options.className, function(e) {
- e.preventDefault();
- if (self.isLocked) return;
-
- var $item = $(e.target).parent();
- self.setActiveItem($item);
- if (self.deleteSelection()) {
- self.setCaret(self.items.length);
- }
- });
-
- };
- })();
-
- });
-
- Selectize.define('restore_on_backspace', function(options) {
- var self = this;
-
- options.text = options.text || function(option) {
- return option[this.settings.labelField];
- };
-
- this.onKeyDown = (function(e) {
- var original = self.onKeyDown;
- return function(e) {
- var index, option;
- if (e.keyCode === KEY_BACKSPACE && this.$control_input.val() === '' && !this.$activeItems.length) {
- index = this.caretPos - 1;
- if (index >= 0 && index < this.items.length) {
- option = this.options[this.items[index]];
- if (this.deleteSelection(e)) {
- this.setTextboxValue(options.text.apply(this, [option]));
- this.refreshOptions(true);
- }
- e.preventDefault();
- return;
- }
- }
- return original.apply(this, arguments);
- };
- })();
- });
- return Selectize;
- }));
|