Merge pull request #3338 from erming/master

Updated tabcomplete
This commit is contained in:
Thomas Davis
2014-06-04 21:24:38 +10:00
3 changed files with 268 additions and 1 deletions
+257
View File
@@ -0,0 +1,257 @@
/*!
* tabcomplete
* Lightweight tab completion for inputs and textareas
*
* Source:
* https://github.com/erming/tabcomplete
*
* Copyright (c) 2014 Mattias Erming <mattias@mattiaserming.com>
* Licensed under the MIT License.
*
* Version 1.3.1
*/
(function($) {
var keys = {
backspace: 8,
tab: 9,
up: 38,
down: 40
};
$.fn.tab = // Alias
$.fn.tabcomplete = function(args, options) {
if (this.length > 1) {
return this.each(function() {
$(this).tabcomplete(args, options);
});
}
// Only enable the plugin on <input> and <textarea> elements.
var tag = this.prop("tagName");
if (tag != "INPUT" && tag != "TEXTAREA") {
return;
}
// Set default options.
options = $.extend({
after: "",
arrowKeys: false,
caseSensitive: false,
hint: "placeholder",
minLength: 1
}, options);
// Remove any leftovers.
// This allows us to override the plugin if necessary.
this.unbind(".tabcomplete");
this.prev(".hint").remove();
var self = this;
var backspace = false;
var i = -1;
var words = [];
var last = "";
var hint = $.noop;
// Determine what type of hinting to use.
switch (options.hint) {
case "placeholder":
hint = placeholder;
break;
case "select":
hint = select;
break;
}
this.on("input.tabcomplete", function() {
var input = self.val();
var word = input.split(/ |\n/).pop();
// Reset iteration.
i = -1;
last = "";
words = [];
// Check for matches if the current word is the last word.
if (self[0].selectionStart == input.length
&& word.length) {
if (typeof args === "function") {
// If the user supplies a function, invoke it
// and keep the result.
words = args(word);
} else {
// Otherwise, call the .match() function.
words = match(word, args, options.caseSensitive);
}
// Append 'after' to each word.
if (options.after) {
words = $.map(words, function(w) { return w + options.after; });
}
}
// Emit the number of matching words with the 'match' event.
self.trigger("match", words.length);
if (options.hint) {
if (!(options.hint == "select" && backspace) && word.length >= options.minLength) {
// Show hint.
hint.call(self, words[0]);
} else {
// Clear hinting.
// This call is needed when using backspace.
hint.call(self, "");
}
}
if (backspace) {
backspace = false;
}
});
this.on("keydown.tabcomplete", function(e) {
var key = e.which;
if (key == keys.tab
|| (options.arrowKeys && (key == keys.up || key == keys.down))) {
// Don't lose focus on tab click.
e.preventDefault();
// Iterate the matches with tab and the up and down keys by incrementing
// or decrementing the 'i' variable.
if (key != keys.up) {
i++;
} else {
if (i == -1) return;
if (i == 0) {
// Jump to the last word.
i = words.length - 1;
} else {
i--;
}
}
// Get next match.
var word = words[i % words.length];
if (!word) {
return;
}
var value = self.val();
last = last || value.split(/ |\n/).pop();
// Return if the 'minLength' requirement isn't met.
if (last.length < options.minLength) {
return;
}
// Update element with the completed text.
var text = value.substr(0, self[0].selectionStart - last.length) + word;
self.val(text);
// Put the cursor at the end after completion.
// This isn't strictly necessary, but solves an issue with
// Internet Explorer.
if (options.hint == "select") {
self[0].selectionStart = text.length;
}
// Remember the word until next time.
last = word;
// Emit event.
self.trigger("tabcomplete", last);
if (options.hint) {
// Turn off any additional hinting.
hint.call(self, "");
}
} else if (e.which == keys.backspace) {
// Remember that backspace was pressed. This is used
// by the 'input' event.
backspace = true;
// Reset iteration.
i = -1;
last = "";
}
});
if (options.hint) {
// If enabled, turn on hinting.
hint.call(this, "");
}
return this;
}
// Simple matching.
// Filter the array and return the items that begins with 'word'.
function match(word, array, caseSensitive) {
return $.grep(
array,
function(w) {
if (caseSensitive) {
return !w.indexOf(word);
} else {
return !w.toLowerCase().indexOf(word.toLowerCase());
}
}
);
}
// Show placeholder text.
// This works by creating a copy of the input and placing it behind
// the real input.
function placeholder(word) {
var input = this;
var clone = input.prev(".hint");
input.css({
backgroundColor: "transparent",
position: "relative",
});
// Lets create a clone of the input if it does
// not already exist.
if (!clone.length) {
input.wrap(
$("<div>").css({position: "relative"})
);
clone = input
.clone()
.attr("tabindex", -1)
.removeAttr("id name placeholder")
.addClass("hint")
.insertBefore(input);
clone.css({
position: "absolute",
});
}
var hint = "";
if (typeof word !== "undefined") {
var value = input.val();
hint = value + word.substr(value.split(/ |\n/).pop().length);
}
clone.val(hint);
}
// Hint by selecting part of the suggested word.
function select(word) {
var input = this;
var value = input.val();
if (word) {
input.val(
value
+ word.substr(value.split(/ |\n/).pop().length)
);
// Select hint.
input[0].selectionStart = value.length;
}
}
})(jQuery);
+2
View File
@@ -0,0 +1,2 @@
/*! tabcomplete v1.3.1 */
!function(a){function c(b,c,d){return a.grep(c,function(a){return d?!a.indexOf(b):!a.toLowerCase().indexOf(b.toLowerCase())})}function d(b){var c=this,d=c.prev(".hint");c.css({backgroundColor:"transparent",position:"relative"}),d.length||(c.wrap(a("<div>").css({position:"relative"})),d=c.clone().attr("tabindex",-1).removeAttr("id name placeholder").addClass("hint").insertBefore(c),d.css({position:"absolute"}));var e="";if("undefined"!=typeof b){var f=c.val();e=f+b.substr(f.split(/ |\n/).pop().length)}d.val(e)}function e(a){var b=this,c=b.val();a&&(b.val(c+a.substr(c.split(/ |\n/).pop().length)),b[0].selectionStart=c.length)}var b={backspace:8,tab:9,up:38,down:40};a.fn.tab=a.fn.tabcomplete=function(f,g){if(this.length>1)return this.each(function(){a(this).tabcomplete(f,g)});var h=this.prop("tagName");if("INPUT"==h||"TEXTAREA"==h){g=a.extend({after:"",arrowKeys:!1,caseSensitive:!1,hint:"placeholder",minLength:1},g),this.unbind(".tabcomplete"),this.prev(".hint").remove();var i=this,j=!1,k=-1,l=[],m="",n=a.noop;switch(g.hint){case"placeholder":n=d;break;case"select":n=e}return this.on("input.tabcomplete",function(){var b=i.val(),d=b.split(/ |\n/).pop();k=-1,m="",l=[],i[0].selectionStart==b.length&&d.length&&(l="function"==typeof f?f(d):c(d,f,g.caseSensitive),g.after&&(l=a.map(l,function(a){return a+g.after}))),i.trigger("match",l.length),g.hint&&(("select"!=g.hint||!j)&&d.length>=g.minLength?n.call(i,l[0]):n.call(i,"")),j&&(j=!1)}),this.on("keydown.tabcomplete",function(a){var c=a.which;if(c==b.tab||g.arrowKeys&&(c==b.up||c==b.down)){if(a.preventDefault(),c!=b.up)k++;else{if(-1==k)return;0==k?k=l.length-1:k--}var d=l[k%l.length];if(!d)return;var e=i.val();if(m=m||e.split(/ |\n/).pop(),m.length<g.minLength)return;var f=e.substr(0,i[0].selectionStart-m.length)+d;i.val(f),"select"==g.hint&&(i[0].selectionStart=f.length),m=d,i.trigger("tabcomplete",m),g.hint&&n.call(i,"")}else a.which==b.backspace&&(j=!0,k=-1,m="")}),g.hint&&n.call(this,""),this}}}(jQuery);
+9 -1
View File
@@ -1,12 +1,20 @@
{
"name": "tabcomplete",
"version": "1.3.0",
"version": "1.3.1",
"description": "Lightweight tab completion for inputs and textareas",
"filename": "tabcomplete.js",
"repository": {
"type": "git",
"url": "http://github.com/erming/tabcomplete"
},
"npmName": "tabcomplete",
"npmFileMap": [{
"basePath": "/",
"files": [
"tabcomplete.js",
"tabcomplete.min.js"
]
}],
"homepage": "https://github.com/erming/tabcomplete",
"keywords": [
"tab",