При инициализации плагина в него передается объект с опциями:

$(selector).suggestions(options);

В них можно передать параметры:

ПараметрПо умолчаниюОписание
addon
 

Что показывать в правом углу текстового поля подсказок:

  • по умолчанию — индикатор загрузки в десктопной версии и крестик очистки в мобильной;
  • spinner — индикатор загрузки;
  • clear — крестик очистки;
  • none — ничего не показывать.

Обратите внимание, значение нужно передавать как строку (например, addon: "clear").

autoSelectFirst
falseВсегда выбирать первую подсказку, если пользователь явно не выбрал другую.
count
5Максимальное количество подсказок в выпадающем списке. Не может быть больше 20.
deferRequestBy
100Период ожидания перед отправкой запроса на сервер подсказок, в миллисекундах.
Позволяет не перегружать сервер запросами, если пользователь очень быстро печатает.
floating 
false

Если опция установлена в true, выпадающий список отображается поверх всего документа и ничем не обрезается. 

headers
 Объект с дополнительными HTTP-заголовками, которые необходимо передать на сервер.
hint
 Поясняющий текст, который показывается в выпадающем списке над подсказками.
initializeInterval100Периодическая проверка, не стали ли невидимые поля видимыми (время в миллисекундах).
minChars
1Минимальная длина текста, после которой включаются подсказки.
mobileWidth
980Максимальная ширина экрана, при которой будет применен вид, адаптированный для мобильных устройств.
noCache
falseКэширование ответов сервера.
scrollOnFocus
true

Прокрутка поля ввода к верхнему краю экрана при фокусе. Для мобильных устройств.

Если передать jQuery-объект с другим элементом, страница будет прокручиваться до этого элемента.

serviceUrl
 URL сервиса подсказок.
suggest_localtrueНе показывать подсказки до ввода символа "@" в подсказках по e-mail.
timeout3000Таймаут для отправки ajax-запросов на сервер. Указывается в миллисекундах.
token
 API-ключ вашей учетной записи на DaData.ru.
triggerSelectOnBlur
trueАвтоматически подставлять подходящую подсказку из списка при потере фокуса.
triggerSelectOnEntertrueАвтоматически подставлять подходящую подсказку из списка при нажатии на Enter.
triggerSelectOnSpacefalseАвтоматически подставлять подходящую подсказку из списка при нажатии на пробел (по умолчанию отключено).
type
 

Тип подсказок:

  • NAME — ФИО;
  • ADDRESS — адреса;
  • PARTY — организации и ИП;
  • EMAIL — адрес электронной почты;
  • BANK — банковские организации.
width
autoШирина выпадающего списка в пикселях. 'auto' - по ширине текстбокса.