feat: add flag for toggling tab autocompletion (#260)

* feat(typeahead): add flag to disable tab autocomplete

* feat: close dropdown on tab autocompletion

Author: cdtinney

README.md

@@ -283,6 +283,8 @@ When initializing an autocomplete, there are a number of options you can configu
 
 * `autoselectOnBlur` – If `true`, when the input is blurred, the first rendered suggestion in the dropdown will automatically have the `cursor` class, and pressing `<ENTER>` will select it. This option should be used on mobile, see [#113](https://github.com/algolia/autocomplete.js/issues/113)
 
+* `tabAutocomplete` – If `true`, pressing tab will select the first rendered suggestion in the dropdown. Defaults to `true`.
+
 * `hint` – If `false`, the autocomplete will not show a hint. Defaults to `true`.
 
 * `debug` – If `true`, the autocomplete will not close on `blur`. Defaults to `false`.

src/angular/directive.js

@@ -72,6 +72,7 @@ angular.module('algolia.autocomplete', [])
             minLength: scope.options.minLength,
             autoselect: scope.options.autoselect,
             autoselectOnBlur: scope.options.autoselectOnBlur,
+            tabAutocomplete: scope.options.tabAutocomplete,
             openOnFocus: scope.options.openOnFocus,
             templates: scope.options.templates,
             debug: scope.options.debug,

src/autocomplete/typeahead.js

@@ -32,6 +32,7 @@ function Typeahead(o) {
   this.minLength = _.isNumber(o.minLength) ? o.minLength : 1;
   this.autoWidth = (o.autoWidth === undefined) ? true : !!o.autoWidth;
   this.clearOnSelected = !!o.clearOnSelected;
+  this.tabAutocomplete = (o.tabAutocomplete === undefined) ? true : !!o.tabAutocomplete;
 
   o.hint = !!o.hint;
 
@@ -285,6 +286,12 @@ _.mixin(Typeahead.prototype, {
   },
 
   _onTabKeyed: function onTabKeyed(type, $e) {
+    if (!this.tabAutocomplete) {
+      // Closing the dropdown enables further tabbing
+      this.dropdown.close();
+      return;
+    }
+
     var datum;
 
     if (datum = this.dropdown.getDatumForCursor()) {

src/jquery/plugin.js

@@ -57,6 +57,7 @@ methods = {
         minLength: o.minLength,
         autoselect: o.autoselect,
         autoselectOnBlur: o.autoselectOnBlur,
+        tabAutocomplete: o.tabAutocomplete,
         openOnFocus: o.openOnFocus,
         templates: o.templates,
         debug: o.debug,

src/standalone/index.js

@@ -42,6 +42,7 @@ function autocomplete(selector, options, datasets, typeaheadObject) {
       minLength: options.minLength,
       autoselect: options.autoselect,
       autoselectOnBlur: options.autoselectOnBlur,
+      tabAutocomplete: options.tabAutocomplete,
       openOnFocus: options.openOnFocus,
       templates: options.templates,
       debug: options.debug,

test/unit/typeahead_spec.js

@@ -464,7 +464,7 @@ describe('Typeahead', function() {
     });
 
     describe('when cursor is not in use', function() {
-      it('should autocomplete', function() {
+      it('should autocomplete if tabAutocomplete is true', function() {
         var spy;
 
         this.input.getQuery.and.returnValue('bi');
@@ -478,6 +478,35 @@ describe('Typeahead', function() {
         expect(this.input.setInputValue).toHaveBeenCalledWith(testDatum.value);
         expect(spy).toHaveBeenCalled();
       });
+
+      it('should not autocomplete if tabAutocomplete is false', function() {
+        this.view.tabAutocomplete = false;
+        
+        var spy;
+
+        this.input.getQuery.and.returnValue('bi');
+        this.input.getHint.and.returnValue(testDatum.value);
+        this.input.isCursorAtEnd.and.returnValue(true);
+        this.dropdown.getDatumForTopSuggestion.and.returnValue(testDatum);
+        this.$input.on('autocomplete:autocompleted', spy = jasmine.createSpy());
+
+        this.input.trigger('tabKeyed');
+
+        expect(this.input.setInputValue).not.toHaveBeenCalledWith(testDatum.value);
+        expect(spy).not.toHaveBeenCalled();
+      });
+
+      it('should close the dropdown if tabAutocomplete is false', function() {
+        this.view.tabAutocomplete = false;
+
+        this.input.getQuery.and.returnValue('bi');
+        this.input.getHint.and.returnValue(testDatum.value);
+        this.input.isCursorAtEnd.and.returnValue(true);
+
+        this.input.trigger('tabKeyed');
+
+        expect(this.dropdown.close).toHaveBeenCalled();
+      });
     });
   });