2 * jquery.suggest 1.1 - 2007-08-06
4 * Uses code and techniques from following libraries:
5 * 1. http://www.dyve.net/jquery/?autocomplete
6 * 2. http://dev.jquery.com/browser/trunk/plugins/interface/iautocompleter.js
8 * All the new stuff written by Peter Vulgaris (www.vulgarisoip.com)
9 * Feel free to do whatever you want with this file
15 $.suggest = function(input, options) {
17 var $input = $(input).attr("autocomplete", "off");
18 var $results = $(document.createElement("ul"));
20 var timeout = false; // hold timeout ID for suggestion results to appear
21 var prevLength = 0; // last recorded length of $input.val()
22 var cache = []; // cache MRU list
23 var cacheSize = 0; // size of cache in chars (bytes?)
25 $results.addClass(options.resultsClass).appendTo('body');
30 .load(resetPosition) // just in case user is changing size of page while loading
31 .resize(resetPosition);
33 $input.blur(function() {
34 setTimeout(function() { $results.hide() }, 200);
38 // help IE users if possible
44 // I really hate browser detection, but I don't see any other way
45 if ($.browser.mozilla)
46 $input.keypress(processKey); // onkeypress repeats arrow keys in Mozilla/Opera
48 $input.keydown(processKey); // onkeydown repeats arrow keys in IE/Safari
53 function resetPosition() {
54 // requires jquery.dimension plugin
55 var offset = $input.offset();
57 top: (offset.top + input.offsetHeight) + 'px',
58 left: offset.left + 'px'
63 function processKey(e) {
65 // handling up/down/escape requires results to be visible
66 // handling enter/tab requires that AND a result to be selected
67 if ((/27$|38$|40$/.test(e.keyCode) && $results.is(':visible')) ||
68 (/^13$|^9$/.test(e.keyCode) && getCurrentResult())) {
72 if (e.stopPropagation)
75 e.cancelBubble = true;
76 e.returnValue = false;
90 selectCurrentResult();
99 } else if ($input.val().length != prevLength) {
102 clearTimeout(timeout);
103 timeout = setTimeout(suggest, options.delay);
104 prevLength = $input.val().length;
114 var q = $.trim($input.val());
116 if (q.length >= options.minchars) {
118 cached = checkCache(q);
122 displayItems(cached['items']);
126 $.get(options.source, {q: q}, function(txt) {
130 var items = parseTxt(txt, q);
133 addToCache(q, items, txt.length);
148 function checkCache(q) {
150 for (var i = 0; i < cache.length; i++)
151 if (cache[i]['q'] == q) {
152 cache.unshift(cache.splice(i, 1)[0]);
160 function addToCache(q, items, size) {
162 while (cache.length && (cacheSize + size > options.maxCacheSize)) {
163 var cached = cache.pop();
164 cacheSize -= cached['size'];
177 function displayItems(items) {
187 resetPosition(); // when the form moves after the page has loaded
190 for (var i = 0; i < items.length; i++)
191 html += '<li>' + items[i] + '</li>';
193 $results.html(html).show();
197 .mouseover(function() {
198 $results.children('li').removeClass(options.selectClass);
199 $(this).addClass(options.selectClass);
204 selectCurrentResult();
209 function parseTxt(txt, q) {
212 var tokens = txt.split(options.delimiter);
214 // parse returned data for non-empty items
215 for (var i = 0; i < tokens.length; i++) {
216 var token = $.trim(tokens[i]);
218 token = token.replace(
220 function(q) { return '<span class="' + options.matchClass + '">' + q + '</span>' }
222 items[items.length] = token;
229 function getCurrentResult() {
231 if (!$results.is(':visible'))
234 var $currentResult = $results.children('li.' + options.selectClass);
236 if (!$currentResult.length)
237 $currentResult = false;
239 return $currentResult;
243 function selectCurrentResult() {
245 $currentResult = getCurrentResult();
247 if ($currentResult) {
248 $input.val($currentResult.text());
251 if (options.onSelect)
252 options.onSelect.apply($input[0]);
258 function nextResult() {
260 $currentResult = getCurrentResult();
264 .removeClass(options.selectClass)
266 .addClass(options.selectClass);
268 $results.children('li:first-child').addClass(options.selectClass);
272 function prevResult() {
274 $currentResult = getCurrentResult();
278 .removeClass(options.selectClass)
280 .addClass(options.selectClass);
282 $results.children('li:last-child').addClass(options.selectClass);
288 $.fn.suggest = function(source, options) {
293 options = options || {};
294 options.source = source;
295 options.delay = options.delay || 100;
296 options.resultsClass = options.resultsClass || 'ac_results';
297 options.selectClass = options.selectClass || 'ac_over';
298 options.matchClass = options.matchClass || 'ac_match';
299 options.minchars = options.minchars || 2;
300 options.delimiter = options.delimiter || '\n';
301 options.onSelect = options.onSelect || false;
302 options.maxCacheSize = options.maxCacheSize || 65536;
304 this.each(function() {
305 new $.suggest(this, options);