Class Controls/dropdown:Combobox

Контрол, позволяющий выбрать значение из списка. Полный список параметров отображается при нажатии на контрол.

Примеры

Пример
Исходный код

Примечание

Опции

_styles

Массив имен нетемизированных стилей, необходимых контролу.

Все стили будут скачаны при создании

Control
_theme

Массив имен темизированных стилей, необходимых контролу.

Все стили будут скачаны при создании

Control
dataLoadCallback

Функция обратного вызова, которая будет вызываться, когда данные загружены источником.

IMenuBaseOptions
dataLoadErrback

Функция обратного вызова, которая будет вызываться, когда при загрузке данных произошла ошибка.

IMenuBaseOptions
displayProperty

Устанавливает имя поля элемента, значение которого будет отображено.

IMenuBaseOptions
dropdownClassName

Класс, который навешивается на выпадающий список.

IDropdown
emptyKey

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

IMenuBaseOptions
emptyText

Добавляет пустой элемент в список с заданным текстом.

Ключ пустого элемента по умолчанию null, для изменения значения ключа используйте emptyKey.

IMenuBaseOptions
filter

Конфигурация объекта фильтра. Фильтр отправляется в запрос к источнику для получения данных.

IFilter
historyId

Уникальный идентификатор для сохранения истории выбора записей.

Подробнее читайте здесь.

IDropdown
itemTemplate

Устанавливает шаблон отображения элемента в выпадающем списке. Подробнее про найстройку шаблона здесь.

Для контролов из библиотеки dropdown используйте в качестве шаблона Controls/dropdown:ItemTemplate для ленивой загрузки библиотеки menu.

IMenuBaseOptions
itemTemplateProperty

Устанавливает имя поля, которое содержит имя шаблона отображения элемента. Подробнее про найстройку шаблона здесь.

Для контролов из библиотеки dropdown используйте в качестве шаблона Controls/dropdown:ItemTemplate для ленивой загрузки библиотеки menu.

IMenuBaseOptions
keyProperty

Имя свойства, содержащего информацию об идентификаторе текущей строки.

ISource
menuPopupOptions

Опции для окна выпадающего списка

IDropdown
navigation

Конфигурация навигации по списку.

IMenuBaseOptions
placeholder

Текст, который отображается в пустом поле ввода.

IInputPlaceholder
popupClassName

Класс, который навешивается на всплывающее окно.

IDropdown
readOnly

Определяет, может ли пользователь изменить значение контрола.

(или взаимодействовать с контролом, если его значение не редактируется).

Control
selectedKey

Ключ выбранного элемента коллекции.

ISingleSelectable
source

Объект реализующий интерфейс Types/source:ICrud, необходимый для работы с источником данных.

ISource
theme

Название темы оформления. В зависимости от темы загружаются различные таблицы стилей и применяются различные стили к контролу.

Control

Методы

activate

Активирует контрол.

Control
closeMenu

Закрывает выпадающий список.

IDropdown
isCSSLoaded

Проверка загрузки стилей и тем контрола

Control
loadCSS

Загрузка стилей и тем контрола

Control
openMenu

Открывает выпадающий список.

IDropdown
reload

Перезагружает данные выпадающего списка.

IDropdown
removeCSS

Удаление link элементов из DOM

Control

События

activated

Происходит при активации контрола.

Control
deactivated

Происходит при деактивации контрола.

Control
dropDownClose

Происходит при закрытии выпадающего списка.

IDropdown
dropDownOpen

Происходит при открытии выпадающего списка.

IDropdown
filterChanged

Происходит при изменении фильтра.

IFilter
selectedKeyChanged

Происходит при изменении выбранного значения.

ISingleSelectable
valueChanged

Происходит при изменении отображаемого значения контрола.

10/23/2020Золотова Э.Е.