@openui5/sap.ui.mdc 1.96.2 → 1.97.0

package/src/sap/ui/mdc/table/ResponsiveTableType.js

@@ -13,17 +13,17 @@ sap.ui.define([
 	var GrowingMode = library.GrowingMode;
 	var RowAction = library.RowAction;
 	/**
-	 * Constructor for a new ResponsiveTableType.
+	 * Constructor for a new <code>ResponsiveTableType</code>.
 	 *
-	 * @param {string} [sId] ID for the new object, generated automatically if no ID is given
+	 * @param {string} [sId] Optional ID for the new object; generated automatically if no non-empty ID is given
 	 * @param {object} [mSettings] initial settings for the new object
 	 * @class The table type info base class for the metadata driven table.
-	 *        <h3><b>Note:</b></h3>
-	 *        The control is experimental and the API/behaviour is not finalised and hence this should not be used for productive usage.
 	 * @extends sap.ui.mdc.table.TableTypeBase
 	 * @author SAP SE
 	 * @private
 	 * @experimental
+	 * @ui5-restricted sap.fe
+	 * MDC_PUBLIC_CANDIDATE
 	 * @since 1.65
 	 * @alias sap.ui.mdc.table.ResponsiveTableType
 	 * @ui5-metamodel This element also will be described in the UI5 (legacy) designtime metamodel
@@ -34,21 +34,21 @@ sap.ui.define([
 			library: "sap.ui.mdc",
 			properties: {
 				/**
-				 * See sap.ui.mdc.GrowingMode<br>
-				 * Defaults to Basic --> meaning only growing is enabled on ResponsiveTable
+				 * See <code>sap.ui.mdc.GrowingMode</code><br>
+				 * Defaults to Basic - meaning only growing is enabled on <code>ResponsiveTable</code>
 				 */
 				growingMode: {
 					type: "sap.ui.mdc.GrowingMode",
 					defaultValue: GrowingMode.Basic
 				},
 				/**
-				 * Controls the visibility of the Show / Hide Details button for the <code>ResponsiveTable</code> scenario.
+				 * Specifies whether the Show / Hide Details button for the <code>ResponsiveTable</code> scenario is shown.
 				 *
-				 * If the available screen space gets too narrow, the columns configured with <code>High</code> and <code>Medium</code>
-				 * importance move to the pop-in area while the columns with <code>Low</code> importance are hidden.
-				 * On mobile phones, the columns with <code>Medium</code> importance are also hidden.
-				 * As soon as the first column is hidden, this button appears in the table toolbar and gives the user
-				 * the possibility to toggle the visibility of the hidden columns in the pop-in area.
+				 * If the available screen space gets too narrow, the columns configured with <code>High</code> and <code>Medium</code> importance
+				 * move to the pop-in area, while the columns with <code>Low</code> importance are hidden.<br>
+				 * On mobile phones, the columns with <code>Medium</code> importance are also hidden.<br>
+				 * As soon as the first column is hidden, this button appears in the table toolbar and gives the user the possibility to toggle the
+				 * visibility of the hidden columns in the pop-in area.
 				 *
 				 * @since 1.79
 				 */
@@ -58,12 +58,11 @@ sap.ui.define([
 					defaultValue: false
 				},
 				/**
-				 * Defines which columns should be hidden instead of moved into the pop-in area
-				 * depending on their importance.
+				 * Defines which columns should be hidden instead of moved into the pop-in area depending on their importance.
 				 * See {@link sap.m.Column#getImportance} and {@link sap.m.Table#getHiddenInPopin} for more details.
 				 *
-				 * <b>Note:</b> To hide columns based on their importance, it's mandatory to set <code>showDetailsButton="true"</code>.
-				 * If no priority is given, the default configuration of {@link sap.ui.mdc.table.ResponsiveTableType#getShowDetailsButton} is used.
+				 * <b>Note:</b> To hide columns based on their importance, it's mandatory to set <code>showDetailsButton="true"</code>.<br>
+				 * If no priority is given, the default configuration of {@link sap.ui.mdc.table.ResponsiveTableType#getShowDetailsButton} is used.<br>
 				 * If this property is changed after the <code>MDCTable</code> has been initialized, the new changes take effect only when the
 				 * Show / Hide Details button is pressed a second time.
 				 *
@@ -237,11 +236,12 @@ sap.ui.define([
 	};
 
 	/**
-	 * Set property 'hiddenInPopin' on the inner ResponsiveTable to hide columns based on MDCTable configuration
-	 * of 'showDetailsButton' and 'detailsButtonSetting' if {@param bValue} is set to {true}.
+	 * Toggles the visibility of the Show Details button.<br>
+	 * If {@param bValue} is set to <code>true</code>, it sets the <code>hiddenInPopin</code> property on the inner <code>ResponsiveTable</code> to
+	 * hide columns based on <code>MDCTable</code> configuration (<code>showDetailsButton</code> and <code>detailsButtonSetting</code> properties).
 	 * Otherwise an empty array is set to show all columns.
 	 *
-	 * @param {boolean} bValue - indicator to hide details or not
+	 * @param {boolean} bValue - Whether to hide details and display the Show Details button
 	 * @private
 	 */
 	ResponsiveTableType.prototype._toggleShowDetails = function(bValue) {
@@ -274,10 +274,9 @@ sap.ui.define([
 	};
 
 	/**
-	 * Helper function to get the importance of the columns that should be hidden based on
-	 * MDCTable configuration.
+	 * Helper function to get the importance of the columns that should be hidden based on <code>MDCTable</code> configuration.
 	 *
-	 * @returns {array} sap.ui.core.Priority[]
+	 * @returns {array} sap.ui.core.Priority[] Array of column priorities
 	 * @private
 	 */
 	ResponsiveTableType.prototype._getImportanceToHide = function() {
@@ -294,9 +293,9 @@ sap.ui.define([
 	};
 
 	/**
-	 * Event handler when the table pop-in has changed.
+	 * Event handler called when the table pop-in has changed.
 	 *
-	 * @param {sap.ui.base.Event} oEvent - fired event object
+	 * @param {sap.ui.base.Event} oEvent - Event object
 	 * @private
 	 */
 	ResponsiveTableType.prototype._onPopinChanged = function(oEvent) {

package/src/sap/ui/mdc/table/RowSettings.js

@@ -12,17 +12,20 @@ sap.ui.define([
 	/**
 	 * Constructor for new RowSettings.
 	 *
-	 * @param {string} [sId] ID for the new element, generated automatically if no ID is given
-	 * @param {object} [mSettings] Initial settings for the new control
+	 * @param {string} [sId] Optional ID for the new object; generated automatically if no non-empty ID is given
+	 * @param {object} [mSettings] initial settings for the new control
 	 *
 	 * @class
-	 * The <code>RowSettings</code> control allows you to configure a row.
-	 * You can only use this control in the context of the <code>sap.ui.mdc.Table</code> control to define row settings.
+	 * The <code>RowSettings</code> control allows configuring a row.
+	 * This control can only be used in the context of <code>sap.ui.mdc.Table</code> control to define row settings.
 	 * @extends sap.ui.core.Element
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @constructor
+	 * @experimental
 	 * @private
+	 * @ui5-restricted sap.fe
+	 * MDC_PUBLIC_CANDIDATE
 	 * @alias sap.ui.mdc.table.RowSettings
 	 */
 
@@ -48,7 +51,6 @@ sap.ui.define([
 
 				/**
 				 * Defines the semantics of the {@link sap.ui.mdc.table.RowSettings#setHighlight highlight} property for accessibility purposes.
-				 *
 				 */
 				highlightText : {type : "string", group : "Misc", defaultValue : ""},
 

package/src/sap/ui/mdc/table/TableTypeBase.js

@@ -10,16 +10,16 @@ sap.ui.define([
 	"use strict";
 
 	/**
-	 * Constructor for a new TableTypeBase.
+	 * Constructor for a new <code>TableTypeBase</code>.
 	 *
-	 * @param {string} [sId] ID for the new object, generated automatically if no ID is given
+	 * @param {string} [sId] Optional ID for the new object; generated automatically if no non-empty ID is given
 	 * @param {object} [mSettings] initial settings for the new object
 	 * @class The table type info base class for the metadata driven table. Dummy/Base class with no implementation.
-	 *        <h3><b>Note:</b></h3>
-	 *        The control is experimental and the API/behaviour is not finalised and hence this should not be used for productive usage.
 	 * @extends sap.ui.core.Element
 	 * @author SAP SE
 	 * @private
+	 * @ui5-restricted sap.fe
+	 * MDC_PUBLIC_CANDIDATE
 	 * @abstract
 	 * @experimental
 	 * @since 1.65

package/src/sap/ui/mdc/table/V4AnalyticsPropertyHelper.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @extends sap.ui.mdc.table.PropertyHelper
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @private
 	 * @experimental
@@ -49,58 +49,23 @@ sap.ui.define([
 
 	/**
 	 * @inheritDoc
-	 * @override
 	 */
 	PropertyHelper.prototype.prepareProperty = function(oProperty) {
-		var sPropertyName = oProperty.getName();
-		var that = this;
-
 		TablePropertyHelper.prototype.prepareProperty.apply(this, arguments);
+		oProperty.aggregatable = oProperty.extension.defaultAggregate != null;
 
-		["isAggregatable", "getAggregatableProperties", "getDefaultAggregate"].forEach(function(sMethod) {
-			Object.defineProperty(oProperty, sMethod, {
-				value: function() {
-					return that[sMethod].call(that, sPropertyName);
-				}
-			});
-		});
-	};
-
-	function getExtensionAttribute(oPropertyHelper, sPropertyName, sAttributeName) {
-		var oProperty = oPropertyHelper.getProperty(sPropertyName);
-		return oProperty ? oProperty.extension[sAttributeName] : null;
-	}
-
-	/**
-	 * Checks whether a property is aggregatable.
-	 *
-	 * @param {string} sName Name of a property
-	 * @returns {boolean|null} Whether the property is aggregatable, or <code>null</code> if it is unknown
-	 * @public
-	 */
-	PropertyHelper.prototype.isAggregatable = function(sName) {
-		return this.hasProperty(sName) ? this.getDefaultAggregate(sName) !== null : null;
-	};
-
-	/**
-	 * Gets all aggregatable properties referenced by a complex property. For convenience, a non-complex property can be given that is then
-	 * returned if it is aggregatable.
-	 *
-	 * @param {string} sName Name of a property
-	 * @returns {object[]} The aggregatable properties
-	 * @public
-	 */
-	PropertyHelper.prototype.getAggregatableProperties = function(sName) {
-		var oProperty = this.getProperty(sName);
-		var aProperties = [];
-
-		if (oProperty) {
-			aProperties = oProperty.isComplex() ? oProperty.getReferencedProperties() : [oProperty];
-		}
+		/**
+		 * Gets all aggregatable properties referenced by the property, including the property itself if it is non-complex.
+		 *
+		 * @returns {object[]} The aggregatable properties
+		 */
+		oProperty.getAggregatableProperties = function() {
+			var aProperties = oProperty.isComplex() ? oProperty.getReferencedProperties() : [oProperty];
 
-		return aProperties.filter(function(oProperty) {
-			return oProperty.isAggregatable();
-		});
+			return aProperties.filter(function(oProperty) {
+				return oProperty.aggregatable;
+			});
+		};
 	};
 
 	/**
@@ -109,32 +74,11 @@ sap.ui.define([
 	 * @returns {object[]} All aggregatable properties
 	 * @public
 	 */
-	PropertyHelper.prototype.getAllAggregatableProperties = function() {
+	PropertyHelper.prototype.getAggregatableProperties = function() {
 		return this.getProperties().filter(function(oProperty) {
-			return oProperty.isAggregatable();
+			return oProperty.aggregatable;
 		});
 	};
 
-	/**
-	 * Gets the information about the default aggregate.
-	 *
-	 * @param {string} sName Name of a property
-	 * @returns {{unit: (object|null), contextDefiningProperties: object[]}|null}
-	 *     The default aggregate, or <code>null</code> if the property has no default aggregate or is unknown
-	 * @public
-	 */
-	PropertyHelper.prototype.getDefaultAggregate = function(sName) {
-		var mDefaultAggregate = getExtensionAttribute(this, sName, "defaultAggregate");
-
-		if (!mDefaultAggregate) {
-			return null;
-		}
-
-		return {
-			contextDefiningProperties: mDefaultAggregate._contextDefiningProperties || [],
-			unit: this.getUnitProperty(sName)
-		};
-	};
-
 	return PropertyHelper;
 });

package/src/sap/ui/mdc/themes/base/Chart.less

@@ -0,0 +1,3 @@
+.sapUiMDCChart {
+    background: @sapUiChartBackgroundColor;
+}

package/src/sap/ui/mdc/themes/base/library.source.less

@@ -19,3 +19,4 @@
 @import "GroupView.less";
 @import "Table.less";
 @import "CollectiveSearchSelect.less";
+@import "Chart.less";

package/src/sap/ui/mdc/ui/Container.js

@@ -22,12 +22,12 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @alias sap.ui.mdc.ui.Container
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 * @since 1.85.0
 	 *
 	 * @private

package/src/sap/ui/mdc/ui/ContainerItem.js

@@ -20,12 +20,12 @@ sap.ui.define(['sap/ui/core/Element'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @alias sap.ui.mdc.ui.ContainerItem
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 * @since 1.85.0
 	 *
 	 * @private

package/src/sap/ui/mdc/util/PromiseCache.js

@@ -44,7 +44,7 @@ sap.ui.define(
 		 * Destroying the cache will cancel all registered promises and delete references. Convenience methods for promise creation, wrapping and replacement are offered.
 		 *
 		 * @author SAP SE
-		 * @version 1.96.2
+		 * @version 1.97.0
 		 * @alias sap.ui.mdc.util.PromiseCache
 		 * @namespace
 		 * @since 1.85.0