Настраиваемое дерево
Данный компонент используется для построения структуры пользовательского дерева. |
Общие переменные (свойства)
[?]
Компонент Настраиваемое дерево обладает следующими базовыми свойствами и группами свойств, которые являются общими для всех компонентов:
Имя, Дополнительные свойства, Свойства контейнера, Стили, Прелоадер, События, Привязки.
Метка
Текст заголовка дерева.
Имя переменной: | treeLabel |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
treeLabel | String | Метка |
Данные в дереве
Данное свойство определяет иерархию и визуальное представление узлов дерева.
Имя переменной: | treeData |
Записи: | 0..не ограничено |
Формат записи:
Имя поля | Тип поля | Примечания |
key | String | Key. Уникальный ключ узла дерева. |
title | String | Title. Отображаемое имя узла. |
nodeStyleId | String | Node Style. Уникальный ID стиля CSS для применения к узлу. Данное поле должно соответствовать полю id свойства nodeStyle. |
parent | Data Table | Parent Key. Определяет ID родительского узла. |
Class Name | className | Class Name. Имя класса CSS class для присвоения каждому |
Выбранные узлы
Данное свойство определяет, какие узлы дерева будут выбираться по умолчанию.
Имя переменной: | selectedNodes |
Записи: | 0..не ограничено |
Формат записи:
Имя поля | Тип поля | Примечания |
key | String | Key. Уникальный ключ выбираемого узла дерева. |
Развёрнутые узлы
Данное свойство определяет, какие узлы дерева будут разворачиваться по умолчанию. Развернутый узел должен иметь хотя бы один дочерний узел.
Имя переменной: | expandedNodes |
Записи: | 0..не ограничено |
Формат записи:
Имя поля | Тип поля | Примечания |
key | String | Key. Уникальный ключ развернутого узла дерева. |
Отмеченные узлы
Данное свойство определяет, какие узлы дерева будут отмечаться по умолчанию. Для использования этого свойства необходимо активировать свойство Добавить флажок выбора.
Обратите внимание, что отмеченные узла отличаются от выбранных узлов. Каждый узел может быть отмечен и/или выбран по отдельности.
Имя переменной: | checkedNodes |
Записи: | 0..не ограничено |
Формат записи:
Имя поля | Тип поля | Примечания |
key | String | Key. Уникальный ключ отмечаемого узла. |
Фильтрующийся
Если включено, данное свойство позволяет фильтровать данные с использованием интегрированного поля поиска, расположенного в самом верху компонента дерева. Узлы дерева, соответствующие поисковому запросу, будут подсвечиваться.
Имя переменной: | filterable |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
filterable | Boolean | Фильтрующийся |
Заполнитель
Текст, отображаемый в поле поиска, если никакой другой текст не введен.
Имя переменной: | inputPlaceholder |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
inputPlaceholder | String | Заполнитель |
Множественный выбор
Если включено, разрешает выбирать несколько узлов.
Имя переменной: | multiple |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
multiple | Boolean | Множественный выбор |
Стиль дерева
Данное свойство определяет визуальное представление различных компонентов дерева.
Имя переменной: | treeStyle |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
folderImage | Data Block | Folder Image. Изображение для значка папки (узел с дочерними узлами). |
fileImage | Data Block | File Image. Изображение для значка файла (узел без дочерних узлов). |
switcherOpenImage | Data Block | Open Switcher Image. Изображение переключателя (открыт). |
switcherCloseImage | Data Block | Close Switcher Image. Изображение переключателя (закрыт). |
Стиль узла
Данное свойство определяет визуальное представление различных узлов дерева.
Имя переменной: | nodeStyle |
Записи: | 0..не ограничено |
Формат записи:
Имя поля | Тип поля | Примечания |
id | String | ID. Уникальный ID преднастроенного стиля узла. |
name | String | Name. Имя преднастроенного стиля узла. |
folderImage | Data Block | Folder Image. Изображение для значка папки (узел с дочерними узлами). |
fileImage | Data Block | File Image. Изображение для значка файла (узел без дочерних узлов). |
switcherOpenImage | Data Block | Open Switcher Image. Изображение переключателя (открыт). |
swicherCloseImage | Data Block | Close Switcher Image. Изображение переключателя (закрыт). |
Добавить флажок выбора
Если включено, добавляет флажки выбора к узлам дерева.
Имя переменной: | checkable |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
checkable | Boolean | Добавить флажок выбора |
Изображение для кнопки фильтрации
Изображение для кнопки фильтрации.
Имя переменной: | filterButtonImage |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
imageType | Integer | Определяет использовать ли данные из поля imageData или из поля imageURL.
|
imageData | Data Block | Данные изображения. |
imageUrl | String | Ссылка на изображение. |
Контекстное меню
Определяет пункты, отображаемые в контекстном меню. Когда пункт меню выбран и его условное выражение вернуло значение True
генерируется событие ContextMenuClick@.
Имя переменной: | treeContextMenu |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания | |
name | String | Имя пункта меню. Передается в событие ContextMenuClick@ как | |
description | String | Отображаемое описание пункта меню. | |
icon | Data Block | Отображаемая в меню иконка пункта. | |
condition | String | Выражение, вычисляемое когда выбран пункт контекстного меню. Если выражение возвращает | |
Нет. | |||
Таблица с одним полем | |||
0 | |||
Стандартные переменные и |
Частичная загрузка узлов
Активирует частичную загрузку узлов. Когда дерево содержит больше узлов, чем указано в Числе узлов для частичной загрузки, узлы будут загружены до указанного количества элементов. Интерфейс графически отображает, что дерево было загружено частично, и дает пользователю возможность загрузить больше узлов.
Имя переменной: | lazyLoadEnabled |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
lazyLoadEnabled | Boolean | При значении |
Число узлов для частичной загрузки
Количество узлов, которые будут загружены, если активирована Частичная загрузка узлов.
Имя переменной: | lazyLoadLimit |
Записи: | 1 |
Record Format:
Имя поля | Тип поля | Примечания |
lazyLoadLimit | Integer |
|
Стиль заголовка
CSS стиль для применения к тексту заголовка.
Имя переменной: | styleTreeHeaderLabel |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
styleTreeHeaderLabel | String | Стиль заголовка |
Стиль контейнера заголовка
CSS стиль для применения к контейнеру заголовка.
Имя переменной: | styleTreeHeaderLabelContainer |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
styleTreeHeaderLabelContainer | String | Стиль контейнера заголовка |
Расположение компонента
Определяет расположение и размер нового окна (компонентов), открытого путем взаимодействия пользователя с настраиваемым деревом.
Подробнее о формате и поведении данного свойства смотри в разделе Расположение компонента.
Общие события
[?]
Выбор узлов
Событие генерируется когда пользователь выбирает какой-либо узел дерева и возвращает значение ключа выбранного узла, а также родительского узла.
Имя события: | treeSelection |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
key | String | Значение ключа выбранного узла. |
parent | String | Значение ключа родительского узла. |
Нажатие на контекстное меню
Событие генерируется когда пользователь выбирает пункт контекстного меню и условие возвращает значение True
.
Имя события: | contextMenuClick |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
key | String | Значение ключа выбранного узла. |
itemId | String | Имя выбранного пункта контекстного меню. |
Отметка узла дерева
Событие генерируется когда поставлена или снята метка узла. Возвращает таблицу со всеми отмеченными узлами.
Имя события: | treeNodeCheck |
Записи: | 1…не ограничено |
Формат записи:
Имя поля | Тип поля | Примечания |
key | String | Значение ключа отмеченного узла. |
parent | String | Значение ключа родительского узла для отмеченного узла. |
Раскрытие узла дерева
Генерируется когда узел дерева раскрыт или свернут.
Имя события: | treeNodeExpand |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
key | String | Значение ключа раскрытого или свернутого узла. |
parent | String | Значение ключа родительского узла для раскрытого или свернутого узла. |
Данные дерева изменились
Генерируется при изменении переменной Tree Data variable, приводящему к изменению данных дерева. Возвращает число элементов дерева, даже если новое дерево содержит такое же количество узлов, как и предыдущее дерево.
Имя события: | treeDataChanged |
Записи: | 1 |
Формат записи:
Имя поля | Тип поля | Примечания |
size | Integer | Число узлов в переменной Tree Data. |