@openui5/sap.m
Version:
OpenUI5 UI Library sap.m
105 lines (88 loc) • 2.58 kB
JavaScript
/*!
* OpenUI5
* (c) Copyright 2026 SAP SE or an SAP affiliate company.
* Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
*/
// Provides control sap.m.StandardTreeItem.
sap.ui.define([
'./TreeItemBase',
'./library',
'sap/ui/core/IconPool',
'./Image',
'./StandardTreeItemRenderer'
],
function(TreeItemBase, library, IconPool, Image, StandardTreeItemRenderer) {
"use strict";
/**
* Constructor for a new StandardTreeItem.
*
* @param {string} [sId] ID for the new control, generated automatically if no id is given
* @param {object} [mSettings] Initial settings for the new control
*
* @class
* The <code>sap.m.StandardTreeItem</code> is a tree item providing a title, image, etc.
* @extends sap.m.TreeItemBase
*
* @author SAP SE
* @version 1.146.0
*
* @constructor
* @public
* @since 1.42.0
* @alias sap.m.StandardTreeItem
*/
var StandardTreeItem = TreeItemBase.extend("sap.m.StandardTreeItem", /** @lends sap.m.StandardTreeItem.prototype */ {
metadata : {
library : "sap.m",
properties : {
/**
* Defines the title of the item.
*/
title : {type : "string", group : "Misc", defaultValue : ""},
/**
* Defines the tree item icon.
*/
icon : {type : "sap.ui.core.URI", group : "Misc", defaultValue : null}
}
},
renderer: StandardTreeItemRenderer
});
/**
* Gets the image control to be rendered as Icon.
*
* @private
* @since 1.42.0
*/
StandardTreeItem.prototype._getIconControl = function() {
var sURI = this.getIcon();
if (this._oIconControl) {
this._oIconControl.setSrc(sURI);
return this._oIconControl;
}
this._oIconControl = IconPool.createControlByURI({
id: this.getId() + "-icon",
src: sURI,
useIconTooltip: false,
noTabStop: true
}, Image).setParent(this, null, true).addStyleClass("sapMSTIIcon");
return this._oIconControl;
};
StandardTreeItem.prototype.getContentAnnouncement = function() {
return this.getTitle();
};
StandardTreeItem.prototype.exit = function() {
TreeItemBase.prototype.exit.apply(this, arguments);
this.destroyControls(["Icon"]);
};
StandardTreeItem.prototype.setIcon = function(sIcon) {
var sOldIcon = this.getIcon();
this.setProperty("icon", sIcon);
// destroy the internal control if it is changed from Icon to Image or Image to Icon
if (this._oIconControl && (!sIcon || IconPool.isIconURI(sIcon) != IconPool.isIconURI(sOldIcon))) {
this._oIconControl.destroy("KeepDom");
this._oIconControl = undefined;
}
return this;
};
return StandardTreeItem;
});