devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
219 lines (218 loc) • 7.76 kB
JavaScript
/**
* DevExtreme (esm/__internal/ui/hierarchical_collection/m_hierarchical_collection_widget.js)
* Version: 25.1.3
* Build date: Wed Jun 25 2025
*
* Copyright (c) 2012 - 2025 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
import _extends from "@babel/runtime/helpers/esm/extends";
import devices from "../../../core/devices";
import $ from "../../../core/renderer";
import {
BindableTemplate
} from "../../../core/templates/bindable_template";
import {
noop
} from "../../../core/utils/common";
import {
compileGetter,
compileSetter
} from "../../../core/utils/data";
import {
extend
} from "../../../core/utils/extend";
import {
getImageContainer
} from "../../../core/utils/icon";
import {
each
} from "../../../core/utils/iterator";
import {
isFunction,
isObject
} from "../../../core/utils/type";
import CollectionWidgetAsync from "../../../ui/collection/ui.collection_widget.async";
import HierarchicalDataAdapter from "./m_data_adapter";
const DISABLED_STATE_CLASS = "dx-state-disabled";
const ITEM_URL_CLASS = "dx-item-url";
class HierarchicalCollectionWidget extends CollectionWidgetAsync {
_getDefaultOptions() {
return _extends({}, super._getDefaultOptions(), {
keyExpr: "id",
displayExpr: "text",
selectedExpr: "selected",
disabledExpr: "disabled",
itemsExpr: "items",
hoverStateEnabled: true,
parentIdExpr: "parentId",
expandedExpr: "expanded"
})
}
_defaultOptionsRules() {
return super._defaultOptionsRules().concat([{
device: () => "desktop" === devices.real().deviceType && !devices.isSimulator(),
options: {
focusStateEnabled: true
}
}])
}
_init() {
super._init();
this._initAccessors();
this._initDataAdapter();
this._initDynamicTemplates()
}
_initDataSource() {
var _this$_dataSource;
super._initDataSource();
null === (_this$_dataSource = this._dataSource) || void 0 === _this$_dataSource || _this$_dataSource.paginate(false)
}
_initDataAdapter() {
const accessors = this._createDataAdapterAccessors();
this._dataAdapter = new HierarchicalDataAdapter(extend({
dataAccessors: {
getters: accessors.getters,
setters: accessors.setters
},
items: this.option("items")
}, this._getDataAdapterOptions()))
}
_getDataAdapterOptions() {}
_getItemExtraPropNames() {}
_initDynamicTemplates() {
const fields = ["text", "html", "items", "icon"].concat(this._getItemExtraPropNames());
this._templateManager.addDefaultTemplates({
item: new BindableTemplate(this._addContent.bind(this), fields, this.option("integrationOptions.watchMethod"), {
text: this._displayGetter,
items: this._itemsGetter
})
})
}
_addContent($container, itemData) {
$container.html(itemData.html).append(this._getIconContainer(itemData)).append(this._getTextContainer(itemData))
}
_getLinkContainer(iconContainer, textContainer, itemData) {
const {
linkAttr: linkAttr,
url: url
} = itemData;
const linkAttributes = isObject(linkAttr) ? linkAttr : {};
return $("<a>").addClass("dx-item-url").attr(_extends({}, linkAttributes, {
href: url
})).append(iconContainer).append(textContainer)
}
_getIconContainer(itemData) {
if (!itemData.icon) {
return
}
const $imageContainer = getImageContainer(itemData.icon);
if ($imageContainer.is("img")) {
var _this$NAME;
const componentName = null !== (_this$NAME = this.NAME) && void 0 !== _this$NAME && _this$NAME.startsWith("dxPrivateComponent") ? "" : `${this.NAME} `;
$imageContainer.attr("alt", `${componentName}item icon`)
}
return $imageContainer
}
_getTextContainer(itemData) {
return $("<span>").text(itemData.text)
}
_initAccessors() {
const that = this;
each(this._getAccessors(), ((_, accessor) => {
that._compileAccessor(accessor)
}));
this._compileDisplayGetter()
}
_getAccessors() {
return ["key", "selected", "items", "disabled", "parentId", "expanded"]
}
_getChildNodes(node) {
const that = this;
const arr = [];
each(node.internalFields.childrenKeys, ((_, key) => {
const childNode = that._dataAdapter.getNodeByKey(key);
arr.push(childNode)
}));
return arr
}
_hasChildren(node) {
return node && node.internalFields.childrenKeys.length
}
_compileAccessor(optionName) {
const getter = `_${optionName}Getter`;
const setter = `_${optionName}Setter`;
const optionExpr = this.option(`${optionName}Expr`);
if (!optionExpr) {
this[getter] = noop;
this[setter] = noop;
return
}
if (isFunction(optionExpr)) {
this[setter] = function(obj, value) {
obj[optionExpr()] = value
};
this[getter] = function(obj) {
return obj[optionExpr()]
};
return
}
this[getter] = compileGetter(optionExpr);
this[setter] = compileSetter(optionExpr)
}
_createDataAdapterAccessors() {
const that = this;
const accessors = {
getters: {},
setters: {}
};
each(this._getAccessors(), ((_, accessor) => {
const getterName = `_${accessor}Getter`;
const setterName = `_${accessor}Setter`;
const newAccessor = "parentId" === accessor ? "parentKey" : accessor;
accessors.getters[newAccessor] = that[getterName];
accessors.setters[newAccessor] = that[setterName]
}));
accessors.getters.display = !this._displayGetter ? itemData => itemData.text : this._displayGetter;
return accessors
}
_initMarkup() {
super._initMarkup();
this._addWidgetClass()
}
_addWidgetClass() {
this._focusTarget().addClass(this._widgetClass())
}
_widgetClass() {}
_renderItemFrame(index, itemData, $itemContainer) {
const $itemFrame = super._renderItemFrame.apply(this, arguments);
$itemFrame.toggleClass("dx-state-disabled", !!this._disabledGetter(itemData));
return $itemFrame
}
_optionChanged(args) {
switch (args.name) {
case "displayExpr":
case "keyExpr":
this._initAccessors();
this._initDynamicTemplates();
this.repaint();
break;
case "itemsExpr":
case "selectedExpr":
case "disabledExpr":
case "expandedExpr":
case "parentIdExpr":
this._initAccessors();
this._initDataAdapter();
this.repaint();
break;
case "items":
this._initDataAdapter();
super._optionChanged(args);
break;
default:
super._optionChanged(args)
}
}
}
export default HierarchicalCollectionWidget;