13 636
правок
Изменения
м
Новая страница: «en:SimpleAutocomplete/en Простое автодополнение (autocomplete) в текстовых полях ввода. Поддерживают мул...»
[[en:SimpleAutocomplete/en]]
Простое автодополнение (autocomplete) в текстовых полях ввода. Поддерживают мультивыбор и управление с клавиатуры (вниз, вверх, enter = выбор).
Исходники: [{{SVN|vitaphoto/js/hinter.js}} hinter.js], [{{SVN|vitaphoto/js/hinter.js}} hinter.css].
Использование:
<source lang="javascript">
var hint = new SimpleAutocomplete(input, dataLoader, multipleDelimiter, onChangeListener, maxHeight, emptyText);
</source>
Обязательные параметры конструктора:
; input: Поле ввода, в которое будем подсказывать, либо DOM-объект, либо его ID. ID, кстати, всегда необходимо.
; dataLoader(hint, value): Функция, которая должна загрузить опции для подсказки и вызвать <tt>hint.replaceItems([ [ name, value ], [ name, value ], ... ])</tt>. Первый параметр (hint) - объект автокомплита, на котором и надо вызывать replaceItems. Второй параметр - введённая пользователем строка, на основе которой надо предоставлять подсказки.
Необязательные параметры:
; multipleDelimiter: Чтобы включить мультивыбор, передайте сюда разделитель (например ',' или ';'), который не может входить в выбираемые значения.
; onChangeListener(hint, index): Функция, которая будет вызвана при изменении значения через данный автокомплит. index - номер элемента, выделение которого изменилось. Её нужно использовать вместо обычного события "onchange" на поле ввода.
; maxHeight: Максимальная высота выпадающего списка в пикселах.
; emptyText: Текст, который нужно показать, если dataLoader вернёт пустой массив. По умолчанию "No items found". Если false, то при отсутствии элементов подсказка будет скрыта.
Простое автодополнение (autocomplete) в текстовых полях ввода. Поддерживают мультивыбор и управление с клавиатуры (вниз, вверх, enter = выбор).
Исходники: [{{SVN|vitaphoto/js/hinter.js}} hinter.js], [{{SVN|vitaphoto/js/hinter.js}} hinter.css].
Использование:
<source lang="javascript">
var hint = new SimpleAutocomplete(input, dataLoader, multipleDelimiter, onChangeListener, maxHeight, emptyText);
</source>
Обязательные параметры конструктора:
; input: Поле ввода, в которое будем подсказывать, либо DOM-объект, либо его ID. ID, кстати, всегда необходимо.
; dataLoader(hint, value): Функция, которая должна загрузить опции для подсказки и вызвать <tt>hint.replaceItems([ [ name, value ], [ name, value ], ... ])</tt>. Первый параметр (hint) - объект автокомплита, на котором и надо вызывать replaceItems. Второй параметр - введённая пользователем строка, на основе которой надо предоставлять подсказки.
Необязательные параметры:
; multipleDelimiter: Чтобы включить мультивыбор, передайте сюда разделитель (например ',' или ';'), который не может входить в выбираемые значения.
; onChangeListener(hint, index): Функция, которая будет вызвана при изменении значения через данный автокомплит. index - номер элемента, выделение которого изменилось. Её нужно использовать вместо обычного события "onchange" на поле ввода.
; maxHeight: Максимальная высота выпадающего списка в пикселах.
; emptyText: Текст, который нужно показать, если dataLoader вернёт пустой массив. По умолчанию "No items found". Если false, то при отсутствии элементов подсказка будет скрыта.