class Controls/treeGrid:View

Контрол "Дерево с колонками" позволяет отображать данные из различных источников в виде иерархического списка.

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

Примеры

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

Примечание

Опции

Выравнивание опций записи, когда они отображаются в режиме swipe.

IItemActions

Позиция заголовка для опций записи, когда они отображаются в режиме swipe.

IItemActions

Ключ текущего активного элемента

IList

При изначальной загрузке списка прижимать верхний триггер загрузки к нулевой позиции.

IList

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

IList

Свойство узла, которое содержит количество детей.

ITree

Имя поля узла, в котором хранится список детей.

IHierarchy

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

IGroupedList

Идентификаторы свернутых узлов в дереве с колонками.

ITree

Функция обратного вызова для расчёта объединения колонок строки (колспана).

IGridControl

Включает горизонтальную прокрутку колонок.

IGridControl

Начальное положение горизонтальной прокрутки колонок.

IGridControl

Режим отображения горизонтальной прокрутки колонок в таблице.

IGridControl
IGridControl

Конфигурация колонок таблицы.

IGridControl

Визуальное представление меню опций записи и контекстного меню.

IItemActions

Видимость контекстного меню опций записи.

IItemActions

Пользовательский шаблон, который отображается под кнопкой "Продолжить поиск".

IList

Функция, которая вызывается каждый раз непосредственно после загрузки данных из источника контрола.

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

ISource

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

ISource

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

ITree

Флаг, позволяющий запрашивать дочерние узлы при подгрузке по скроллу.

ITreeGrid

Включает скроллирование колонок перетаскиванием при горизонтальной прокрутке.

IGridControl
IDraggable

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

IGridControl
IEditableGrid

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

IList

Конфигурация колонок пустой таблицы.

IGridControl

Объект с опциями для настройки пустого представления, сконфигурированного через emptyTemplate.

IGridControl

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

Данную опцию следует определять, если нужно изменить способ отображения ошибки (диалог, вместо контента или во всю страницу) или добавить свои обработчики ошибок.

IErrorControllerOptions
IPromisedSelectable

Развертывание узлов кликом по элементу в дереве с колонками.

ITree

Идентификаторы развернутых узлов в дереве с колонками.

ITree

Стиль отображения иконки для всех узлов и скрытых узлов дерева.

ITree

Размер иконки разворота узлов дерева

ITree

Стиль цвета иконки разворота узлов дерева

ITree

Расположение иконки для узла и скрытого узла.

ITree

Размер области, который отведён под иконку узла или скрытого узла.

ITree
ITree

Массив с идентификаторами высвеченных записей.

IList

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

IFilter

Конфигурация колонок подвала таблицы.

IGridControl

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

IList

Идентификатор, по которому на Сервисе параметров сохраняется текущее состояние развернутости групп.

IGroupedList

Видимость групп в иерархической группировке

ITreeGrid

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

IGroupedList

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

IGroupedList

Имя поля записи, в котором хранится информация о наличии дочерних элементов в узле дерева.

ITree

Конфигурация шапки таблицы.

IGridControl

Отображение шапки при наличии или отсутствии элементов.

IGridControl
IGroupedList

Стиль подсветки строки при наведении курсора мыши.

IList

Функция обратного вызова для определения видимости опций записи.

IItemActions

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

IItemActions

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

IItemActions

Позиционирование панели опций записи.

IItemActions

Имя поля записи, в котором хранится конфигурация для панели с опциями записи.

IItemActions

Отображение опций записи с задержкой или без.

IItemActions

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

IGridControl

Объект с опциями для редактируемой строки, сконфигурированной через itemEditorTemplate.

IGridControl

Конфигурация отступов внутри элементов списка.

IItemPadding

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

ITree

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

ITree

Определяет, может ли пользователь перемещать элементы в списке с помощью drag'n'drop. Когда опция установлена в значение true, перемещение разрешено.

IDraggable

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

Функция единожды вызывается при построении контрола, а также в следующих случаях:

  • RecordSet, по которому строится список был пересоздан

  • Изменился конструктор модели списка (например, когда переключили вид списка)

  • Изменилось название поля, содержащего ключ записи

IList

Размер отступа между записями списка

IList

Размер пачки записей, которую мы пытаемся загрузить за отведенное время.

IList

Время итеративной загрузки, за которое мы пытаемся загрузить пачку записей.

IList

Определяет шаблон индикатора загрузки данных при порционном поиске.

IList

Сохранять ли позицию скролла после перезагрузки

IList

Имя поля записи, в котором хранится первичный ключ.

ISource

Массив с именами полей, по которым строится лесенка.

IGridControl

Определяет шаблон индикатора загрузки данных при порционном поиске.

IList

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

ITree

Идентификатор элемента, который выделен маркером.

IMarkerList

Режим отображения маркера.

IMarkerList

Шаблон отображения кнопки подгрузки данных при навигации "по запросу"

IList

Опция управляет стилем цвета текста для кнопки "Ещё".

IList

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

IMovableList

Когда опция установлена в значение true, то при изменении страницы с помощью кнопок навигации ("К следующей странице", "К предыдущей странице" и т.д.) маркер будет установлен на первую полностью видимую запись на новой странице.

IListNavigation

Имя поля записи, в котором хранится состояние видимости чекбокса.

IList

Позиционирование чекбокса.

IList

Пользовательский шаблон множественного выбора.

IList

Видимость чекбоксов.

IList

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

INavigation

Пользовательский шаблон подвала развернутого узла в дереве с колонками.

ITree

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

ITree

Идентификатор, по которому на Сервисе параметров сохраняется текущее состояние развернутости узлов.

IHierarchy

Тип сохраняемых в историю узлов

IHierarchy

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

ITree

Пользовательский текст кнопки, расположенной в узле дерева и предназначенной для загрузки очередной пачки данных узла.

ITree

Имя поля записи, в котором хранится информация о типе элемента (лист, узел, скрытый узел).

IHierarchy

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

ITreeGrid

Флаг, который отключает загрузку переменных тем оформления для контролов.

isWasabyControl

Шаблон отображения слева от кнопки навигации. Используется для отображения счетчика непрочитанных сообщений.

IList

Пользовательский шаблон для отображения слева от постраничной навигации.

IList

Пользовательский шаблон для отображения справа от постраничной навигации.

IList

Имя поля записи, в котором хранится информация о родительском узле элемента.

IHierarchy

Уникальный идентификатор, по которому в хранилище данных будет сохранена конфигурация контрола.

IPropStorage

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

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

isWasabyControl

Функция обратного вызова для расчёта объединения колонок строки итого.

IGridControl

Позиция отображения строки итогов.

IGridControl

Пользовательский шаблон отображения строки итогов.

IGridControl

Отображение строки итогов при наличии или отсутствии элементов.

IGridControl

Cкругление углов элемента списка.

Также устанавливает скругление углов для блока операций над записью.

IList
IList

Настройка видимости линий-разделителей строк по краям и внутри списка.

IList

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

ITree

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

ITree

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

IPromisedSelectable

Тип подсчитываемых записей.

ISelectionCountModeOptions

Тип записей, которые можно выбрать.

ITree

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

IGridControl

Режим единого развернутого узла.

ITree

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

ISorting

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

ITree

Экземпляр класса загрузчика данных Controls/dataSource:NewSourceController.

IList

Функция обратного вызова для определения залипания элемента списка.

В зависимости от возвращаемого значения может контролировать залипание элемента списка:

  • top - элемент списка залипает только у верхней границы списка
  • bottom - элемент списка залипает только у нижней границы списка
  • topBottom - элемент списка залипает и у верхней и у нижней границы списка
IList

Количество зафиксированных колонок, которые не двигаются при горизонтальной прокрутке.

IGridControl

Закрепляет подвал списка.

IList

При включенной группировке элементов опция задает прилипание заголовков групп при прокрутке списка.

IList

Прилипание шапки таблицы и заголовков групп при прокрутке таблицы или списка.

IList

Включает прилипание операций над записью к правому краю прокручиваемой области при горизонтальном скролле.

IGridControl

Позволяет включать/отключать прилипание выбранного элемента.

IList

Прилипание итогов при прокрутке таблицы.

IList

Индентификатор загрузчика данных.

IStoreId

Режим отображения списка.

IList

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

isWasabyControl

Имя поля записи, в котором содержится ссылка для открытия в новой вкладке.

IList

Конфигурация виртуального скролла.

IVirtualScroll

Поля

Режим загрузки дочерних элементов при развороте узла

ITreeControlOptions

подмешивается в совместимости. нужно для совместимости с ws3.

Определяет значения опций для декорирования.

Control

Логический родитель. То есть тот, в шаблоне которого лежит данный экземпляр.

В идеале отказаться, но пока что есть использования.

Control

Название контрола.

Control

Опции, который были до рендера контрола, передаются как параметр в хуки

жизненного цикла _afterRender и _afterUpdate

Control
deprecated

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

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

Control
deprecated

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

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

Control

Нужно для переноса _children родителя из оберток над чистым реактом, чтобы работал вызов методов с инстанса контрола

Control
protected

Набор детей контрола, для которых задан атрибут name.

Control

Контекст с опциями readOnly и theme

Control
protected

Реальные опции контрола. Туда собираются значения из props и context.

ВАЖНО: значения могут не совпадать с props в некоторые моменты времени,

чтобы в хуках были правильные значения.

Control
protected

Шаблон контрола.

Control

Методы

protected

Хук жизненного цикла контрола. Вызывается сразу после установки контрола в DOM-окружение.

Control
protected

Хук жизненного цикла контрола.

Вызывается синхронно после того, как изменения были применены к DOM и до того, как браузер отрисовал кадр.

Control
protected

Асинхронный хук жизненного цикла контрола. Вызывается после обновления контрола.

Control
protected

Хук жизненного цикла контрола. Вызывается непосредственно перед установкой контрола в DOM-окружение.

Control
protected

Хук жизненного цикла контрола. Вызывается перед обновлением контрола.

Control

Хук жизненного цикла контрола. Вызывается до удаления контрола.

Control
protected

Хук жизненного цикла контрола. Вызывается перед обновлением контрола.

Control

Синхронный хук жизненного цикла контрола. Вызывается сразу после установки контрола в DOM-окружение.

Control
protected

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

Control

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

isWasabyControl

Запускает добавление по месту.

Использование метода в списке с режимом "только чтение" невозможно.

IEditableGrid

Запускает редактирование по месту.

Использование метода в списке с режимом "только чтение" невозможно.

IEditableGrid

Завершает редактирование/добавление по месту без сохранения введенных данных.

Использование метода в списке с режимом "только чтение" невозможно.

IEditableGrid

Завершает редактирование/добавление по месту с сохранением введенных данных.

Использование метода в списке с режимом "только чтение" невозможно.

IEditableGrid

Создаёт и монтирует контрол на элемент

Control

Старый способ наследоваться

Control

Замораживает hover подсветку строки для указанной записи

View

Возвращает рекордсет, на основании которого в данный момент строится список.

IList

Возвращает ключ родителя, в котором по-умолчанию следует начинать добавление по месту.

ITree

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

Control

Для обратной совместимости

Control

Перемещает выбранную запись на одну позицию вниз. Перемещение происходит только в источнике.

IMovableList

Перемещает выбранную запись на одну позицию вверх. Перемещение происходит только в источнике.

IMovableList

Перемещает указанные записи в указанную позицию position, которая может принимать значения after/before/on. Перемещение происходит только в источнике.

IMovableList

Перемещает указанные элементы при помощи диалога MoveDialog, и возвращает результат moveItems().

IMovableList

Перезагружает данные из источника данных.

IReloadableList

Загружает модель из источника данных,

объединяет изменения в текущих данных и отображает элемент.

IList

Перезагружает указанные записи списка. Для этого отправляет запрос query-методом

со значением текущего фильтра в поле [parentProperty] которого передаются идентификаторы

родительских узлов.

Удаляет элементы из источника данных по идентификаторам элементов коллекции.

IRemovableList

Удаляет с подтверждением элементы из источника данных по идентификаторам элементов коллекции.

IRemovableList

Для обратной совместимости

Control

Публичный метод для управления скроллом в списке.

IList

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

IGridControl

Прокручивает список к указанному элементу.

IList

Устанавливает положение горизонтального скролла в крайнее левое положение, в начало таблицы.

IGridControl

Устанавливает положение горизонтального скролла в крайнее правое положение, в конец таблицы.

IGridControl

Размораживает все ранее замороженные итемы

View

События

actionClick Происходит при клике по опции записи.

IItemActions

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

isWasabyControl

activeElementChanged Происходит при смене активного элемента в процессе скроллирования.

IList

Происходит после запуска редактирования/добавления по месту.

IEditableGrid

Происходит после завершения редактирования/добавления по месту.

IEditableGrid

afterItemCollapse Происходит после сворачивания узла.

ITree

afterItemExpand Происходит после развертывания узла.

ITree

Происходит перед запуском редактирования/добавления по месту.

IEditableGrid

Происходит перед завершением редактирования/добавления по месту.

IEditableGrid

beforeItemCollapse Происходит перед сворачиванием узла.

ITree

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

ITree

Происходит до изменения ключа маркера.

IMarkerList

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

IPromisedSelectable

changeDragTarget Происходит перед изменением позиции, в которую будет перемещен элемент.

IDraggable

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

ITree

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

isWasabyControl

disableVirtualNavigation Происходит при использовании виртуального скролла, когда список находится в такой позиции, что сверху или снизу списка нет скрытых (или доступных для загрузки) элементов.

IVirtualScroll

dragEnd Происходит при завершении перемещения элемента в списке.

IDraggable

dragEnter Происходит при перемещении элемента из другого контрола.

IDraggable

dragStart Происходит при начале перемещения элемента.

IDraggable

drawItems Происходит при отрисовке очередного набора данных.

IList

editArrowClick Происходит при клике на "шеврон" элемента.

IGridControl

enableVirtualNavigation Происходит при использовании виртуального скролла, когда список находится в такой позиции, что сверху и снизу списка есть скрытые (или доступные для загрузки) элементы.

IVirtualScroll

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

IPromisedSelectable

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

IFilterChanged

Происходит при сворачивании группы.

IGroupedList

Происходит при развертывании группы.

IGroupedList

hoveredCellChanged Происходит при наведении курсора мыши на ячейку таблицы.

IGridControl

hoveredItemChanged Происходит при наведении курсора мыши на элемент списка.

IList

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

IList

itemClick Происходит при клике на элемент списка.

IClickableView
deprecated

itemCollapse Происходит перед сворачиванием узла.

ITree
deprecated

itemCollapsed Происходит после сворачивания узла.

ITree
deprecated

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

ITree
deprecated

itemExpanded Происходит после развертывания узла.

ITree

itemLongTap Происходит при долгом тапе на элементе списка на touch устройствах.

IList

itemMouseDown Происходит в момент нажатия на кнопку мыши над элементом списка.

IList

itemMouseEnter Происходит в момент, когда курсор оказывается над элементом списка.

IList

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

IList

itemMouseMove Происходит в момент, когда курсор двигается по элементам списка.

IList

itemSwipe Происходит при свайпе на элементе списка.

IList

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

IMarkerList

navigationParamsChanged Происходит при изменении параметров навигации.

IListNavigation

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

IList

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

IPromisedSelectable

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

IList

tagClick Происходит при клике на тег внутри ячейки таблицы.

IGridControl

tagHover Происходит при наведении курсора мыши на тег внутри ячейки таблицы.

IGridControl