Class Controls/dropdown:Input

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

Текст ссылки отображает выбранные значения. Значения выбирают в выпадающем меню, которое по умолчанию закрыто.

Примеры

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

Примечание

Меню можно открыть кликом на контрол. Для работы единичным параметром selectedKeys используйте контрол с Controls/source:SelectedKey.

Полезные ссылки:

Опции

_styles

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

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

Control
_theme

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

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

Control
contentTemplate

Шаблон, который будет отображать вызываемый элемент.

dataLoadCallback

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

IMenuBaseOptions
dataLoadErrback

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

IMenuBaseOptions
displayProperty

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

IMenuBaseOptions
dropdownClassName

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

IDropdown
emptyKey

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

IMenuBaseOptions
emptyTemplate

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

IMenuPopupOptions
emptyText

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

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

IMenuBaseOptions
filter

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

IFilter
fontColorStyle

Стиль цвета текста контрола.

IFontColorStyle
fontSize

Размер шрифта.

IFontSize
footerContentTemplate

Контент, располагающийся в нижней части окна.

IMenuPopupOptions
groupProperty

Имя свойства, содержащего идентификатор группы элемента списка.

IMenuControlOptions
groupTemplate

Устанавливает шаблон отображения заголовка группы.

IMenuControlOptions
headerContentTemplate

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

IMenuPopupOptions
historyId

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

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

IDropdown
iconSize

Размер иконки.

IIconSize
itemActions

Конфигурация опций записи.

IMenuControlOptions
itemTemplate

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

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

IMenuBaseOptions
itemTemplateProperty

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

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

IMenuBaseOptions
menuPopupOptions

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

IDropdown
minSearchLength

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

ISearch
multiSelect

Определяет, установлен ли множественный выбор.

navigation

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

IMenuBaseOptions
nodeFooterTemplate

Шаблон подвала, отображающийся для всех подменю.

В шаблон передается объект itemData со следующими полями:

key - ключ родительского элемента;

item - родительский элемент.

IMenuControlOptions
nodeProperty

Имя свойства, содержащего информацию о типе элемента (лист, узел).

IMenuControlOptions
parentProperty

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

IMenuControlOptions
popupClassName

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

IDropdown
readOnly

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

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

Control
searchDelay

Задержка между вводом символа и выполнением поискового запроса.

ISearch
searchParam

Имя поля фильтра, в значение которого будет записываться текст для поиска.

Фильтр с этим значением будет отправлен в поисковой запрос в источнику данных.

IMenuPopupOptions
searchValueTrim

Определяет, удалять ли пробелы у текста для поиска.

ISearch
selectedKeys

Массив ключей выбранных элементов.

IMultiSelectable
source

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

IDropdownSource
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
selectedKeysChanged

Происходит при изменении выбранных элементов.

textValueChanged

Происходит при изменении набора выбранной коллекции.

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