Class Controls/dropdown:Button

Контрол «Кнопка с меню».

Примеры

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

Примечание

Опции

_styles

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

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

Control
_theme

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

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

Control
additionalProperty

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

buttonStyle

Стиль отображения кнопки.

IButton
caption

Определяет текст заголовка контрола.

ICaption
contrastBackground

Определяет контрастность фона кнопки по отношению к ее окружению.

IButton
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
footerTemplate

Шаблон подвала списка.

IFooterTemplate
groupProperty

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

IMenuControlOptions
groupTemplate

Шаблон группировки.

IGrouped
headerContentTemplate

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

IMenuPopupOptions
headerTemplate

Шаблон отображения для шапки меню.

IHeaderTemplate
historyId

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

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

IDropdown
icon

Определяет иконку, которая будет отображена в контроле.

IIcon
iconSize

Единый размер для иконок, отображаемых в контроле.

IIconSize
iconStyle

Стиль отображения иконки.

IIconStyle
inlineHeight

Высота контрола.

IHeight
itemActions

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

IMenuControlOptions
itemTemplate

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

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

IMenuBaseOptions
itemTemplateProperty

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

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

IMenuBaseOptions
lazyItemsLoading

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

menuPopupOptions

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

IDropdown
minSearchLength

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

ISearch
navigation

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

IMenuBaseOptions
nodeFooterTemplate

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

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

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

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

IFooterTemplate
nodeProperty

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

IMenuControlOptions
parentProperty

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

IMenuControlOptions
popupClassName

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

IDropdown
readOnly

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

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

Control
searchDelay

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

ISearch
searchParam

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

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

ISearch
searchValueTrim

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

ISearch
source

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

IDropdownSource
theme

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

Control
tooltip

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

ITooltip

Методы

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
menuItemActivate

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

10/23/2020Герасимов А.М.