Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

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

ПараметрПо умолчаниюОписание
autoSelectFirst
falseВсегда выбирать первую подсказку, если пользователь явно не выбрал другую
addon

Примечание

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

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

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

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

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

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

headers
 

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

NAME: 

URL сервиса подсказок
token
 API-ключ вашей учетной записи на DaData.ru
triggerSelectOnSpace
trueАвтоматическое исправление текста при вводе.
type
 

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

  • NAME — ФИО;
  • ADDRESS — адреса;
  • PARTY — организации и ИП.
usePreloader
trueПоказывать крутящийся индикатор во время ожидания ответа от сервера
width
autoШирина выпадающего списка в пикселяхconstraints Ограничения поиска по адресам и организациям.restrict_valuefalseЕсли указан constraints, из подсказок в выпадающем списке удаляются части, соответствующие этому ограничению.geoLocationtrueДля адресов включает определение местоположения клиента для лучшего ранжирования подсказок.bounds Для адресов позволяет выбирать с и/или до определенного уровня. Задается строкой, например: "city" - выбор города, "region-area" - региона или района, "street-" - любого уровня, начиная с улицыmobileWidth980Максимальная ширина экрана, при которой будет применен вид, адаптированный для мобильных устройств
scrollOnFocus
trueПытаться ли прокрутить поле ввода к верхнему краю экрана, когда он получает фокус.
Работает для устройств с узким экраном (мобильных). Можно также передать jQuery-объект с другим элементом,
тогда страница будет прокручиваться до этого элемента

false

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

EMAIL: false

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

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

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

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

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

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

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

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

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