13 521
правка
Изменения
м
Нет описания правки
; input: Поле ввода, в которое будем подсказывать, либо DOM-объект, либо его ID. ID, кстати, всегда необходимо.
; dataLoader(hint, value, more): Функция, которая должна загрузить опции для подсказки и вызвать <tt>hint.replaceItems([ [ name, value ], [ name, value [, disabled[, checked]] ], ... ], more)</tt>.
:* hint — объект автокомплита, на котором и надо вызывать replaceItems.
:* value — введённая пользователем строка, на основе которой надо предоставлять подсказки.
:* more — при использовании moreMarker «страница» подсказок, которую нужно загрузить (0 = первая страница).
:: Параметры опций:
::* name — Название
::* value — Значение (которое будет подставлено в поле ввода)
::* disabled — «Выключена» ли эта опция — если да, то её будет невозможно выбрать
::* checked — Отмечен ли изначально флажок этой опции (только при мультивыборе)
Необязательные параметры конструктора передаются в объекте <tt>params</tt>:
; multipleDelimiter: Чтобы включить мультивыбор, передайте сюда разделитель (например ',' или ';'), который не может входить в выбираемые значения. Также они не могут включать пробелы в начале и конце. Значение поля ввода будет установлено равным значениям всех выбранных элементов, соединённым через данный разделитель и один пробел (например «a, b»).
; multipleListener(hint, index, item): Для «мультивыбора с побочным эффектом» — когда поле ввода хочется использовать только для выбора значений в подсказке, а не для перечисления выбранных значений — можно передать в этот параметр callback, который будет реагировать на клики по элементам и где-то сохранять их статус. <tt>index</tt> — номер элемента, <tt>item = [ name, value, disabled, checked ]</tt>. Если задан multipleDelimiter и если callback вернёт true, то кроме вызова multipleListener всё-таки будет также затронуто и значение в поле ввода.
: Также в этом режиме обретает смысл включение/выключение (enable/disable) указание изначальной отмеченности флажков элементов списка и указание их статуса при загрузке списка: <tt>hint.replaceItems([ [ name, value, disabled[, checked ] ], ... ], more)</tt>.
; onChangeListener(hint, index): Функция, которая будет вызвана при изменении значения через данный автокомплит. <tt>index</tt> — номер элемента, выделение которого изменилось. Её нужно использовать вместо обычного события «onchange» на поле ввода.
; maxHeight: Максимальная высота выпадающего списка в пикселах.
