-
Notifications
You must be signed in to change notification settings - Fork 116
/
demo.html
317 lines (296 loc) · 19.6 KB
/
demo.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
<!DOCTYPE html><html lang="en">
<head>
<meta charset="utf-8">
<title>jQuery autoComplete Plugin</title>
<meta name="description" content="A lightweight autocomplete plugin for jQuery.">
<link rel="shortcut icon" href="https://pixabay.com/favicon.ico">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:300">
<link rel="stylesheet" href="https://cdn.rawgit.com/yahoo/pure-release/v0.6.0/pure-min.css">
<style>
body { margin: 0; padding: 0; border: 0; min-width: 320px; color: #777; }
html, button, input, select, textarea, .pure-g [class *= "pure-u"] { font-family: "Helvetica Neue", Helvetica, Arial, sans-serif; font-size: 1.02em; }
p, td { line-height: 1.5; }
ul { padding: 0 0 0 20px; }
th { background: #eee; white-space: nowrap; }
th, td { padding: 10px; text-align: left; vertical-align: top; font-size: .9em; font-weight: normal; border-right: 1px solid #fff; }
td:first-child { white-space: nowrap; color: #008000; width: 1%; font-style: italic; }
h1, h2, h3 { color: #4b4b4b; font-family: "Source Sans Pro", sans-serif; font-weight: 300; margin: 0 0 1.2em; }
h1 { font-size: 4.5em; color: #1f8dd6; margin: 0 0 .4em; }
h2 { font-size: 2em; color: #636363; }
h3 { font-size: 1.8em; color: #4b4b4b; margin: 1.8em 0 .8em }
h4 { font: bold 1em sans-serif; color: #636363; margin: 4em 0 1em; }
a { color: #4e99c7; text-decoration: none; }
a:hover { text-decoration: underline; }
p, pre { margin: 0 0 1.2em; }
::selection { color: #fff; background: #328efd; }
::-moz-selection { color: #fff; background: #328efd; }
@media (max-width:480px) {
h1 { font-size: 3em; }
h2 { font-size: 1.8em; }
h3 { font-size: 1.5em; }
td:first-child { white-space: normal; }
}
.inline-code { padding: 1px 5px; background: #eee; border-radius: 2px; }
pre { padding: 15px 10px; font-size: .9em; color: #555; background: #edf3f8; }
pre i { color: #aaa; } /* comments */
pre b { font-weight: normal; color: #cf4b25; } /* strings */
pre em { color: #0c59e9; } /* numeric */
/* Pure CSS */
.pure-button { margin: 5px 0; text-decoration: none !important; }
.button-lg { margin: 5px 0; padding: .65em 1.6em; font-size: 105%; }
input[type="text"] { border-radius: 0 !important; }
</style>
<link rel="stylesheet" href="jquery.auto-complete.css">
</head>
<body>
<div style="max-width:900px;padding:0 10px;margin:40px auto;text-align:center">
<h1>autoComplete</h1>
<h2>An extremely lightweight completion suggester plugin for jQuery.</h2>
<a style="margin:5px 0" href="https://github.com/Pixabay/jQuery-autoComplete/archive/master.zip" class="pure-button pure-button-primary button-lg">Download</a>
<a style="margin:5px 0" href="https://github.com/Pixabay/jQuery-autoComplete" class="pure-button button-lg">View on GitHub</a>
</div>
<form onsubmit="$('#hero-demo').blur();return false;" class="pure-form" style="border-top: 1px solid #eee;border-bottom:1px solid #eee;background:#fafafa;margin:30px 0;padding:20px 10px;text-align:center">
<input id="hero-demo" autofocus type="text" name="q" placeholder="Programming languages ..." style="width:100%;max-width:600px;outline:0">
</form>
<div style="max-width:900px;margin:auto;padding:0 10px 50px">
<h3>Overview and Features</h3>
<p>
Released under the <a href="http://www.opensource.org/licenses/mit-license.php">MIT License</a>.
Source on <a href="https://github.com/Pixabay/jQuery-autoComplete">Github</a> (<a href="https://github.com/Pixabay/jQuery-autoComplete#changelog">changelog</a>).
Compatible with jQuery 1.7.0+ in Firefox, Safari, Chrome, Opera, Internet Explorer 7+. No dependencies except the jQuery library.
</p>
<ul>
<li>Lightweight: 3.4 kB of JavaScript - less than 1.4 kB gzipped</li>
<li>Fully flexible data source</li>
<li>Smart caching, delay and minimum character settings</li>
<li>Callbacks</li>
</ul>
<p>
This plugin was developed by and for <a href="https://pixabay.com/">Pixabay.com</a> - an international repository for free Public Domain images.
We have implemented this piece of software in production and we share it - in the spirit of Pixabay - freely with others.
</p>
<h3>Why another jQuery autocomplete plugin?</h3>
<p>
This plugin is largely based on DevBridge's wonderful <a href="https://github.com/devbridge/jQuery-Autocomplete">Ajax AutoComplete</a>.
We used this autocompleter for several weeks on Pixabay and it worked nicely.
However, we ended up hacking more and more into the original code - changing keyboard navigation and AJAX requests.
Finally, we decided to go for an own, ultra lightweight plugin code that is perfectly optimized for our needs. And here we are ...
</p>
<h3>Usage</h3>
<p>
Include the stylesheet <span class="inline-code">jquery.auto-complete.css</span> in the <span class="inline-code"><head></span> section of your page - and the JavaScript file <span class="inline-code">jquery.auto-complete.min.js</span> after loading the jQuery library.
autoComplete accepts settings from an object of key/value pairs, and can be assigned to any text input field.
</p>
<pre>
$(selector).autoComplete({key1: value1, key2: value2});
</pre>
<h3>Settings</h3>
<table>
<tr><th>Property</th><th>Default</th><th>Description</th></tr>
<tr><td>source(term, response)</td><td><i>null</i></td><td>
Required callback function to connect any data source to autoComplete. The callback gets two arguments:
<ul>
<li><span class="inline-code">term</span>, which refers to the value currently in the text input.</li>
<li>A <span class="inline-code">response</span> callback, which expects a single argument:
the data to suggest to the user. This data must be an array of filtered suggestions based on the provided term:
<br>['suggestion 1', 'suggestion 2', 'suggestion 3', ...]
</li>
</ul>
</td></tr>
<tr><td>minChars</td><td>3</td><td>Minimum number of characters (>=1) a user must type before a search is performed.</td></tr>
<tr><td>delay</td><td>150</td><td>The delay in milliseconds between when a keystroke occurs and when a search is performed. A zero-delay is more responsive, but can produce a lot of load.</td></tr>
<tr><td>cache</td><td><i>true</i></td><td>Determines if performed searches should be cached.</td></tr>
<tr>
<td>menuClass</td><td><i>''</i></td>
<td>Custom class/es that get/s added to the dropdown menu container.
<br>Example: <span class="inline-code">{ menuClass: 'class1 class2' }</span></td>
</tr>
<tr>
<td>renderItem</td><td><i>function</i></td>
<td>
<p>A function that gives you control over how suggestions are displayed. Default:</p>
<pre>
function (item, search){
search = search.replace(<b>/[-\/\\^$*+?.()|[\]{}]/</b>g, <b>'\\$&'</b>);
var re = new RegExp("(" + search.split(' ').join('|') + ")", "gi");
return '<div class="autocomplete-suggestion" data-val="' + item + '">'\
+ item.replace(re, "<b>$1</b>") + '</div>';
}
</pre>
</td>
</tr>
<tr><td colspan="3"> </td></tr>
<tr><th>Callbacks</th><th colspan="2"></th></tr>
<tr><td>onSelect(event, term, item)</td><td colspan="2">
A callback function that fires when a suggestion is selected by mouse click, enter, or tab.
<span class="inline-code">event</span> is the event that triggered the callback,
<span class="inline-code">term</span> is the selected value.
and <span class="inline-code">item</span> is the item rendered by the renderItem function.
</td></tr>
<tr><td colspan="3"> </td></tr>
<tr><th>Public Methods</th><th colspan="2"></th></tr>
<tr><td>destroy</td><td colspan="2">Removes the autoComplete instance and its bindings.</td></tr>
</table>
<h3 style="margin-top:.8em;border-top:1px solid #eee;padding-top:1.8em">Demos</h3>
<h4 style="margin-top:.5em">Searching in local data</h4>
<p>
This plugin was designed mainly with AJAX requests in mind, but it may be used with local data, as well.
Connecting the autocompletion suggester to an array of strings can be done in the source function like so:
</p>
<pre>
$(<b>'input[name="q"]'</b>).autoComplete({
minChars: 2,
source: function(term, suggest){
term = term.toLowerCase();
var choices = [<b>'ActionScript'</b>, <b>'AppleScript'</b>, <b>'Asp'</b>, <i>...</i>];
var matches = [];
for (i=0; i<choices.length; i++)
if (~choices[i].toLowerCase().indexOf(term)) matches.push(choices[i]);
suggest(matches);
}
});</pre>
<p>
The source function iterates through an array of (local) choices and we return a new array containing all (lowercased) matches.
Simple as that.
</p>
<h4>AJAX requests</h4>
<p>
AJAX requests may come with very different requirements: JSON, JSONP, GET, POST, additionaly params, authentications, etc.
In order to keep the source code small while retaining full flexibility, we decided to only use a simple callback function as the source for suggestions.
Make your AJAX call inside this function and return matching suggestions with the response callback:
</p>
<pre>
$(<b>'input[name="q"]'</b>).autoComplete({
source: function(term, response){
$.getJSON(<b>'/some/ajax/url/'</b>, { q: term }, function(data){ response(data); });
}
});</pre>
<p>
The AJAX call in this example needs to return an array of strings.
The callback <span class="inline-code">response</span> must always be called, even if no suggestions are returned or if an error occured.
This ensures the correct state of the autoComplete instance.
</p>
<h4>Optimizing AJAX requests</h4>
<p>
All search results are cached by default and unnecessary requests are prevented in order to keep server load as low as possible.
To further reduce server impact, it's possible to abort unfinished AJAX requests before starting new ones:
</p>
<pre>
var xhr;
$(<b>'input[name="q"]'</b>).autoComplete({
source: function(term, response){
try { xhr.abort(); } catch(e){}
xhr = $.getJSON(<b>'/some/ajax/url/'</b>, { q: term }, function(data){ response(data); });
}
});</pre>
<p>
By typing along, the user may trigger one AJAX request after the other.
With this little trick, we make sure that only the most current one actually gets executed - if not done so already.
</p>
<h4>Advanced suggestions handling and custom layout</h4>
<p>
By making use of the <span class="inline-code">renderItem()</span> function, it's possible to turn the autocompleter into an item suggester:
</p>
<form onsubmit="$('#advanced-demo').blur();return false;" class="pure-form" style="margin:30px 0 40px">
<input id="advanced-demo" autofocus type="text" name="q" placeholder="Country or language code ..." style="width:100%;max-width:600px;outline:0">
</form>
<p>
While typing country names or language codes, a list of matching suggestions is displayed. E.g. typing "de" will show "Germany" as a suggestion, because "de" is the language code for German.
Source code for this example:
</p>
<pre>
$(<b>'input[name="q"]'</b>).autoComplete({
minChars: 1,
source: function(term, suggest){
term = term.toLowerCase();
var choices = [[<b>'Australia'</b>, <b>'au'</b>], [<b>'Austria'</b>, <b>'at'</b>], [<b>'Brasil'</b>, <b>'br'</b>], ...];
var suggestions = [];
for (i=0;i<choices.length;i++)
if (~(choices[i][0]+<b>' '</b>+choices[i][1]).toLowerCase().indexOf(term)) suggestions.push(choices[i]);
suggest(suggestions);
},
renderItem: function (item, search){
search = search.replace(<b>/[-\/\\^$*+?.()|[\]{}]/</b>g, <b>'\\$&'</b>);
var re = new RegExp(<b>"("</b> + search.split(<b>' '</b>).join(<b>'|'</b>) + <b>")"</b>, <b>"gi"</b>);
return <b>'<div class="autocomplete-suggestion" data-langname="'</b>+item[0]+<b>'" data-lang="'</b>+item[1]+<b>'" data-val="'</b>+search+<b>'"><img src="img/'</b>+item[1]+<b>'.png"> '</b>+item[0].replace(re, <b>"<b>$1</b>"</b>)+<b>'</div>'</b>;
},
onSelect: function(e, term, item){
alert(<b>'Item "'</b>+item.data(<b>'langname'</b>)+<b>' ('</b>+item.data(<b>'lang'</b>)+<b>')" selected by '</b>+(e.type == <b>'keydown'</b> ? <b>'pressing enter'</b> : <b>'mouse click'</b>)+<b>'.'</b>);
}
});</pre>
<p>
In this case, autocompleting the text field is not desired, so we turn it off by setting <span class="inline-code">data-val="'+search+'"</span> in the <span class="inline-code">renderItem()</span> function.
However, when choosing an item, the <span class="inline-code">onSelect()</span> callback returns all required information.
</p>
<div style="margin:60px 0 40px;overflow:hidden;border-top:1px solid #eee;padding-top:40px">
<span id="github_social"></span>
<div style="float:left;margin-right:35px">
<a href="#" data-width="70" class="twitter-share-button" data-text="jQuery autoComplete Plugin"></a>
</div>
<div style="float:left">
<div class="g-plusone" data-size="medium"></div>
</div>
<div style="float:left;width:140px" class="fb-like" data-send="false" data-layout="button_count" data-width="140" data-show-faces="false"></div>
</div>
<p>Please report any bugs and issues at the <a href="https://github.com/Pixabay/jQuery-autoComplete">GitHub repositiory</a>.</p>
<p>This software is released as Open Source under the <a href="http://www.opensource.org/licenses/mit-license.php">MIT License</a> by <a href="https://pixabay.com/users/Simon/">Simon Steinberger / Pixabay.com</a>.</p>
</div>
<div style="background:#fafafa;border-top:1px solid #eee;padding:15px;font-size:.9em">
<div style="max-width:900px;margin:auto;padding:0 10px">
<a style="float:right;margin-left:20px" href="https://pixabay.com/en/service/about/">About Us</a>
<a style="float:right;margin-left:20px" href="https://pixabay.com/en/blog/">Blog</a>
<a style="float:right;margin-left:20px" href="https://goodies.pixabay.com/">More Goodies</a>
© <a href="https://pixabay.com/">Pixabay.com</a> / Simon Steinberger / Hans Braxmeier
</div>
</div>
<div id="fb-root"></div>
<script src="https://code.jquery.com/jquery-1.11.1.min.js"></script>
<script src="jquery.auto-complete.js"></script>
<script>
$(function(){
$('#hero-demo').autoComplete({
minChars: 1,
source: function(term, suggest){
term = term.toLowerCase();
var choices = ['ActionScript', 'AppleScript', 'Asp', 'Assembly', 'BASIC', 'Batch', 'C', 'C++', 'CSS', 'Clojure', 'COBOL', 'ColdFusion', 'Erlang', 'Fortran', 'Groovy', 'Haskell', 'HTML', 'Java', 'JavaScript', 'Lisp', 'Perl', 'PHP', 'PowerShell', 'Python', 'Ruby', 'Scala', 'Scheme', 'SQL', 'TeX', 'XML'];
var suggestions = [];
for (i=0;i<choices.length;i++)
if (~choices[i].toLowerCase().indexOf(term)) suggestions.push(choices[i]);
suggest(suggestions);
}
});
$('#advanced-demo').autoComplete({
minChars: 0,
source: function(term, suggest){
term = term.toLowerCase();
var choices = [['Australia', 'au'], ['Austria', 'at'], ['Brasil', 'br'], ['Bulgaria', 'bg'], ['Canada', 'ca'], ['China', 'cn'], ['Czech Republic', 'cz'], ['Denmark', 'dk'], ['Finland', 'fi'], ['France', 'fr'], ['Germany', 'de'], ['Hungary', 'hu'], ['India', 'in'], ['Italy', 'it'], ['Japan', 'ja'], ['Netherlands', 'nl'], ['Norway', 'no'], ['Portugal', 'pt'], ['Romania', 'ro'], ['Russia', 'ru'], ['Spain', 'es'], ['Swiss', 'ch'], ['Turkey', 'tr'], ['USA', 'us']];
var suggestions = [];
for (i=0;i<choices.length;i++)
if (~(choices[i][0]+' '+choices[i][1]).toLowerCase().indexOf(term)) suggestions.push(choices[i]);
suggest(suggestions);
},
renderItem: function (item, search){
search = search.replace(/[-\/\\^$*+?.()|[\]{}]/g, '\\$&');
var re = new RegExp("(" + search.split(' ').join('|') + ")", "gi");
return '<div class="autocomplete-suggestion" data-langname="'+item[0]+'" data-lang="'+item[1]+'" data-val="'+search+'"><img src="img/'+item[1]+'.png"> '+item[0].replace(re, "<b>$1</b>")+'</div>';
},
onSelect: function(e, term, item){
console.log('Item "'+item.data('langname')+' ('+item.data('lang')+')" selected by '+(e.type == 'keydown' ? 'pressing enter or tab' : 'mouse click')+'.');
$('#advanced-demo').val(item.data('langname')+' ('+item.data('lang')+')');
}
});
});
if (~window.location.href.indexOf('http')) {
(function() {var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true;po.src = 'https://apis.google.com/js/plusone.js';var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s);})();
(function(d, s, id) {var js, fjs = d.getElementsByTagName(s)[0];if (d.getElementById(id)) return;js = d.createElement(s); js.id = id;js.src = "//connect.facebook.net/en_US/sdk.js#xfbml=1&version=v2.4&appId=114593902037957";fjs.parentNode.insertBefore(js, fjs);}(document, 'script', 'facebook-jssdk'));
!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');
$('#github_social').html('\
<iframe style="float:left;margin-right:15px" src="//ghbtns.com/github-btn.html?user=Pixabay&repo=jQuery-autoComplete&type=watch&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="110" height="20"></iframe>\
<iframe style="float:left;margin-right:15px" src="//ghbtns.com/github-btn.html?user=Pixabay&repo=jQuery-autoComplete&type=fork&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="110" height="20"></iframe>\
');
}
</script>
</body>
</html>