my-autocomplete

Create and custom your own autocomplete !

CHANGELOG

v1.2.0

• Remove callback function parameter for render: { renderItem() }, can be used for data or xhr Events will come later.

Browsers support

This module use classList so IE10+ but if you need lower version, you should use a polyfill. ATM, this plugin has not been checked on mobile

Setup

npm i my-autocomplete --save or link the autocomplete.bundle.js in a script tag

Example with XHR

var Autocomplete = require('my-autocomplete');

document.addEventListener('DOMContentLoaded', function() {
  var search = new Autocomplete({
    input: '#search',
    xhr: {
      url: 'http://localhost:3000/results',
      method: 'GET',
      key: 'q'
    },
  });
}, false);

Each instance of Autocomplete needs to be bound to an input. In this exemple, I'm using json-server with some fake data so you have to pass an xhr object who contain :

• the method
• the key

Both depends of the back-end so when you set the method to GET it will send a request like this : http://localhost:3000/results?[key]={input_value}.

If not and you prefer use POST, it will be send with the same idea [key]=input_value.

Custom rendering

If you need to custom each value (adding icon, etc...) or work with object values, you can use the renderItem function in the render object. Here is an example :

var Autocomplete = require('my-autocomplete');

document.addEventListener('DOMContentLoaded', function() {
  var search = new Autocomplete({
    input: '#search',
    xhr: {
      url: 'http://localhost:3000/results',
      method: 'GET',
      key: 'q'
    },
    render: {
      renderItem(item) {
        return `
          <div class="autocomplete-item" data-autocomplete-value="${item.title}">
            Test : <strong>${item.title}</strong>
          </div>
        `;
      }
    },
  });

You must set the data attribute data-autocomplete-value and the autocomplete-item classname, if not the plugin will not set the text to the input.

<div>
  <label for="search">Search :</label>
  <input type="text" id="search" name="search">
</div>

<script src="autocomplete.js"></script>

Example with dummy data

var Autocomplete = require('my-autocomplete');

document.addEventListener('DOMContentLoaded', function() {
  var search = new Autocomplete({
    input: '#search',
    data: ['France', 'Test', 'London']
  });


}, false);

Try and hack

If you want to try this plugin quickly this plugin, follow these steps :

• clone the repo
• npm i
• run npm start
• if you want to try ajax system don't forget to run the fake-server with npm run fakedata in another terminal