feat(autocomplete): add option to specify minimum characters for autocomplete

Author: daFish

src/Autocomplete/assets/dist/controller.js

@@ -134,6 +134,11 @@ _instances = new WeakSet(), _getCommonConfig = function _getCommonConfig() {
                 .then(json => { this.setNextUrl(query, json.next_page); callback(json.results); })
                 .catch(() => callback());
         },
+        shouldLoad: (query) => {
+            if (query.length < this.minCharactersTextValue) {
+                return;
+            }
+        },
         score: function (search) {
             return function (item) {
                 return 1;
@@ -173,6 +178,7 @@ default_1.values = {
     optionsAsHtml: Boolean,
     noResultsFoundText: String,
     noMoreResultsText: String,
+    minCharacters: Number,
     tomSelectOptions: Object,
 };
 

src/Autocomplete/assets/src/controller.ts

@@ -8,13 +8,15 @@ export default class extends Controller {
         optionsAsHtml: Boolean,
         noResultsFoundText: String,
         noMoreResultsText: String,
+        minCharacters: Number,
         tomSelectOptions: Object,
     }
 
     readonly urlValue: string;
     readonly optionsAsHtmlValue: boolean;
     readonly noMoreResultsTextValue: string;
     readonly noResultsFoundTextValue: string;
+    readonly minCharactersTextValue: number;
     readonly tomSelectOptionsValue: object;
     tomSelect: TomSelect;
 
@@ -142,6 +144,11 @@ export default class extends Controller {
                     .then(json => { this.setNextUrl(query, json.next_page); callback(json.results) })
                     .catch(() => callback());
             },
+            shouldLoad: (query: string) => {
+                if (query.length < this.minCharactersTextValue) {
+                    return;
+                }
+            },
             // avoid extra filtering after results are returned
             score: function(search: string) {
                 return function(item: any) {

src/Autocomplete/src/Form/AutocompleteChoiceTypeExtension.php

@@ -71,6 +71,10 @@ public function finishView(FormView $view, FormInterface $form, array $options)
             $values['max-results'] = $options['max_results'];
         }
 
+        if ($options['min_characters']) {
+            $values['min-characters'] = $options['min_characters'];
+        }
+
         $values['no-results-found-text'] = $this->trans($options['no_results_found_text']);
         $values['no-more-results-text'] = $this->trans($options['no_more_results_text']);
 
@@ -91,6 +95,7 @@ public function configureOptions(OptionsResolver $resolver)
             'allow_options_create' => false,
             'no_results_found_text' => 'No results found',
             'no_more_results_text' => 'No more results',
+            'min_characters' => 3,
             'max_results' => 10,
         ]);