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
|
/**
* jQuery TextExt Plugin
* http://textextjs.com
*
* @version 1.3.1
* @copyright Copyright (C) 2011 Alex Gorbatchev. All rights reserved.
* @license MIT License
*/
(function($)
{
/**
* Suggestions plugin allows to easily specify the list of suggestion items that the
* Autocomplete plugin would present to the user.
*
* @author agorbatchev
* @date 2011/08/18
* @id TextExtSuggestions
*/
function TextExtSuggestions() {};
$.fn.textext.TextExtSuggestions = TextExtSuggestions;
$.fn.textext.addPlugin('suggestions', TextExtSuggestions);
var p = TextExtSuggestions.prototype,
/**
* Suggestions plugin only has one option and that is to set suggestion items. It could be
* changed when passed to the `$().textext()` function. For example:
*
* $('textarea').textext({
* plugins: 'suggestions',
* suggestions: [ "item1", "item2" ]
* })
*
* @author agorbatchev
* @date 2011/08/18
* @id TextExtSuggestions.options
*/
/**
* List of items that Autocomplete plugin would display in the dropdown.
*
* @name suggestions
* @default null
* @author agorbatchev
* @date 2011/08/18
* @id TextExtSuggestions.options.suggestions
*/
OPT_SUGGESTIONS = 'suggestions',
/**
* Suggestions plugin dispatches or reacts to the following events.
*
* @author agorbatchev
* @date 2011/08/17
* @id TextExtSuggestions.events
*/
/**
* Suggestions plugin reacts to the `getSuggestions` event and returns `suggestions` items
* from the options.
*
* @name getSuggestions
* @author agorbatchev
* @date 2011/08/19
* @id TextExtSuggestions.events.getSuggestions
*/
/**
* Suggestions plugin triggers the `setSuggestions` event to pass its own list of `Suggestions`
* to the Autocomplete plugin.
*
* @name setSuggestions
* @author agorbatchev
* @date 2011/08/19
* @id TextExtSuggestions.events.setSuggestions
*/
/**
* Suggestions plugin reacts to the `postInit` event to pass its list of `suggestions` to the
* Autocomplete right away.
*
* @name postInit
* @author agorbatchev
* @date 2011/08/19
* @id TextExtSuggestions.events.postInit
*/
DEFAULT_OPTS = {
suggestions : null
}
;
/**
* Initialization method called by the core during plugin instantiation.
*
* @signature TextExtSuggestions.init(core)
*
* @param core {TextExt} Instance of the TextExt core class.
*
* @author agorbatchev
* @date 2011/08/18
* @id TextExtSuggestions.init
*/
p.init = function(core)
{
var self = this;
self.baseInit(core, DEFAULT_OPTS);
self.on({
getSuggestions : self.onGetSuggestions,
postInit : self.onPostInit
});
};
/**
* Triggers `setSuggestions` and passes supplied suggestions to the Autocomplete plugin.
*
* @signature TextExtSuggestions.setSuggestions(suggestions, showHideDropdown)
*
* @param suggestions {Array} List of suggestions. With the default `ItemManager` it should
* be a list of strings.
* @param showHideDropdown {Boolean} If it's undesirable to show the dropdown right after
* suggestions are set, `false` should be passed for this argument.
*
* @author agorbatchev
* @date 2011/08/19
* @id TextExtSuggestions.setSuggestions
*/
p.setSuggestions = function(suggestions, showHideDropdown)
{
this.trigger('setSuggestions', { result : suggestions, showHideDropdown : showHideDropdown != false });
};
/**
* Reacts to the `postInit` event and triggers `setSuggestions` event to set suggestions list
* right after initialization.
*
* @signature TextExtSuggestions.onPostInit(e)
*
* @param e {Object} jQuery event.
*
* @author agorbatchev
* @date 2011/08/19
* @id TextExtSuggestions.onPostInit
*/
p.onPostInit = function(e)
{
var self = this;
self.setSuggestions(self.opts(OPT_SUGGESTIONS), false);
};
/**
* Reacts to the `getSuggestions` event and triggers `setSuggestions` event with the list
* of `suggestions` specified in the options.
*
* @signature TextExtSuggestions.onGetSuggestions(e, data)
*
* @param e {Object} jQuery event.
* @param data {Object} Payload from the `getSuggestions` event with the user query, eg `{ query: {String} }`.
*
* @author agorbatchev
* @date 2011/08/19
* @id TextExtSuggestions.onGetSuggestions
*/
p.onGetSuggestions = function(e, data)
{
var self = this,
suggestions = self.opts(OPT_SUGGESTIONS)
;
suggestions.sort();
self.setSuggestions(self.itemManager().filter(suggestions, data.query));
};
})(jQuery);
|
