autosuggest.js 8.98 KB
Newer Older
Ad Schellevis's avatar
Ad Schellevis committed
1 2 3 4 5 6

/**
 * An autosuggest textbox control.
 * @class
 * @scope public
 */
7
function AutoSuggestControl(oTextbox /*:HTMLInputElement*/,
Ad Schellevis's avatar
Ad Schellevis committed
8
                            oProvider /*:SuggestionProvider*/) {
9

Ad Schellevis's avatar
Ad Schellevis committed
10 11 12
    /**
     * The currently selected suggestions.
     * @scope private
13
     */
Ad Schellevis's avatar
Ad Schellevis committed
14 15 16 17 18 19 20
    this.cur /*:int*/ = -1;

    /**
     * The dropdown list layer.
     * @scope private
     */
    this.layer = null;
21

Ad Schellevis's avatar
Ad Schellevis committed
22 23 24 25 26
    /**
     * Suggestion provider for the autosuggest feature.
     * @scope private.
     */
    this.provider /*:SuggestionProvider*/ = oProvider;
27

Ad Schellevis's avatar
Ad Schellevis committed
28 29 30 31 32
    /**
     * The textbox to capture.
     * @scope private
     */
    this.textbox /*:HTMLInputElement*/ = oTextbox;
33

Ad Schellevis's avatar
Ad Schellevis committed
34 35
    //initialize the control
    this.init();
36

Ad Schellevis's avatar
Ad Schellevis committed
37 38 39 40 41 42 43 44 45 46 47
}

/**
 * Autosuggests one or more suggestions for what the user has typed.
 * If no suggestions are passed in, then no autosuggest occurs.
 * @scope private
 * @param aSuggestions An array of suggestion strings.
 * @param bTypeAhead If the control should provide a type ahead suggestion.
 */
AutoSuggestControl.prototype.autosuggest = function (aSuggestions /*:Array*/,
                                                     bTypeAhead /*:boolean*/) {
48

Ad Schellevis's avatar
Ad Schellevis committed
49 50 51 52 53
    //make sure there's at least one suggestion
    if (aSuggestions.length > 0) {
        if (bTypeAhead) {
           this.typeAhead(aSuggestions[0]);
        }
54

Ad Schellevis's avatar
Ad Schellevis committed
55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73
        this.showSuggestions(aSuggestions);
    } else {
        this.hideSuggestions();
    }
};

/**
 * Creates the dropdown layer to display multiple suggestions.
 * @scope private
 */
AutoSuggestControl.prototype.createDropDown = function () {

    var oThis = this;

    //create the layer and assign styles
    this.layer = document.createElement("div");
    this.layer.className = "suggestions";
    this.layer.style.visibility = "hidden";
    this.layer.style.width = this.textbox.offsetWidth;
74

Ad Schellevis's avatar
Ad Schellevis committed
75 76
    //when the user clicks on the a suggestion, get the text (innerHTML)
    //and place it into a textbox
77 78
    this.layer.onmousedown =
    this.layer.onmouseup =
Ad Schellevis's avatar
Ad Schellevis committed
79 80 81 82 83 84 85 86 87 88 89 90 91
    this.layer.onmouseover = function (oEvent) {
        oEvent = oEvent || window.event;
        oTarget = oEvent.target || oEvent.srcElement;

        if (oEvent.type == "mousedown") {
            oThis.textbox.value = oTarget.firstChild.nodeValue;
            oThis.hideSuggestions();
        } else if (oEvent.type == "mouseover") {
            oThis.highlightSuggestion(oTarget);
        } else {
            oThis.textbox.focus();
        }
    };
92 93


Ad Schellevis's avatar
Ad Schellevis committed
94 95 96 97 98 99 100 101 102 103 104 105
    document.body.appendChild(this.layer);
};

/**
 * Gets the left coordinate of the textbox.
 * @scope private
 * @return The left coordinate of the textbox in pixels.
 */
AutoSuggestControl.prototype.getLeft = function () /*:int*/ {

    var oNode = this.textbox;
    var iLeft = 0;
106

Ad Schellevis's avatar
Ad Schellevis committed
107 108
    while(oNode.tagName != "BODY") {
        iLeft += oNode.offsetLeft;
109
        oNode = oNode.offsetParent;
Ad Schellevis's avatar
Ad Schellevis committed
110
    }
111

Ad Schellevis's avatar
Ad Schellevis committed
112 113 114 115 116 117 118 119 120 121 122 123
    return iLeft;
};

/**
 * Gets the top coordinate of the textbox.
 * @scope private
 * @return The top coordinate of the textbox in pixels.
 */
AutoSuggestControl.prototype.getTop = function () /*:int*/ {

    var oNode = this.textbox;
    var iTop = 0;
124

Ad Schellevis's avatar
Ad Schellevis committed
125 126 127 128
    while(oNode.tagName != "BODY") {
        iTop += oNode.offsetTop;
        oNode = oNode.offsetParent;
    }
129

Ad Schellevis's avatar
Ad Schellevis committed
130 131 132 133 134 135 136 137 138 139 140 141 142 143
    return iTop;
};

/**
 * Handles three keydown events.
 * @scope private
 * @param oEvent The event object for the keydown event.
 */
AutoSuggestControl.prototype.handleKeyDown = function (oEvent /*:Event*/) {

    switch(oEvent.keyCode) {
        case 38: //up arrow
            this.previousSuggestion();
            break;
144
        case 40: //down arrow
Ad Schellevis's avatar
Ad Schellevis committed
145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165
            this.nextSuggestion();
            break;
        case 13: //enter
            this.hideSuggestions();
            break;
    }

};

/**
 * Handles keyup events.
 * @scope private
 * @param oEvent The event object for the keyup event.
 */
AutoSuggestControl.prototype.handleKeyUp = function (oEvent /*:Event*/) {

    var iKeyCode = oEvent.keyCode;

    //for backspace (8) and delete (46), shows suggestions without typeahead
    if (iKeyCode == 8 || iKeyCode == 46) {
        this.provider.requestSuggestions(this, false);
166

Ad Schellevis's avatar
Ad Schellevis committed
167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189
    //make sure not to interfere with non-character keys
    } else if (iKeyCode < 32 || (iKeyCode >= 33 && iKeyCode < 46) || (iKeyCode >= 112 && iKeyCode <= 123)) {
        //ignore
    } else {
        //request suggestions from the suggestion provider with typeahead
        this.provider.requestSuggestions(this, true);
    }
};

/**
 * Hides the suggestion dropdown.
 * @scope private
 */
AutoSuggestControl.prototype.hideSuggestions = function () {
    this.layer.style.visibility = "hidden";
};

/**
 * Highlights the given node in the suggestions dropdown.
 * @scope private
 * @param oSuggestionNode The node representing a suggestion in the dropdown.
 */
AutoSuggestControl.prototype.highlightSuggestion = function (oSuggestionNode) {
190

Ad Schellevis's avatar
Ad Schellevis committed
191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209
    for (var i=0; i < this.layer.childNodes.length; i++) {
        var oNode = this.layer.childNodes[i];
        if (oNode == oSuggestionNode) {
            oNode.className = "current";
        } else if (oNode.className == "current") {
            oNode.className = "";
        }
    }
};

/**
 * Initializes the textbox with event handlers for
 * auto suggest functionality.
 * @scope private
 */
AutoSuggestControl.prototype.init = function () {

    //save a reference to this object
    var oThis = this;
210

Ad Schellevis's avatar
Ad Schellevis committed
211 212
    //assign the onkeyup event handler
    this.textbox.onkeyup = function (oEvent) {
213

Ad Schellevis's avatar
Ad Schellevis committed
214 215 216
        //check for the proper location of the event object
        if (!oEvent) {
            oEvent = window.event;
217 218
        }

Ad Schellevis's avatar
Ad Schellevis committed
219 220 221
        //call the handleKeyUp() method with the event object
        oThis.handleKeyUp(oEvent);
    };
222

Ad Schellevis's avatar
Ad Schellevis committed
223 224
    //assign onkeydown event handler
    this.textbox.onkeydown = function (oEvent) {
225

Ad Schellevis's avatar
Ad Schellevis committed
226 227 228
        //check for the proper location of the event object
        if (!oEvent) {
            oEvent = window.event;
229 230
        }

Ad Schellevis's avatar
Ad Schellevis committed
231 232 233
        //call the handleKeyDown() method with the event object
        oThis.handleKeyDown(oEvent);
    };
234 235

    //assign onblur event handler (hides suggestions)
Ad Schellevis's avatar
Ad Schellevis committed
236 237 238
    this.textbox.onblur = function () {
        oThis.hideSuggestions();
    };
239

Ad Schellevis's avatar
Ad Schellevis committed
240 241 242 243 244 245 246 247 248 249 250 251 252 253 254
    //create the suggestions dropdown
    this.createDropDown();
};

/**
 * Highlights the next suggestion in the dropdown and
 * places the suggestion into the textbox.
 * @scope private
 */
AutoSuggestControl.prototype.nextSuggestion = function () {
    var cSuggestionNodes = this.layer.childNodes;

    if (cSuggestionNodes.length > 0 && this.cur < cSuggestionNodes.length-1) {
        var oNode = cSuggestionNodes[++this.cur];
        this.highlightSuggestion(oNode);
255
        this.textbox.value = oNode.firstChild.nodeValue;
Ad Schellevis's avatar
Ad Schellevis committed
256 257 258 259 260 261 262 263 264 265 266 267 268 269
    }
};

/**
 * Highlights the previous suggestion in the dropdown and
 * places the suggestion into the textbox.
 * @scope private
 */
AutoSuggestControl.prototype.previousSuggestion = function () {
    var cSuggestionNodes = this.layer.childNodes;

    if (cSuggestionNodes.length > 0 && this.cur > 0) {
        var oNode = cSuggestionNodes[--this.cur];
        this.highlightSuggestion(oNode);
270
        this.textbox.value = oNode.firstChild.nodeValue;
Ad Schellevis's avatar
Ad Schellevis committed
271 272 273 274 275 276 277 278 279 280 281 282 283
    }
};

/**
 * Selects a range of text in the textbox.
 * @scope public
 * @param iStart The start index (base 0) of the selection.
 * @param iLength The number of characters to select.
 */
AutoSuggestControl.prototype.selectRange = function (iStart /*:int*/, iLength /*:int*/) {

    //use text ranges for Internet Explorer
    if (this.textbox.createTextRange) {
284 285 286
        var oRange = this.textbox.createTextRange();
        oRange.moveStart("character", iStart);
        oRange.moveEnd("character", iLength - this.textbox.value.length);
Ad Schellevis's avatar
Ad Schellevis committed
287
        oRange.select();
288

Ad Schellevis's avatar
Ad Schellevis committed
289 290 291
    //use setSelectionRange() for Mozilla
    } else if (this.textbox.setSelectionRange) {
        this.textbox.setSelectionRange(iStart, iLength);
292
    }
Ad Schellevis's avatar
Ad Schellevis committed
293 294

    //set focus back to the textbox
295 296
    this.textbox.focus();
};
Ad Schellevis's avatar
Ad Schellevis committed
297 298 299 300 301 302 303 304

/**
 * Builds the suggestion layer contents, moves it into position,
 * and displays the layer.
 * @scope private
 * @param aSuggestions An array of suggestions for the control.
 */
AutoSuggestControl.prototype.showSuggestions = function (aSuggestions /*:Array*/) {
305

Ad Schellevis's avatar
Ad Schellevis committed
306 307
    var oDiv = null;
    this.layer.innerHTML = "";  //clear contents of the layer
308

Ad Schellevis's avatar
Ad Schellevis committed
309 310 311 312 313
    for (var i=0; i < aSuggestions.length; i++) {
        oDiv = document.createElement("div");
        oDiv.appendChild(document.createTextNode(aSuggestions[i]));
        this.layer.appendChild(oDiv);
    }
314

Ad Schellevis's avatar
Ad Schellevis committed
315 316 317 318 319 320 321
    this.layer.style.left = this.getLeft() + "px";
    this.layer.style.top = (this.getTop()+this.textbox.offsetHeight) + "px";
    this.layer.style.visibility = "visible";

};

/**
322
 * Inserts a suggestion into the textbox, highlighting the
Ad Schellevis's avatar
Ad Schellevis committed
323 324 325 326 327 328 329 330
 * suggested part of the text.
 * @scope private
 * @param sSuggestion The suggestion for the textbox.
 */
AutoSuggestControl.prototype.typeAhead = function (sSuggestion /*:String*/) {

    //check for support of typeahead functionality
    if (this.textbox.createTextRange || this.textbox.setSelectionRange){
331 332
        var iLen = this.textbox.value.length;
        this.textbox.value = sSuggestion;
Ad Schellevis's avatar
Ad Schellevis committed
333 334 335
        this.selectRange(iLen, sSuggestion.length);
    }
};