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

$(selector).suggestions(options);

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

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

Отменен с версии 20.3

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

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

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

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

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

headers

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

NAME: false

ADDRESS: 'Неизвестный адрес'

EMAIL: false

PARTY: 'Неизвестная организация'

BANK: 'Неизвестный банк'

Поясняющий текст, который показывается, если для введённого запроса ничего не найдено. Текст зависит от типа подсказок.

Если установить noSuggestionsHint = false, текст показываться не будет.

scrollOnFocusfalseПрокручивать текстовое поле к верхней границе экрана при фокусе. Если настройка включена, действует только на мобильных устройствах.
token

API-ключ (только для пользователей «Дадаты»)
triggerSelectOnBlurtrueАвтоматически подставлять подходящую подсказку из списка, когда текстовое поле теряет фокус.
triggerSelectOnEntertrueАвтоматически подставлять подходящую подсказку из списка при нажатии на Enter.
triggerSelectOnSpacefalseАвтоматически подставлять подходящую подсказку из списка при нажатии на пробел (по умолчанию отключено).
type

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

  • NAME — ФИО;
  • ADDRESS — адреса;
  • PARTY — организации и ИП;
  • EMAIL — адрес электронной почты;
  • BANK — банковские организации.

Обязательный параметр — только type.