MODx.tree.Tree

Последнее обновление Oct 11th, 2026 | История страницы | Улучшить эту страницу | Сообщить о проблеме

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$185 per month—let's make that $500!

Learn more

MODx.tree.Tree¶

Расширяет: Ext.tree.TreePanel

Основные характеристики: Удаленно загруженные панели инструментов; перетаскивание для полей формы; функциональность коннектора для удаления и перетаскивания/сортировки.

Деревья предоставляют быстрый и простой способ отображения нескольких уровней объектов, которые имеют отношения родитель-ребенок, таких как пользователи или ресурсы.

Уникальные параметры¶

MODx.tree.Tree имеет несколько дополнительных параметров, которых нет в объектах Ext.tree.TreePanel

Название	Описание	Значение по умолчанию
url	URL, на который указывает загрузчик дерева. Необязательно, если вы передаете в параметре данных.
action	Действие процессора, которое запрашивает загрузчик при получении узлов.	getNodes
baseParams	Параметры, отправляемые с каждым запросом загрузки узла.	{}
rootName	Текст корневого узла, если rootVisible имеет значение true.
rootId	Идентификатор корневого узла.	root
rootIconCls	CSS-класс иконки корневого узла.
rootQtip	Подсказка (tooltip) для корневого узла.
data	Необязательно; если URL не задан, данные должны быть загружены сюда.	[]
remoteToolbar	Если true, загрузит панель инструментов дерева через данные, загруженные удаленно.	false
remoteToolbarUrl*	URL-адрес коннектора для загрузки панели инструментов. По умолчанию используется URL-адрес дерева.
remoteToolbarAction*	Действие процессора для загрузки панели инструментов.	getToolbar
useDefaultToolbar	Если remoteToolbar имеет значение false, будет загружена панель инструментов по умолчанию, которая содержит пункты “развернуть все”, “свернуть все” и “обновить”. Элементы, переданные в свойство tbar, будут добавлены после.	false
menuConfig	Объект config для передачи в контекстное меню, загруженное для этого дерева.
expandFirst	Если true, развернет узлы первого уровня при рендеринге. В базовом классе по умолчанию false; core-деревья (например, дерево ресурсов) устанавливают true.	false в базовом классе; core-деревья устанавливают true
removeAction*	Действие процессора при удалении узла.	remove
removeTitle*	Заголовок для диалога удаления при удалении узла.	Предупреждение!
primaryKey	Первичный ключ для узла. Обычно это идентификатор.	id
sortAction	Действие процессора при сортировке узлов с помощью перетаскивания.	sort
toolbarItemCls*	Класс CSS, добавляемый к загруженным элементам remoteToolbar.	x-btn-icon

= Только для MODX Revolution версии 2.1 и выше

Пользовательские события¶

Пользовательские события, запускаемые MODx.tree.Tree:

Название	Описание
beforeSort	Запускается до того, как дерево отправит отсортированные узлы процессору сортировки. Передаются отсортированные узлы, закодированно.
afterSort	Запускается после сортировки узлов дерева. Параметры: event (событие бросания), result (ответ процессора сортировки)
refresh	Запускается после перезагрузки/обновления дерева.

Другие уникальные особенности¶

Сортировка¶

Сортировка автоматически включается по умолчанию в объектах MODx.tree.Tree. Чтобы отключить, установите для enableDD значение false в вашей конфигурации. После перетаскивания дерево запустит закодированные узлы в процессор сортировки с тем же коннектором, что и у URL дерева.

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

Панели инструментов могут быть загружены удаленно, используя параметр конфигурации remoteToolbar. Это загрузит данные из процессора, загруженного конфигурационной переменной remoteToolbarAction, которая по умолчанию имеет значение «getToolbar».

Перетаскивание в поля MODx.FormPanel¶

Узлы можно перетаскивать в поля MODx.FormPanel, предполагая, что в конфигурационную переменную передается следующее (modx-treedrop-dd — группа перетаскивания, которую используют дерево ресурсов и MODx.TreeDrop; остальные деревья используют собственные группы, например modx-treedrop-elements-dd для дерева элементов):

,enableDD: true
,ddGroup: 'modx-treedrop-dd'

и что у узла есть атрибут ‘type’, который является одним из следующих значений: modResource, сниппет, chunk, tv, file.

Смотрите также¶