При инициализации плагина в него передается объект с опциями:
$(selector).suggestions(options);
В них можно передать параметры:
Параметр | По умолчанию | Описание |
---|---|---|
addon | Что показывать в правом углу текстового поля подсказок:
Обратите внимание, значение нужно передавать как строку (например, addon: "clear"). | |
autoSelectFirst | false | Всегда выбирать первую подсказку, если пользователь явно не выбрал другую. |
count | 5 | Максимальное количество подсказок в выпадающем списке. Не может быть больше 20. |
deferRequestBy | 100 | Период ожидания перед отправкой запроса на сервер подсказок, в миллисекундах. Позволяет не перегружать сервер запросами, если пользователь очень быстро печатает. |
floating | false | Если опция установлена в true, выпадающий список отображается поверх всего документа, и ничем не обрезается. |
headers | Объект с дополнительными HTTP-заголовками, которые необходимо передать на сервер. | |
hint | Поясняющий текст, который показывается в выпадающем списке над подсказками. | |
initializeInterval | 100 | Периодическая проверка, не стали ли поля невидимые поля видимыми (время в миллисекундах). |
minChars | 1 | Минимальная длина текста, после которой включаются подсказки. |
mobileWidth | 980 | Максимальная ширина экрана, при которой будет применен вид, адаптированный для мобильных устройств. |
noCache | false | Кэширование ответов сервера. |
scrollOnFocus | true | Прокрутка поля ввода к верхнему краю экрана при фокусе. Для мобильных устройств. Если передать jQuery-объект с другим элементом, страница будет прокручиваться до этого элемента. |
serviceUrl | URL сервиса подсказок. | |
suggest_local | true | Не показывать подсказки до ввода символа "@" в подсказках по e-mail. |
timeout | 3000 | Таймаут для отправки ajax-запросов на сервер. Указывается в миллисекундах. |
token | API-ключ вашей учетной записи на DaData.ru. | |
triggerSelectOnBlur | true | Автоматически подставлять подходящую подсказку из списка при потере фокуса. |
triggerSelectOnEnter | true | Автоматически подставлять подходящую подсказку из списка при нажатии на Enter. |
triggerSelectOnSpace | false | Автоматически подставлять подходящую подсказку из списка при нажатии на пробел (по умолчанию отключено). |
type | Тип подсказок:
| |
width | auto | Ширина выпадающего списка в пикселях. 'auto' - по ширине текстбокса. |
Overview
Content Tools