* jquery.suggest 1.1b - 2007-08-06
* Patched by Mark Jaquith with Alexander Dick's "multiple items" patch to allow for auto-suggesting of more than one tag before submitting
* See: http://www.vulgarisoip.com/2007/06/29/jquerysuggest-an-alternative-jquery-based-autocomplete-library/#comment-7228
* Uses code and techniques from following libraries:
* 1. http://www.dyve.net/jquery/?autocomplete
* 2. http://dev.jquery.com/browser/trunk/plugins/interface/iautocompleter.js
* All the new stuff written by Peter Vulgaris (www.vulgarisoip.com)
* Feel free to do whatever you want with this file
$.suggest = function(input, options) {
var $input, $results, timeout, prevLength, cache, cacheSize;
$input = $(input).attr("autocomplete", "off");
timeout = false; // hold timeout ID for suggestion results to appear
prevLength = 0; // last recorded length of $input.val()
cache = []; // cache MRU list
cacheSize = 0; // size of cache in chars (bytes?)
$results.addClass(options.resultsClass).appendTo('body');
.on( 'load', resetPosition ) // just in case user is changing size of page while loading
.on( 'resize', resetPosition );
setTimeout(function() { $results.hide() }, 200);
$input.keydown(processKey);
function resetPosition() {
// requires jquery.dimension plugin
var offset = $input.offset();
top: (offset.top + input.offsetHeight) + 'px',
// handling up/down/escape requires results to be visible
// handling enter/tab requires that AND a result to be selected
if ((/27$|38$|40$/.test(e.keyCode) && $results.is(':visible')) ||
(/^13$|^9$/.test(e.keyCode) && getCurrentResult())) {
} else if ($input.val().length != prevLength) {
timeout = setTimeout(suggest, options.delay);
prevLength = $input.val().length;
var q = $.trim($input.val()), multipleSepPos, items;
if ( options.multiple ) {
multipleSepPos = q.lastIndexOf(options.multipleSep);
if ( multipleSepPos != -1 ) {
q = $.trim(q.substr(multipleSepPos + options.multipleSep.length));
if (q.length >= options.minchars) {
displayItems(cached['items']);
$.get(options.source, {q: q}, function(txt) {
items = parseTxt(txt, q);
addToCache(q, items, txt.length);
for (i = 0; i < cache.length; i++)
if (cache[i]['q'] == q) {
cache.unshift(cache.splice(i, 1)[0]);
function addToCache(q, items, size) {
while (cache.length && (cacheSize + size > options.maxCacheSize)) {
cacheSize -= cached['size'];
function displayItems(items) {
resetPosition(); // when the form moves after the page has loaded
for (i = 0; i < items.length; i++)
html += '<li>' + items[i] + '</li>';
$results.html(html).show();
$results.children('li').removeClass(options.selectClass);
$(this).addClass(options.selectClass);
function parseTxt(txt, q) {
var items = [], tokens = txt.split(options.delimiter), i, token;
// parse returned data for non-empty items
for (i = 0; i < tokens.length; i++) {
token = $.trim(tokens[i]);
function(q) { return '<span class="' + options.matchClass + '">' + q + '</span>' }
items[items.length] = token;
function getCurrentResult() {
if (!$results.is(':visible'))
$currentResult = $results.children('li.' + options.selectClass);
if (!$currentResult.length)
function selectCurrentResult() {
$currentResult = getCurrentResult();
if ( options.multiple ) {
if ( $input.val().indexOf(options.multipleSep) != -1 ) {
$currentVal = $input.val().substr( 0, ( $input.val().lastIndexOf(options.multipleSep) + options.multipleSep.length ) ) + ' ';
$input.val( $currentVal + $currentResult.text() + options.multipleSep + ' ' );
$input.val($currentResult.text());
$input.trigger('change');
options.onSelect.apply($input[0]);
$currentResult = getCurrentResult();
.removeClass(options.selectClass)
.addClass(options.selectClass);
$results.children('li:first-child').addClass(options.selectClass);
var $currentResult = getCurrentResult();
.removeClass(options.selectClass)
.addClass(options.selectClass);
$results.children('li:last-child').addClass(options.selectClass);
$.fn.suggest = function(source, options) {
options.multiple = options.multiple || false;
options.multipleSep = options.multipleSep || ",";
options.delay = options.delay || 100;
options.resultsClass = options.resultsClass || 'ac_results';
options.selectClass = options.selectClass || 'ac_over';
options.matchClass = options.matchClass || 'ac_match';
options.minchars = options.minchars || 2;
options.delimiter = options.delimiter || '\n';
options.onSelect = options.onSelect || false;
options.maxCacheSize = options.maxCacheSize || 65536;
new $.suggest(this, options);