SimpleAutocomplete

Материал из YourcmcWiki
Версия от 20:05, 9 ноября 2011; VitaliyFilippov (обсуждение | вклад)

Это снимок страницы. Он включает старые, но не удалённые версии шаблонов и изображений.
Перейти к: навигация, поиск

Простое автодополнение (autocomplete) в текстовых полях ввода. Поддерживают мультивыбор и управление с клавиатуры (вниз, вверх, enter = выбор).

Исходники: hinter.js, hinter.css.

Использование: сначала включите на страницу hinter.js и hinter.css, потом следующий JS-код:

var hint = new SimpleAutocomplete(input, dataLoader, multipleDelimiter, onChangeListener, maxHeight, emptyText);

Обязательные параметры конструктора:

input
Поле ввода, в которое будем подсказывать, либо DOM-объект, либо его ID. ID, кстати, всегда необходимо.
dataLoader(hint, value)
Функция, которая должна загрузить опции для подсказки и вызвать hint.replaceItems([ [ name, value ], [ name, value ], ... ]). Первый параметр (hint) - объект автокомплита, на котором и надо вызывать replaceItems. Второй параметр - введённая пользователем строка, на основе которой надо предоставлять подсказки.

Необязательные параметры:

multipleDelimiter
Чтобы включить мультивыбор, передайте сюда разделитель (например ',' или ';'), который не может входить в выбираемые значения.
onChangeListener(hint, index)
Функция, которая будет вызвана при изменении значения через данный автокомплит. index - номер элемента, выделение которого изменилось. Её нужно использовать вместо обычного события "onchange" на поле ввода.
maxHeight
Максимальная высота выпадающего списка в пикселах.
emptyText
Текст, который нужно показать, если dataLoader вернёт пустой массив. По умолчанию "No items found". Если false, то при отсутствии элементов подсказка будет скрыта.