Autocomplete

Bootstrap 5 Autocomplete component

Autocomplete component predicts the words being typed based on the first few letters given by the user. You can search the list using basic scroll and the keyboard arrows

Note: Read the API tab to find all available options and advanced customization


Basic example

The filter option is required in order for component to work properly. The option accepts a function that is expected to return an array of results or a Promise that resolves to an array of results.


Display value

The displayValue option allow to separate oryginal result value from the value that will be displayed in the result list or input (after selection). Its useful when the data returned by the filter function is an array of objects. You can specify which parameter of the object should be displayed.



Threshold

Use threshold option to specify a minimum number of the characters in the input field needed to perform a search operation.


Custom item template

The itemContent option allow to display custom HTML in the result list. You can use the listHeight option to modify the result list height when you want to display more content in the component dropdown.


Custom content

A custom content container with a class .autocomplete-custom-content will be displayed at the end of the autocomplete-custom-item-subtitle dropdown. You can use it to display a number of search results.


Validation

Looks good!
Input value is required

Autocomplete - API


Usage

Via JavaScript


        const myAutocomplete = new mdb.Autocomplete(document.getElementById('myAutocomplete'), options)
      

Via jQuery

Note: By default, MDB does not include jQuery and you have to add it to the project on your own.


        $('.example-class').autocomplete(options);
      

Options

Name Type Default Description
customContent String '' Custom HTML template that will be displayed at the end of the component dropdown
debounce Number 300 Delay between search queries, improves the component performance
displayValue Function (value) => value Function executed for complex search results, to get value to display in the results list
filter Function - Function that returns filtered data to the component
itemContent Function - Function that returns custom template for result item
listHeight Number 190 Height of the result list
noResults Function 'No results found' Message that will be displayed in the component dropdown if no result is found
threshold Number 300 Minimum input length to start search query

Methods

Name Description Example
open Manually opens a component dropdown myAutocomplete.open()
close Manually closes a component dropdown myAutocomplete.close()
dispose Disposes an autocomplete instance myAutocomplete.dispose()
getInstance Static method which allows you to get the autocomplete instance associated to a DOM element. Autocomplete.getInstance(myAutocomplete)
searchInit(value) Initialize search results for a specific value myAutocomplete.searchInit('')

        const myAutocomplete = document.getElementById('myAutocomplete')
        const autocomplete = new mdb.Autocomplete(myAutocomplete)
        autocomplete.open()
      

Events

Name Description
open.mdb.autocomplete This event fires immediately when the autocomplete dropdown is opened.
close.mdb.autocomplete This event fires immediately when the autocomplete dropdown is closed.
itemSelect.mdb.autocomplete This event fires immediately when the autocomplete item is selected.
update.mdb.autocomplete This event fires immediately when the autocomplete results list is updated.

        const myAutocomplete = document.getElementById('myAutocomplete')
        myAutocomplete.addEventListener('open.mdb.autocomplete', (e) => {
          // do something...
        })
      

Import

MDB UI KIT also works with module bundlers. Use the following code to import this component:


        import { Autocomplete } from 'mdb-ui-kit';