devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
1,175 lines (1,172 loc) • 74.3 kB
JavaScript
/**
* DevExtreme (cjs/__internal/ui/tree_view/tree_view.base.js)
* Version: 25.1.5
* Build date: Wed Sep 03 2025
*
* Copyright (c) 2012 - 2025 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
"use strict";
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.default = exports.ITEM_CLASS = exports.EXPANDER_ICON_STUB_CLASS = void 0;
var _animation = require("../../../common/core/animation");
var _click = require("../../../common/core/events/click");
var _events_engine = _interopRequireDefault(require("../../../common/core/events/core/events_engine"));
var _double_click = require("../../../common/core/events/double_click");
var _pointer = _interopRequireDefault(require("../../../common/core/events/pointer"));
var _utils = require("../../../common/core/events/utils");
var _message = _interopRequireDefault(require("../../../common/core/localization/message"));
var _dom_adapter = _interopRequireDefault(require("../../../core/dom_adapter"));
var _element = require("../../../core/element");
var _renderer = _interopRequireDefault(require("../../../core/renderer"));
var _deferred = require("../../../core/utils/deferred");
var _extend = require("../../../core/utils/extend");
var _icon = require("../../../core/utils/icon");
var _iterator = require("../../../core/utils/iterator");
var _size = require("../../../core/utils/size");
var _type = require("../../../core/utils/type");
var _window = require("../../../core/utils/window");
var _m_support = _interopRequireDefault(require("../../core/utils/m_support"));
var _index2 = _interopRequireDefault(require("../../ui/check_box/index"));
var _hierarchical_collection_widget = _interopRequireDefault(require("../../ui/hierarchical_collection/hierarchical_collection_widget"));
var _load_indicator = _interopRequireDefault(require("../../ui/load_indicator"));
var _consts = require("../../ui/scroll_view/consts");
var _scrollable = _interopRequireDefault(require("../../ui/scroll_view/scrollable"));
var _get_relative_offset = require("../../ui/scroll_view/utils/get_relative_offset");
function _interopRequireDefault(e) {
return e && e.__esModule ? e : {
default: e
}
}
function _extends() {
return _extends = Object.assign ? Object.assign.bind() : function(n) {
for (var e = 1; e < arguments.length; e++) {
var t = arguments[e];
for (var r in t) {
({}).hasOwnProperty.call(t, r) && (n[r] = t[r])
}
}
return n
}, _extends.apply(null, arguments)
}
const WIDGET_CLASS = "dx-treeview";
const NODE_CLASS = `${WIDGET_CLASS}-node`;
const NODE_CONTAINER_CLASS = `${NODE_CLASS}-container`;
const NODE_LOAD_INDICATOR_CLASS = `${NODE_CLASS}-loadindicator`;
const OPENED_NODE_CONTAINER_CLASS = `${NODE_CLASS}-container-opened`;
const IS_LEAF = `${NODE_CLASS}-is-leaf`;
const ITEM_CLASS = exports.ITEM_CLASS = `${WIDGET_CLASS}-item`;
const ITEM_WITH_CHECKBOX_CLASS = `${ITEM_CLASS}-with-checkbox`;
const ITEM_WITH_CUSTOM_EXPANDER_ICON_CLASS = `${ITEM_CLASS}-with-custom-expander-icon`;
const CUSTOM_EXPANDER_ICON_ITEM_CONTAINER_CLASS = `${WIDGET_CLASS}-custom-expander-icon-item-container`;
const ITEM_WITHOUT_CHECKBOX_CLASS = `${ITEM_CLASS}-without-checkbox`;
const ITEM_DATA_KEY = `${ITEM_CLASS}-data`;
const TOGGLE_ITEM_VISIBILITY_CLASS = `${WIDGET_CLASS}-toggle-item-visibility`;
const CUSTOM_COLLAPSE_ICON_CLASS = `${WIDGET_CLASS}-custom-collapse-icon`;
const CUSTOM_EXPAND_ICON_CLASS = `${WIDGET_CLASS}-custom-expand-icon`;
const LOAD_INDICATOR_CLASS = `${WIDGET_CLASS}-loadindicator`;
const LOAD_INDICATOR_WRAPPER_CLASS = `${WIDGET_CLASS}-loadindicator-wrapper`;
const TOGGLE_ITEM_VISIBILITY_OPENED_CLASS = `${WIDGET_CLASS}-toggle-item-visibility-opened`;
const SELECT_ALL_ITEM_CLASS = `${WIDGET_CLASS}-select-all-item`;
const INVISIBLE_STATE_CLASS = "dx-state-invisible";
const DISABLED_STATE_CLASS = "dx-state-disabled";
const SELECTED_ITEM_CLASS = "dx-state-selected";
const EXPAND_EVENT_NAMESPACE = "dxTreeView_expand";
const DATA_ITEM_ID = "data-item-id";
const ITEM_URL_CLASS = "dx-item-url";
const CHECK_BOX_CLASS = "dx-checkbox";
const CHECK_BOX_ICON_CLASS = "dx-checkbox-icon";
const ROOT_NODE_CLASS = `${WIDGET_CLASS}-root-node`;
const EXPANDER_ICON_STUB_CLASS = exports.EXPANDER_ICON_STUB_CLASS = `${WIDGET_CLASS}-expander-icon-stub`;
class TreeViewBase extends _hierarchical_collection_widget.default {
_supportedKeys() {
const click = e => {
const {
focusedElement: focusedElement
} = this.option();
const $itemElement = (0, _renderer.default)(focusedElement);
if (!$itemElement.length) {
return
}
e.target = $itemElement.get(0);
e.currentTarget = $itemElement.get(0);
this._processItemClick(e, $itemElement.children(`.${ITEM_CLASS}`));
const {
expandEvent: expandEvent
} = this.option();
const expandEventName = this._getEventNameByOption(expandEvent);
const expandByClick = expandEventName === (0, _utils.addNamespace)(_click.name, "dxTreeView_expand");
if (expandByClick) {
this._expandEventHandler(e)
}
};
const select = e => {
e.preventDefault();
const {
focusedElement: focusedElement
} = this.option();
const $focusedElement = (0, _renderer.default)(focusedElement);
const checkboxInstance = this._getCheckBoxInstance($focusedElement);
const {
disabled: disabled,
value: value
} = checkboxInstance.option();
if (!disabled) {
const currentState = value;
this._updateItemSelection(!currentState, $focusedElement.find(`.${ITEM_CLASS}`).get(0), e)
}
};
const toggleExpandedNestedItems = (state, e) => {
const {
expandAllEnabled: expandAllEnabled
} = this.option();
if (!expandAllEnabled) {
return
}
e.preventDefault();
const {
focusedElement: focusedElement
} = this.option();
const $rootElement = (0, _renderer.default)(focusedElement);
if (!$rootElement.length) {
return
}
const rootItem = this._getItemData($rootElement.find(`.${ITEM_CLASS}`));
this._toggleExpandedNestedItems([rootItem], state)
};
return _extends({}, super._supportedKeys(), {
enter: this._showCheckboxes() ? select : click,
space: this._showCheckboxes() ? select : click,
asterisk: e => {
toggleExpandedNestedItems(true, e)
},
minus: e => {
toggleExpandedNestedItems(false, e)
}
})
}
_toggleExpandedNestedItems(items, state) {
if (!items) {
return
}
for (let i = 0, len = items.length; i < len; i += 1) {
const item = items[i];
const node = this._dataAdapter.getNodeByItem(item);
this._toggleExpandedState(node, state);
this._toggleExpandedNestedItems(item.items, state)
}
}
_getNodeElement(node, cache) {
const key = this._encodeString(node.internalFields.key);
if (cache) {
if (!cache.$nodeByKey) {
cache.$nodeByKey = {};
const $nodes = this.$element().find(`.${NODE_CLASS}`);
$nodes.each(((_index, element) => {
const $node = (0, _renderer.default)(element);
const nodeKey = $node.attr(DATA_ITEM_ID);
cache.$nodeByKey[nodeKey] = $node;
return true
}))
}
return cache.$nodeByKey[key] || (0, _renderer.default)()
}
const element = this.$element().get(0).querySelector(`[${DATA_ITEM_ID}="${key}"]`);
return (0, _renderer.default)(element)
}
_widgetClass() {
return WIDGET_CLASS
}
_getDefaultOptions() {
const defaultOptions = _extends({}, super._getDefaultOptions(), {
animationEnabled: true,
dataStructure: "tree",
deferRendering: true,
expandAllEnabled: false,
hasItemsExpr: "hasItems",
selectNodesRecursive: true,
expandNodesRecursive: true,
showCheckBoxesMode: "none",
expandIcon: null,
collapseIcon: null,
selectAllText: _message.default.format("dxList-selectAll"),
onItemSelectionChanged: null,
onItemExpanded: null,
onItemCollapsed: null,
scrollDirection: "vertical",
useNativeScrolling: true,
virtualModeEnabled: false,
rootValue: 0,
focusStateEnabled: false,
selectionMode: "multiple",
expandEvent: "dblclick",
selectByClick: false,
createChildren: null,
onSelectAllValueChanged: null,
_supportItemUrl: false
});
return (0, _extend.extend)(true, defaultOptions, {
integrationOptions: {
useDeferUpdateForTemplates: false
}
})
}
_defaultOptionsRules() {
return super._defaultOptionsRules().concat([{
device: () => !_m_support.default.nativeScrolling,
options: {
useNativeScrolling: false
}
}])
}
_initSelectedItems() {}
_syncSelectionOptions() {
return (0, _deferred.Deferred)().resolve().promise()
}
_fireSelectionChanged() {
this._createActionByOption("onSelectionChanged", {
excludeValidators: ["disabled", "readOnly"]
})()
}
_createSelectAllValueChangedAction() {
this._selectAllValueChangedAction = this._createActionByOption("onSelectAllValueChanged", {
excludeValidators: ["disabled", "readOnly"]
})
}
_fireSelectAllValueChanged(value) {
var _this$_selectAllValue;
null === (_this$_selectAllValue = this._selectAllValueChangedAction) || void 0 === _this$_selectAllValue || _this$_selectAllValue.call(this, {
value: value
})
}
_checkBoxModeChange(value, previousValue) {
var _this$_$selectAllItem;
const {
searchEnabled: searchEnabled
} = this.option();
const previousSelectAllEnabled = this._selectAllEnabled(previousValue);
const previousItemsContainer = this._itemContainer(searchEnabled, previousSelectAllEnabled);
this._detachClickEvent(previousItemsContainer);
this._detachExpandEvent(previousItemsContainer);
if ("none" === previousValue || "none" === value) {
return
}
const selectAllExists = null === (_this$_$selectAllItem = this._$selectAllItem) || void 0 === _this$_$selectAllItem ? void 0 : _this$_$selectAllItem.length;
switch (value) {
case "selectAll":
if (!selectAllExists) {
this._createSelectAllValueChangedAction();
this._renderSelectAllItem()
}
break;
case "normal":
if (selectAllExists) {
var _this$_$selectAllItem2;
null === (_this$_$selectAllItem2 = this._$selectAllItem) || void 0 === _this$_$selectAllItem2 || _this$_$selectAllItem2.remove();
delete this._$selectAllItem
}
}
}
_removeSelection() {
(0, _iterator.each)(this._dataAdapter.getFullData(), ((_index, node) => {
if (!this._hasChildren(node)) {
return
}
this._dataAdapter.toggleSelection(node.internalFields.key, false, true)
}))
}
_optionChanged(args) {
const {
name: name,
value: value,
previousValue: previousValue
} = args;
switch (name) {
case "selectAllText":
if (this._$selectAllItem) {
this._$selectAllItem.dxCheckBox("instance").option("text", value)
}
break;
case "showCheckBoxesMode":
this._checkBoxModeChange(value, previousValue);
this._invalidate();
break;
case "scrollDirection":
this.getScrollable().option("direction", value);
break;
case "useNativeScrolling":
this.getScrollable().option("useNative", value);
break;
case "items":
delete this._$selectAllItem;
super._optionChanged(args);
break;
case "dataSource":
super._optionChanged(args);
this._initDataAdapter();
this._filter = {};
break;
case "hasItemsExpr":
this._initAccessors();
this.repaint();
break;
case "expandEvent":
this._attachExpandEvent();
break;
case "deferRendering":
case "dataStructure":
case "rootValue":
case "createChildren":
case "expandNodesRecursive":
case "onItemSelectionChanged":
case "onItemExpanded":
case "onItemCollapsed":
case "expandAllEnabled":
case "animationEnabled":
case "virtualModeEnabled":
case "selectByClick":
case "_supportItemUrl":
break;
case "selectionMode":
this._initDataAdapter();
super._optionChanged(args);
break;
case "onSelectAllValueChanged":
this._createSelectAllValueChangedAction();
break;
case "selectNodesRecursive":
this._dataAdapter.setOption("recursiveSelection", args.value ?? false);
this.repaint();
break;
case "expandIcon":
case "collapseIcon":
this.repaint();
break;
default:
super._optionChanged(args)
}
}
_initDataSource() {
if (this._useCustomChildrenLoader()) {
this._loadChildrenByCustomLoader(null).done((newItems => {
if (null !== newItems && void 0 !== newItems && newItems.length) {
this.option("items", newItems)
}
}))
} else {
super._initDataSource();
if (this._isVirtualMode()) {
this._initVirtualMode()
}
}
}
_initVirtualMode() {
const filter = this._filter;
if (!filter.custom) {
filter.custom = this._dataSource.filter()
}
if (!filter.internal) {
const {
parentIdExpr: parentIdExpr,
rootValue: rootValue
} = this.option();
filter.internal = [parentIdExpr, rootValue]
}
}
_useCustomChildrenLoader() {
const {
createChildren: createChildren
} = this.option();
return (0, _type.isFunction)(createChildren) && this._isDataStructurePlain()
}
_loadChildrenByCustomLoader(parentNode) {
const {
createChildren: createChildren
} = this.option();
const invocationResult = null === createChildren || void 0 === createChildren ? void 0 : createChildren.call(this, parentNode);
if (Array.isArray(invocationResult)) {
return (0, _deferred.Deferred)().resolve(invocationResult).promise()
}
if (invocationResult && (0, _type.isFunction)(invocationResult.then)) {
return (0, _deferred.fromPromise)(invocationResult)
}
return (0, _deferred.Deferred)().resolve([]).promise()
}
_combineFilter() {
var _this$_filter$custom;
if (!(null !== (_this$_filter$custom = this._filter.custom) && void 0 !== _this$_filter$custom && _this$_filter$custom.length)) {
return this._filter.internal
}
return [this._filter.custom, this._filter.internal]
}
_dataSourceLoadErrorHandler() {
this._renderEmptyMessage()
}
_init() {
this._filter = {};
super._init();
this._activeStateUnit = `.${ITEM_CLASS}`;
this._initStoreChangeHandlers()
}
_dataSourceChangedHandler(newItems) {
const {
items: items = []
} = this.option();
if (this._initialized && this._isVirtualMode() && items.length) {
return
}
this.option("items", newItems)
}
_removeTreeViewLoadIndicator() {
if (!this._treeViewLoadIndicator) {
return
}
this._treeViewLoadIndicator.remove();
this._treeViewLoadIndicator = null
}
_createTreeViewLoadIndicator() {
this._treeViewLoadIndicator = (0, _renderer.default)("<div>").addClass(LOAD_INDICATOR_CLASS);
this._createComponent(this._treeViewLoadIndicator, _load_indicator.default, {});
return this._treeViewLoadIndicator
}
_dataSourceLoadingChangedHandler(isLoading) {
let resultFilter;
if (this._isVirtualMode()) {
resultFilter = this._combineFilter();
this._dataSource.filter(resultFilter)
}
if (isLoading && !this._dataSource.isLoaded()) {
this.option("items", []);
const $wrapper = (0, _renderer.default)("<div>").addClass(LOAD_INDICATOR_WRAPPER_CLASS);
this._createTreeViewLoadIndicator().appendTo($wrapper);
this.itemsContainer().append($wrapper);
if (this._isVirtualMode() && this._dataSource.filter() !== resultFilter) {
this._dataSource.filter([])
}
} else {
this._removeTreeViewLoadIndicator()
}
}
_initStoreChangeHandlers() {
var _this$_dataSource;
const {
dataStructure: dataStructure
} = this.option();
if ("plain" !== dataStructure) {
return
}
null === (_this$_dataSource = this._dataSource) || void 0 === _this$_dataSource || _this$_dataSource.store().on("inserted", (newItem => {
const {
items: items = []
} = this.option();
this.option().items = items.concat(newItem);
this._dataAdapter.addItem(newItem);
if (!this._dataAdapter.isFiltered(newItem)) {
return
}
this._updateLevel(this._parentIdGetter(newItem))
})).on("removed", (removedKey => {
const node = this._dataAdapter.getNodeByKey(removedKey);
if ((0, _type.isDefined)(node)) {
const {
items: items = []
} = this.option();
const index = this._dataAdapter.getIndexByKey(node.internalFields.key);
items[index] = 0;
this._markChildrenItemsToRemove(node);
this._removeItems();
this._dataAdapter.removeItem(removedKey);
this._updateLevel(this._parentIdGetter(node))
}
}))
}
_markChildrenItemsToRemove(node) {
const keys = null === node || void 0 === node ? void 0 : node.internalFields.childrenKeys;
(0, _iterator.each)(keys, ((_index, key) => {
const {
items: items = []
} = this.option();
const index = this._dataAdapter.getIndexByKey(key);
items[index] = 0;
this._markChildrenItemsToRemove(this._dataAdapter.getNodeByKey(key))
}))
}
_removeItems() {
const items = (0, _extend.extend)(true, [], this.option("items"));
let counter = 0;
(0, _iterator.each)(items, ((index, item) => {
if (!item) {
this.option("items").splice(index - counter, 1);
counter += 1
}
}))
}
_updateLevel(parentId) {
const $container = this._getContainerByParentKey(parentId);
this._renderNodes(this._dataAdapter.getChildrenNodes(parentId), $container)
}
_getOldContainer($itemElement) {
if ($itemElement.length) {
return $itemElement.children(`.${NODE_CONTAINER_CLASS}`)
}
const scrollable = this.getScrollable();
if (scrollable) {
return (0, _renderer.default)(scrollable.content()).children()
}
return (0, _renderer.default)()
}
_getContainerByParentKey(parentId) {
const node = this._dataAdapter.getNodeByKey(parentId);
const $itemElement = node ? this._getNodeElement(node) : (0, _renderer.default)();
this._getOldContainer($itemElement).remove();
const $container = this._renderNodeContainer($itemElement);
if (this._isRootLevel(parentId)) {
const scrollable = this.getScrollable();
if (!scrollable) {
this._renderScrollableContainer()
}(0, _renderer.default)(scrollable.content()).append($container)
}
return $container
}
_isRootLevel(parentId) {
const {
rootValue: rootValue
} = this.option();
return parentId === rootValue
}
_getAccessors() {
const accessors = super._getAccessors();
accessors.push("hasItems");
return accessors
}
_getDataAdapterOptions() {
var _this$_dataSource2, _this$_dataSource3, _this$_dataSource3$lo;
const {
rootValue: rootValue,
expandNodesRecursive: expandNodesRecursive = true,
selectionRequired: selectionRequired = false,
dataStructure: dataStructure = "tree"
} = this.option();
return {
rootValue: rootValue,
multipleSelection: !this._isSingleSelection(),
recursiveSelection: this._isRecursiveSelection(),
recursiveExpansion: expandNodesRecursive,
searchValue: "",
selectionRequired: selectionRequired,
dataType: dataStructure,
sort: null === (_this$_dataSource2 = this._dataSource) || void 0 === _this$_dataSource2 ? void 0 : _this$_dataSource2.sort(),
langParams: null === (_this$_dataSource3 = this._dataSource) || void 0 === _this$_dataSource3 || null === (_this$_dataSource3$lo = _this$_dataSource3.loadOptions) || void 0 === _this$_dataSource3$lo || null === (_this$_dataSource3$lo = _this$_dataSource3$lo.call(_this$_dataSource3)) || void 0 === _this$_dataSource3$lo ? void 0 : _this$_dataSource3$lo.langParams
}
}
_initMarkup() {
this._renderScrollableContainer();
this._renderEmptyMessage(this._dataAdapter.getRootNodes());
super._initMarkup();
this._setAriaRole()
}
_setAriaRole() {
const {
items: items
} = this.option();
if (null !== items && void 0 !== items && items.length) {
this.setAria({
role: "tree"
})
}
}
_renderContentImpl() {
const $nodeContainer = this._renderNodeContainer();
(0, _renderer.default)(this.getScrollable().content()).append($nodeContainer);
const {
items: items
} = this.option();
if (!(null !== items && void 0 !== items && items.length)) {
return
}
this._renderNodes(this._dataAdapter.getRootNodes(), $nodeContainer);
this._attachExpandEvent();
if (this._selectAllEnabled()) {
this._createSelectAllValueChangedAction();
this._renderSelectAllItem($nodeContainer)
}
}
_isVirtualMode() {
const {
virtualModeEnabled: virtualModeEnabled,
dataSource: dataSource
} = this.option();
return !!virtualModeEnabled && this._isDataStructurePlain() && !!dataSource
}
_isDataStructurePlain() {
const {
dataStructure: dataStructure
} = this.option();
return "plain" === dataStructure
}
_fireContentReadyAction() {
const dataSource = this.getDataSource();
const skipContentReadyAction = dataSource && !dataSource.isLoaded() || this._skipContentReadyAndItemExpanded;
const scrollable = this.getScrollable();
if (scrollable && (0, _window.hasWindow)()) {
scrollable.update()
}
if (!skipContentReadyAction) {
super._fireContentReadyAction()
}
if (scrollable && (0, _window.hasWindow)()) {
scrollable.update()
}
}
_renderScrollableContainer() {
const {
useNativeScrolling: useNativeScrolling,
scrollDirection: scrollDirection
} = this.option();
this._scrollable = this._createComponent((0, _renderer.default)("<div>").appendTo(this.$element()), _scrollable.default, {
useNative: useNativeScrolling,
direction: scrollDirection,
useKeyboard: false
})
}
_renderNodeContainer($parent) {
const $container = (0, _renderer.default)("<ul>").addClass(NODE_CONTAINER_CLASS);
this.setAria("role", "group", $container);
if (null !== $parent && void 0 !== $parent && $parent.length) {
const itemData = this._getItemData($parent.children(`.${ITEM_CLASS}`));
if (this._expandedGetter(itemData)) {
$container.addClass(OPENED_NODE_CONTAINER_CLASS)
}
$container.appendTo($parent)
}
return $container
}
_createDOMElement($nodeContainer, node) {
var _this$_displayGetter, _node$internalFields;
const $node = (0, _renderer.default)("<li>").addClass(NODE_CLASS).attr(DATA_ITEM_ID, this._encodeString(node.internalFields.key)).prependTo($nodeContainer);
const attrs = {
role: "treeitem",
label: (null === (_this$_displayGetter = this._displayGetter) || void 0 === _this$_displayGetter ? void 0 : _this$_displayGetter.call(this, node.internalFields.item)) ?? "",
level: this._getLevel($nodeContainer)
};
const hasChildNodes = !!(null !== node && void 0 !== node && null !== (_node$internalFields = node.internalFields) && void 0 !== _node$internalFields && null !== (_node$internalFields = _node$internalFields.childrenKeys) && void 0 !== _node$internalFields && _node$internalFields.length);
if (hasChildNodes) {
attrs.expanded = node.internalFields.expanded ?? false
}
this.setAria(attrs, $node);
return $node
}
_getLevel($nodeContainer) {
const parent = $nodeContainer.parent();
return parent.hasClass("dx-scrollable-content") ? 1 : parseInt(parent.attr("aria-level") ?? "0", 10) + 1
}
_showCheckboxes() {
const {
showCheckBoxesMode: showCheckBoxesMode
} = this.option();
return "none" !== showCheckBoxesMode
}
_hasCustomExpanderIcons() {
const {
expandIcon: expandIcon,
collapseIcon: collapseIcon
} = this.option();
return !!expandIcon || !!collapseIcon
}
_selectAllEnabled(showCheckBoxesMode) {
const {
showCheckBoxesMode: currentShowCheckBoxesMode
} = this.option();
const mode = showCheckBoxesMode ?? currentShowCheckBoxesMode;
return "selectAll" === mode && !this._isSingleSelection()
}
_renderNodes(nodes, $nodeContainer) {
const length = nodes.length - 1;
for (let i = length; i >= 0; i -= 1) {
this._renderItem(i, nodes[i], $nodeContainer)
}
this._renderedItemsCount += nodes.length
}
_renderItem(nodeIndex, node, $nodeContainer) {
const $node = this._createDOMElement($nodeContainer, node);
const nodeData = node.internalFields;
const showCheckBox = this._showCheckboxes();
$node.addClass(showCheckBox ? ITEM_WITH_CHECKBOX_CLASS : ITEM_WITHOUT_CHECKBOX_CLASS);
$node.toggleClass("dx-state-invisible", false === nodeData.item.visible);
if (this._hasCustomExpanderIcons()) {
$node.addClass(ITEM_WITH_CUSTOM_EXPANDER_ICON_CLASS);
$nodeContainer.addClass(CUSTOM_EXPANDER_ICON_ITEM_CONTAINER_CLASS)
}
this.setAria("selected", nodeData.selected, $node);
this._toggleSelectedClass($node, nodeData.selected);
if (nodeData.disabled) {
this.setAria("disabled", nodeData.disabled, $node)
}
super._renderItem(this._renderedItemsCount + nodeIndex, nodeData.item, $node);
const parent = this._getNode(node.internalFields.parentKey);
if (!parent) {
$node.addClass(ROOT_NODE_CLASS)
}
if (false !== nodeData.item.visible) {
this._renderChildren($node, node)
}
return $node
}
_setAriaSelectionAttribute() {}
_renderChildren($node, node) {
if (!this._hasChildren(node)) {
this._addLeafClass($node);
(0, _renderer.default)("<div>").addClass(EXPANDER_ICON_STUB_CLASS).appendTo(this._getItem($node));
return
}
if (this._hasCustomExpanderIcons()) {
this._renderCustomExpanderIcons($node, node)
} else {
this._renderDefaultExpanderIcons($node, node)
}
if (this._shouldRenderSublevel(node.internalFields.expanded)) {
this._loadSublevel(node).done((childNodes => {
this._renderSublevel($node, this._getActualNode(node), childNodes)
}))
}
}
_shouldRenderSublevel(expanded) {
const {
deferRendering: deferRendering
} = this.option();
return expanded || !deferRendering
}
_getActualNode(cachedNode) {
return this._dataAdapter.getNodeByKey(cachedNode.internalFields.key)
}
_hasChildren(node) {
if (this._isVirtualMode() || this._useCustomChildrenLoader()) {
return false !== this._hasItemsGetter(node.internalFields.item)
}
return super._hasChildren(node)
}
_loadSublevel(node) {
const deferred = (0, _deferred.Deferred)();
const childrenNodes = this._getChildNodes(node);
if (childrenNodes.length) {
deferred.resolve(childrenNodes)
} else {
this._loadNestedItems(node).done((items => {
deferred.resolve(this._dataAdapter.getNodesByItems(items))
}))
}
return deferred.promise()
}
_getItemExtraPropNames() {
return ["url", "linkAttr"]
}
_addContent($container, itemData) {
const {
html: html,
url: url
} = itemData;
const {
_supportItemUrl: _supportItemUrl
} = this.option();
if (_supportItemUrl && url) {
$container.html(html);
const link = this._getLinkContainer(this._getIconContainer(itemData), this._getTextContainer(itemData), itemData);
$container.append(link)
} else {
super._addContent($container, itemData)
}
}
_postprocessRenderItem(args) {
const {
itemData: itemData,
itemElement: itemElement
} = args;
if (this._showCheckboxes()) {
this._renderCheckBox(itemElement, this._getNode(itemData))
}
super._postprocessRenderItem(args)
}
_renderSublevel($node, node, childNodes) {
const $nestedNodeContainer = this._renderNodeContainer($node);
const keySet = new Set(node.internalFields.childrenKeys);
const childNodesByChildrenKeys = childNodes.filter((childNode => keySet.has(childNode.internalFields.key)));
this._renderNodes(childNodesByChildrenKeys, $nestedNodeContainer);
if (childNodesByChildrenKeys.length && !node.internalFields.selected) {
const firstChild = childNodesByChildrenKeys[0];
this._updateParentsState(firstChild, this._getNodeElement(firstChild))
}
this._normalizeIconState($node, childNodesByChildrenKeys.length);
if (node.internalFields.expanded) {
$nestedNodeContainer.addClass(OPENED_NODE_CONTAINER_CLASS)
}
}
_executeItemRenderAction(itemIndex, itemData, itemElement) {
const node = this._getNode(itemElement);
this._getItemRenderAction()({
itemElement: itemElement,
itemIndex: itemIndex,
itemData: itemData,
node: this._dataAdapter.getPublicNode(node)
})
}
_addLeafClass($node) {
$node.addClass(IS_LEAF)
}
_expandEventHandler(e) {
const $nodeElement = (0, _renderer.default)(e.currentTarget.parentNode);
if (!$nodeElement.hasClass(IS_LEAF)) {
this._toggleExpandedState(e.currentTarget, void 0, e)
}
}
_attachExpandEvent() {
const {
expandEvent: expandEvent
} = this.option();
const expandedEventName = this._getEventNameByOption(expandEvent);
const $itemsContainer = this._itemContainer();
this._detachExpandEvent($itemsContainer);
_events_engine.default.on($itemsContainer, expandedEventName, this._itemSelector(), this._expandEventHandler.bind(this))
}
_detachExpandEvent(itemsContainer) {
_events_engine.default.off(itemsContainer, ".dxTreeView_expand", this._itemSelector())
}
_getEventNameByOption(name) {
const event = "click" === name ? _click.name : _double_click.name;
return (0, _utils.addNamespace)(event, "dxTreeView_expand")
}
_getNode(identifier) {
if (!(0, _type.isDefined)(identifier)) {
return null
}
if ((0, _type.isPrimitive)(identifier)) {
return this._dataAdapter.getNodeByKey(identifier)
}
if ((0, _type.isPlainObject)(identifier) && "internalFields" in identifier) {
return identifier
}
const itemElement = (0, _renderer.default)(identifier).get(0);
if (!itemElement) {
return null
}
if (_dom_adapter.default.isElementNode(itemElement)) {
return this._getNodeByElement(itemElement)
}
return this._dataAdapter.getNodeByItem(itemElement)
}
_getNodeByElement(itemElement) {
const $node = (0, _renderer.default)(itemElement).closest(`.${NODE_CLASS}`);
const itemKeyAttr = $node.attr(DATA_ITEM_ID);
if (!(0, _type.isDefined)(itemKeyAttr)) {
return null
}
const key = this._decodeString(itemKeyAttr);
return this._dataAdapter.getNodeByKey(key)
}
_toggleExpandedState(itemElement, state, e) {
const node = this._getNode(itemElement);
if (!node) {
return (0, _deferred.Deferred)().reject().promise()
}
if (node.internalFields.disabled) {
return (0, _deferred.Deferred)().reject().promise()
}
const currentState = node.internalFields.expanded;
if (currentState === state) {
return (0, _deferred.Deferred)().resolve().promise()
}
if (this._hasChildren(node)) {
const $node = this._getNodeElement(node);
if ($node.find(`.${NODE_LOAD_INDICATOR_CLASS}:not(.dx-state-invisible)`).length) {
return (0, _deferred.Deferred)().reject().promise()
}
if (!currentState && !this._nodeHasRenderedChildren($node)) {
this._createLoadIndicator($node)
}
}
const newState = state ?? !currentState;
this._dataAdapter.toggleExpansion(node.internalFields.key, newState);
return this._updateExpandedItemsUI(node, newState, e)
}
_nodeHasRenderedChildren($node) {
const $nodeContainer = $node.children(`.${NODE_CONTAINER_CLASS}`);
return $nodeContainer.not(":empty").length
}
_getItem($node) {
return $node.children(`.${ITEM_CLASS}`).eq(0)
}
_createLoadIndicator($node) {
const $treeviewItem = this._getItem($node);
this._createComponent((0, _renderer.default)("<div>").addClass(NODE_LOAD_INDICATOR_CLASS), _load_indicator.default, {}).$element().appendTo($treeviewItem);
const $icon = $treeviewItem.children(`.${TOGGLE_ITEM_VISIBILITY_CLASS},.${CUSTOM_EXPAND_ICON_CLASS}`);
$icon.hide()
}
_renderExpanderIcon($node, node, $icon, iconClass) {
$icon.appendTo(this._getItem($node));
$icon.addClass(iconClass);
if (node.internalFields.disabled) {
$icon.addClass("dx-state-disabled")
}
this._renderToggleItemVisibilityIconClick($icon, node)
}
_renderDefaultExpanderIcons($node, node) {
const $treeViewItem = this._getItem($node);
const $icon = (0, _renderer.default)("<div>").addClass(TOGGLE_ITEM_VISIBILITY_CLASS).appendTo($treeViewItem);
if (node.internalFields.expanded) {
$icon.addClass(TOGGLE_ITEM_VISIBILITY_OPENED_CLASS);
$node.parent().addClass(OPENED_NODE_CONTAINER_CLASS)
}
if (node.internalFields.disabled) {
$icon.addClass("dx-state-disabled")
}
this._renderToggleItemVisibilityIconClick($icon, node)
}
_renderCustomExpanderIcons($node, node) {
const {
expandIcon: expandIcon,
collapseIcon: collapseIcon
} = this.option();
const $expandIcon = (0, _icon.getImageContainer)(expandIcon ?? collapseIcon) ?? (0, _renderer.default)();
const $collapseIcon = (0, _icon.getImageContainer)(collapseIcon ?? expandIcon) ?? (0, _renderer.default)();
this._renderExpanderIcon($node, node, $expandIcon, CUSTOM_EXPAND_ICON_CLASS);
this._renderExpanderIcon($node, node, $collapseIcon, CUSTOM_COLLAPSE_ICON_CLASS);
const isNodeExpanded = node.internalFields.expanded;
if (isNodeExpanded) {
$node.parent().addClass(OPENED_NODE_CONTAINER_CLASS)
}
this._toggleCustomExpanderIcons($expandIcon, $collapseIcon, isNodeExpanded)
}
_renderToggleItemVisibilityIconClick($icon, node) {
const eventName = (0, _utils.addNamespace)(_click.name, this.NAME);
_events_engine.default.off($icon, eventName);
_events_engine.default.on($icon, eventName, (e => {
this._toggleExpandedState(node.internalFields.key, void 0, e);
return false
}))
}
_toggleCustomExpanderIcons($expandIcon, $collapseIcon, isNodeExpanded) {
$collapseIcon.toggle(isNodeExpanded);
$expandIcon.toggle(!isNodeExpanded)
}
_updateExpandedItemsUI(node, state, e) {
const $node = this._getNodeElement(node);
const isHiddenNode = !$node.length || state && $node.is(":hidden");
const {
expandNodesRecursive: expandNodesRecursive
} = this.option();
if (expandNodesRecursive && isHiddenNode) {
const parentNode = this._getNode(node.internalFields.parentKey);
if (parentNode) {
this._updateExpandedItemsUI(parentNode, state, e)
}
}
if (!this._hasCustomExpanderIcons()) {
const $icon = this._getItem($node).children(`.${TOGGLE_ITEM_VISIBILITY_CLASS}`);
$icon.toggleClass(TOGGLE_ITEM_VISIBILITY_OPENED_CLASS, state)
} else if (this._nodeHasRenderedChildren($node)) {
const $item = this._getItem($node);
const $childExpandIcons = $item.children(`.${CUSTOM_EXPAND_ICON_CLASS}`);
const $childCollapseIcons = $item.children(`.${CUSTOM_COLLAPSE_ICON_CLASS}`);
this._toggleCustomExpanderIcons($childExpandIcons, $childCollapseIcons, state)
}
const $nodeContainer = $node.children(`.${NODE_CONTAINER_CLASS}`);
const nodeContainerExists = $nodeContainer.length > 0;
const completionCallback = (0, _deferred.Deferred)();
if (!state || nodeContainerExists && !$nodeContainer.is(":empty")) {
this._animateNodeContainer(node, state, e, completionCallback);
return completionCallback.promise()
}
if (0 === node.internalFields.childrenKeys.length && (this._isVirtualMode() || this._useCustomChildrenLoader())) {
this._loadNestedItemsWithUpdate(node, state, e, completionCallback);
return completionCallback.promise()
}
this._renderSublevel($node, node, this._getChildNodes(node));
this._fireContentReadyAction();
this._animateNodeContainer(node, state, e, completionCallback);
return completionCallback.promise()
}
_loadNestedItemsWithUpdate(node, state, e, completionCallback) {
const $node = this._getNodeElement(node);
this._loadNestedItems(node).done((items => {
const actualNodeData = this._getActualNode(node);
this._renderSublevel($node, actualNodeData, this._dataAdapter.getNodesByItems(items));
if (!(null !== items && void 0 !== items && items.length)) {
completionCallback.resolve();
return
}
this._fireContentReadyAction();
this._animateNodeContainer(actualNodeData, state, e, completionCallback)
}))
}
_loadNestedItems(node) {
if (this._useCustomChildrenLoader()) {
const publicNode = this._dataAdapter.getPublicNode(node);
return this._loadChildrenByCustomLoader(publicNode).done((newItems => {
if (!this._areNodesExists(newItems)) {
this._appendItems(newItems)
}
}))
}
if (!this._isVirtualMode()) {
return (0, _deferred.Deferred)().resolve([]).promise()
}
const {
parentIdExpr: parentIdExpr
} = this.option();
this._filter.internal = [parentIdExpr, node.internalFields.key];
this._dataSource.filter(this._combineFilter());
return this._dataSource.load().done((newItems => {
if (!this._areNodesExists(newItems)) {
this._appendItems(newItems)
}
}))
}
_areNodesExists(newItems) {
const keyOfRootItem = this.keyOf(newItems[0]);
const fullData = this._dataAdapter.getFullData();
return !!this._dataAdapter.getNodeByKey(keyOfRootItem, fullData)
}
_appendItems(newItems) {
const {
items: items = []
} = this.option();
this.option().items = items.concat(newItems);
this._initDataAdapter()
}
_animateNodeContainer(node, state, e, completionCallback) {
const $node = this._getNodeElement(node);
const $nodeContainer = $node.children(`.${NODE_CONTAINER_CLASS}`);
if (node && completionCallback && 0 === $nodeContainer.length) {
completionCallback.resolve()
}
$nodeContainer.addClass(OPENED_NODE_CONTAINER_CLASS);
const nodeHeight = (0, _size.getHeight)($nodeContainer);
const {
animationEnabled: animationEnabled
} = this.option();
_animation.fx.stop($nodeContainer.get(0), true);
_animation.fx.animate($nodeContainer.get(0), {
type: "custom",
duration: animationEnabled ? 400 : 0,
from: {
maxHeight: state ? 0 : nodeHeight
},
to: {
maxHeight: state ? nodeHeight : 0
},
complete: () => {
$nodeContainer.css("maxHeight", "none");
$nodeContainer.toggleClass(OPENED_NODE_CONTAINER_CLASS, state);
this.setAria("expanded", state, $node);
this.getScrollable().update();
this._fireExpandedStateUpdatedEvent(state, node, e);
if (completionCallback) {
completionCallback.resolve()
}
}
})
}
_fireExpandedStateUpdatedEvent(isExpanded, node, e) {
if (!this._hasChildren(node) || this._skipContentReadyAndItemExpanded) {
return
}
const optionName = isExpanded ? "onItemExpanded" : "onItemCollapsed";
if ((0, _type.isDefined)(e)) {
this._itemDXEventHandler(e, optionName, {
node: this._dataAdapter.getPublicNode(node)
})
} else {
const target = this._getNodeElement(node);
const actionArgs = {
event: e,
node: this._dataAdapter.getPublicNode(node)
};
this._itemEventHandler(target, optionName, actionArgs)
}
}
_normalizeIconState($node, hasNewItems) {
const $loadIndicator = $node.find(`.${NODE_LOAD_INDICATOR_CLASS}`);
if ($loadIndicator.length) {
var _LoadIndicator$getIns;
null === (_LoadIndicator$getIns = _load_indicator.default.getInstance($loadIndicator)) || void 0 === _LoadIndicator$getIns || _LoadIndicator$getIns.option("visible", false)
}
const $treeViewItem = this._getItem($node);
const $toggleItem = $treeViewItem.children(`.${CUSTOM_COLLAPSE_ICON_CLASS},.${TOGGLE_ITEM_VISIBILITY_CLASS}`);
if (hasNewItems) {
$toggleItem.show();
return
}
$toggleItem.removeClass(TOGGLE_ITEM_VISIBILITY_CLASS);
$node.addClass(IS_LEAF)
}
_emptyMessageContainer() {
const scrollable = this.getScrollable();
return scrollable ? (0, _renderer.default)(scrollable.content()) : super._emptyMessageContainer()
}
_renderContent() {
const {
items: items
} = this.option();
if (null !== items && void 0 !== items && items.length) {
this._contentAlreadyRendered = true
}
super._renderContent()
}
_renderSelectAllItem($container) {
const {
selectAllText: selectAllText,
focusStateEnabled: focusStateEnabled
} = this.option();
const $selectAllContainer = $container ?? this.$element().find(`.${NODE_CONTAINER_CLASS}`).first();
this._$selectAllItem = (0, _renderer.default)("<div>").addClass(SELECT_ALL_ITEM_CLASS);
const isAllSelected = this._dataAdapter.isAllSelected();
this._createComponent(this._$selectAllItem, _index2.default, {
value: isAllSelected,
elementAttr: {
"aria-label": _message.default.format("dxList-selectAll")
},
text: selectAllText,
focusStateEnabled: focusStateEnabled,
onValueChanged: event => {
this._onSelectAllCheckboxValueChanged(event)
},
onInitialized: event => {
const {
component: component
} = event;
component.registerKeyHandler("enter", (() => {
const {
value: value
} = component.option();
component.option("value", !value)
}))
}
});
this._toggleSelectedClass(this._$selectAllItem, isAllSelected);
$selectAllContainer.before(this._$selectAllItem)
}
_onSelectAllCheckboxValueChanged(args) {
this._toggleSelectAll(args);
this._fireSelectAllValueChanged(args.value)
}
_toggleSelectAll(args) {
this._dataAdapter.toggleSelectAll(args.value);
this._updateItemsUI();
this._fireSelectionChanged()
}
_renderCheckBox($node, node) {
const $checkbox = (0, _renderer.default)("<div>").appendTo($node);
this._createComponent($checkbox, _index2.default, {
value: null === node || void 0 === node ? void 0 : node.internalFields.selected,
onValueChanged: e => {
this._changeCheckboxValue(e)
},
focusStateEnabled: false,
elementAttr: {
"aria-label": _message.default.format("CheckState")
},
disabled: this._disabledGetter(node)
})
}
_toggleSelectedClass($node, value) {