@openui5/sap.ui.mdc 1.112.2 → 1.114.0

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

@@ -10,18 +10,18 @@
 // ---------------------------------------------------------------------------------------
 sap.ui.define([
 	"./AggregationBaseDelegate",
+	"./util/loadModules",
 	"./library",
 	"sap/ui/model/Sorter",
 	"sap/ui/core/library",
-	"sap/ui/core/Core",
-	"sap/base/util/UriParameters"
+	"sap/ui/core/Core"
 ], function(
 	AggregationBaseDelegate,
+	loadModules,
 	library,
 	Sorter,
 	coreLibrary,
-	Core,
-	UriParameters
+	Core
 ) {
 	"use strict";
 
@@ -88,7 +88,7 @@ sap.ui.define([
 	 * @returns {sap.ui.model.Sorter | undefined} New sorter
 	 * @protected
 	 */
-	TableDelegate.getGroupSorter = function(oTable, sPropertyName){
+	TableDelegate.getGroupSorter = function(oTable, sPropertyName) {
 		var oSortedProperty = oTable._getSortedProperties().find(function(oProperty) {
 			return oProperty.name === sPropertyName;
 		});
@@ -234,29 +234,200 @@ sap.ui.define([
 	 * @protected
 	 */
 	TableDelegate.fetchExportCapabilities = function(oTable) {
-		return Promise.resolve({ XLSX: {} });
+		return Promise.resolve({XLSX: {}});
 	};
 
 	/**
-	 * Checks whether data export is supported by the combination of this delegate and the current table state (e.g. type).
+	 * Expands all nodes.
 	 *
-	 * @param {sap.ui.mdc.Table} oTable Instance of the MDC table.
-	 * @returns {boolean} Whether data export is supported.
+	 * @param {sap.ui.mdc.Table} oTable Instance of the MDC table
+	 * @protected
+	 */
+	TableDelegate.expandAll = function(oTable) {
+		throw Error("Unsupported operation: TableDelegate does not support #expandAll");
+	};
+
+	/**
+	 * Collapses all nodes.
+	 *
+	 * @param {sap.ui.mdc.Table} oTable Instance of the MDC table
+	 * @protected
+	 */
+	TableDelegate.collapseAll = function(oTable) {
+		throw Error("Unsupported operation: TableDelegate does not support #collapseAll");
+	};
+
+	/**
+	 * This is called after the table has loaded the necessary libraries and modules and initialized its content, but before it resolves its
+	 * <code>initialized</code> Promise. It can be used to make changes to the content as part of the initialization.
+	 *
+	 * @param {sap.ui.mdc.Table} oTable Instance of the MDC table
+	 * @returns {Promise} A promise that resolves after the content is initialized
 	 * @private
 	 */
-	TableDelegate.isExportSupported = function(oTable) {
-		return !oTable._isOfType(TableType.TreeTable) || UriParameters.fromURL(window.location.href).has("sap-ui-xx-mdc-tree-export");
+	TableDelegate.initializeContent = function(oTable) {
+		return this.initializeSelection(oTable);
 	};
 
 	/**
-	 * Checks whether selection is supported by the combination of this delegate and the current table state (e.g. type).
+	 * This is called after the table has loaded the necessary libraries and modules and initialized its content, but before it resolves its
+	 * <code>initialized</code> Promise. It can be used to make changes to the selection as part of the initialization.
 	 *
-	 * @param {sap.ui.mdc.Table} oTable Instance of the MDC table.
-	 * @returns {boolean} Whether selection is supported.
+	 * @param {sap.ui.mdc.Table} oTable Instance of the MDC table
+	 * @returns {Promise} A promise that resolves after the content is initialized
 	 * @private
 	 */
-	TableDelegate.isSelectionSupported = function(oTable) {
-		return !oTable._isOfType(TableType.TreeTable);
+	TableDelegate.initializeSelection = function(oTable) {
+		if (oTable._isOfType(TableType.Table, true)) {
+			return initializeGridTableSelection(oTable);
+		} else {
+			return initializeResponsiveTableSelection(oTable);
+		}
+	};
+
+	function initializeGridTableSelection(oTable) {
+		var mSelectionModeMap = {
+			Single: "Single",
+			SingleMaster: "Single",
+			Multi: "MultiToggle"
+		};
+
+		return loadModules("sap/ui/table/plugins/MultiSelectionPlugin").then(function(aModules) {
+			var MultiSelectionPlugin = aModules[0];
+
+			oTable._oTable.addPlugin(new MultiSelectionPlugin({
+				limit: "{$sap.ui.mdc.Table#type>/selectionLimit}",
+				enableNotification: true,
+				showHeaderSelector: "{$sap.ui.mdc.Table#type>/showHeaderSelector}",
+				selectionMode: {
+					path: "$sap.ui.mdc.Table>/selectionMode",
+					formatter: function(sSelectionMode) {
+						return mSelectionModeMap[sSelectionMode];
+					}
+				},
+				enabled: {
+					path: "$sap.ui.mdc.Table>/selectionMode",
+					formatter: function(sSelectionMode) {
+						return sSelectionMode in mSelectionModeMap;
+					}
+				},
+				selectionChange: function(oEvent) {
+					// TODO: Add something sililar like TableTypeBase#callHook -> move to reusable util? Use here and in other places in delegates.
+					oTable._onSelectionChange({
+						selectAll: oEvent.getParameter("selectAll")
+					});
+				}
+			}));
+		});
+	}
+
+	function initializeResponsiveTableSelection(oTable) {
+		var mSelectionModeMap = {
+			Single: "SingleSelectLeft",
+			SingleMaster: "SingleSelectMaster",
+			Multi: "MultiSelect"
+		};
+		var mMultiSelectModeMap = {
+			Default: "SelectAll",
+			ClearAll: "ClearAll"
+		};
+
+		oTable._oTable.bindProperty("mode", {
+			path: "$sap.ui.mdc.Table>/selectionMode",
+			formatter: function(sSelectionMode) {
+				return mSelectionModeMap[sSelectionMode]; // Default is "None"
+			}
+		});
+
+		oTable._oTable.bindProperty("multiSelectMode", {
+			path: "$sap.ui.mdc.Table>/multiSelectMode",
+			formatter: function(sMultiSelectMode) {
+				return mMultiSelectModeMap[sMultiSelectMode] || "SelectAll"; // Default is "Default"
+			}
+		});
+
+		oTable._oTable.attachSelectionChange(function(oEvent) {
+			oTable._onSelectionChange({
+				selectAll: oEvent.getParameter("selectAll")
+			});
+		});
+
+		return Promise.resolve();
+	}
+
+	/**
+	 * Gets the selected contexts.
+	 *
+	 * @param {sap.ui.mdc.Table} oTable Instance of the table
+	 * @returns {sap.ui.model.Context[]} The selected contexts
+	 * @private
+	 */
+	TableDelegate.getSelectedContexts = function(oTable) {
+		if (!oTable._oTable) {
+			return [];
+		}
+
+		if (oTable._isOfType(TableType.Table, true)) {
+			var oGridTable = oTable._oTable;
+			var oMultiSelectionPlugin = oGridTable.getPlugins().find(function(oPlugin) {
+				return oPlugin.isA("sap.ui.table.plugins.MultiSelectionPlugin");
+			});
+
+			if (!oMultiSelectionPlugin) {
+				return [];
+			}
+
+			return oMultiSelectionPlugin.getSelectedIndices().map(function(iIndex) {
+				return oGridTable.getContextByIndex(iIndex);
+			}, this);
+		}
+
+		if (oTable._isOfType(TableType.ResponsiveTable)) {
+			return oTable._oTable.getSelectedContexts();
+		}
+
+		return [];
+	};
+
+	/**
+	 * Clears the selection.
+	 *
+	 * @param {sap.ui.mdc.Table} oTable Instance of the MDC table
+	 * @private
+	 */
+	TableDelegate.clearSelection = function(oTable) {
+		if (!oTable._oTable) {
+			return;
+		}
+
+		if (oTable._isOfType(TableType.Table, true)) {
+			var oSelectionPlugin = oTable._oTable.getPlugins().find(function(oPlugin) {
+				return oPlugin.isA("sap.ui.table.plugins.SelectionPlugin");
+			});
+
+			if (oSelectionPlugin) {
+				oSelectionPlugin.clearSelection();
+			}
+		}
+
+		if (oTable._isOfType(TableType.ResponsiveTable)) {
+			oTable._oTable.removeSelections(true);
+		}
+	};
+
+	/**
+	 * Gets the features that are supported by the combination of this delegate and the current table state (e.g. type).
+	 *
+	 * @param {sap.ui.mdc.Table} oTable
+	 * @returns {object} The supported features
+	 * @private
+	 */
+	TableDelegate.getSupportedFeatures = function(oTable) {
+		return {
+			"export": true,
+			expandAll: false,
+			collapseAll: false
+		};
 	};
 
 	/**

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

@@ -46,7 +46,8 @@ sap.ui.define([
 	 * @since 1.95.0
 	 * @private
 	 * @experimental As of version 1.95
-	 * @ui5-restricted sap.ui.mdc
+	 * @ui5-restricted sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 */
 
 	/**
@@ -58,7 +59,8 @@ sap.ui.define([
 	 * @since 1.95.0
 	 * @private
 	 * @experimental As of version 1.95
-	 * @ui5-restricted sap.ui.mdc
+	 * @ui5-restricted sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 */
 
 	/**
@@ -70,7 +72,8 @@ sap.ui.define([
 	 * @since 1.95.0
 	 * @private
 	 * @experimental As of version 1.95
-	 * @ui5-restricted sap.ui.mdc
+	 * @ui5-restricted sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 */
 
 	/**
@@ -78,9 +81,9 @@ sap.ui.define([
 	 *
 	 * @param {string} [sId] ID for the new element, generated automatically if no ID is given
 	 * @param {object} [mSettings] Initial settings for the new element
-	 * @class Element for the <code>FieldHelp</code> association in the {@link sap.ui.mdc.field.FieldBase FieldBase} controls.
+	 * @class Element for the <code>ValueHelp</code> association in the {@link sap.ui.mdc.field.FieldBase FieldBase} controls.
 	 * @extends sap.ui.mdc.Element
-	 * @version 1.112.2
+	 * @version 1.114.0
 	 * @constructor
 	 * @abstract
 	 * @private
@@ -234,7 +237,7 @@ sap.ui.define([
 						/**
 						 * The container which will be opened
 						 */
-						container: {type: "object"}
+						container: {type: "sap.ui.mdc.valuehelp.base.Container"}
 					}
 				},
 
@@ -246,7 +249,7 @@ sap.ui.define([
 						/**
 						 * The container which was opened
 						 */
-						container: {type: "object"}
+						container: {type: "sap.ui.mdc.valuehelp.base.Container"}
 					}
 				},
 
@@ -325,7 +328,7 @@ sap.ui.define([
 	 * <b>Note:</b> This function must only be called by the control the <code>ValueHelp</code> element
 	 * belongs to, not by the application.
 	 *
-	 * @param {sap.ui.core.Control} oControl Control to which the <code>FieldHelp</code> element is connected to
+	 * @param {sap.ui.core.Control} oControl Control to which the <code>ValueHelp</code> element is connected to
 	 * @param {object} [oConfig] Configuration object that holds required data of the connected control
 	 * @param {int} [oConfig.maxConditions=-1] Maximum number of allowed conditions
 	 * @param {sap.ui.model.Type} [oConfig.dataType] Type of the key (required for condition panel)
@@ -386,7 +389,7 @@ sap.ui.define([
 	/**
 	 * Returns the aria attributes the field needs from the value help
 	 *
-	 * @param {int} iMaxConditions maximal conditions allowed (as FieldHelp might not be connected to a field)
+	 * @param {int} iMaxConditions maximal conditions allowed (as ValueHelp might not be connected to a field)
 	 * @returns {object} object with the aria-attibutes
 	 * @private
 	 * @ui5-restricted sap.ui.mdc.field.FieldBase
@@ -825,7 +828,7 @@ sap.ui.define([
 		}
 
 		_onConditionPropagation.call(this, PropagationReason.ControlChange);
-		// as BindingContext of Field might change (happens if fast typed and FieldHelp not opened) update if needed
+		// as BindingContext of Field might change (happens if fast typed and ValueHelp not opened) update if needed
 		_updateBindingContext.call(this);
 	};
 
@@ -850,10 +853,6 @@ sap.ui.define([
 
 	};
 
-//	ValueHelp.prototype.getUIArea = function() { // Ask Frank, if better way available
-//
-//	};
-
 	ValueHelp.prototype.getMaxConditions = function() { // ?
 		var oConfig = this.getProperty("_config");
 		return (oConfig && oConfig.maxConditions) || -1;

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

@@ -69,7 +69,8 @@ sap.ui.define([
 	 * @param {sap.ui.model.ListBinding} oListBinding ListBinding
 	 * @returns {boolean} true if $search is supported
 	 * @private
-	 * @ui5-restricted sap.ui.mdc.ValueHelp
+	 * @ui5-restricted sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 */
 	ValueHelpDelegate.isSearchSupported = function(oPayload, oContent, oListBinding) {
 		return false;
@@ -108,7 +109,7 @@ sap.ui.define([
 	 * @param {sap.ui.base.ManagedObject.AggregationBindingInfo} oBindingInfo The binding info object to be used to bind the list to the model
 	 * @private
 	 * @since 1.110.0
-	 *
+	 * @ui5-restricted sap.fe
 	 * @MDC_PUBLIC_CANDIDATE
 	 */
 	ValueHelpDelegate.updateBindingInfo = function(oPayload, oContent, oBindingInfo) {
@@ -140,11 +141,13 @@ sap.ui.define([
 	 * @param {object} oPayload Payload for delegate
 	 * @param {sap.ui.model.ListBinding} oListBinding List binding
 	 * @param {sap.ui.base.ManagedObject.AggregationBindingInfo} oBindingInfo The binding info object to be used to bind the list to the model
+  	 * @param {sap.ui.mdc.valuehelp.base.FilterableListContent} oContent ValueHelp content requesting the binding update
 	 * @private
 	 * @since 1.110.0
-	 * @ui5-restricted sap.ui.mdc.ValueHelp
+	 * @ui5-restricted sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 */
-	ValueHelpDelegate.updateBinding = function(oPayload, oListBinding, oBindingInfo) {
+	ValueHelpDelegate.updateBinding = function(oPayload, oListBinding, oBindingInfo, oContent) {
 		oListBinding.filter(oBindingInfo.filters, FilterType.Application);
 		if (oListBinding.isSuspended()) {
 			oListBinding.resume();
@@ -178,7 +181,8 @@ sap.ui.define([
 	 * @param {int} iRequestedItems Number of requested items
 	 * @returns {Promise<sap.ui.model.ListBinding>} Promise that is resolved if search is executed
 	 * @private
-	 * @ui5-restricted sap.ui.mdc.ValueHelp
+	 * @ui5-restricted sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 */
 	ValueHelpDelegate.executeFilter = function(oPayload, oListBinding, iRequestedItems) {
 		return Promise.resolve(oListBinding);
@@ -194,7 +198,8 @@ sap.ui.define([
 	 * @param {int} iRequestedItems Number of requested items
 	 * @returns {boolean|Promise<boolean>} <code>Promise</code> that is resolved once <code>ListBinding</code> has been updated
 	 * @private
-	 * @ui5-restricted sap.ui.mdc.ValueHelp
+	 * @ui5-restricted sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 */
 	ValueHelpDelegate.checkListBindingPending = function(oPayload, oListBinding, iRequestedItems) {
 		if (!oListBinding || oListBinding.isSuspended()) {
@@ -350,7 +355,7 @@ sap.ui.define([
 	/**
 	 * This method should provide a map of conditions for the following situations:
 	 * 	1. Initial set of conditions applied everytime a value help content is shown for the first time since opening it's container.
-	 * 	2. Detailed set of conditions in getItemForValue scenarios allowing to find a specific FieldHelpItem (indicated by oConfig availability)
+	 * 	2. Detailed set of conditions in getItemForValue scenarios allowing to find a specific ValueHelpItem (indicated by oConfig availability)
 	 *
 	 * @param {object} oPayload Payload for delegate
 	 * @param {sap.ui.mdc.valuehelp.base.FilterableListContent} oContent <code>ValueHelp</code> content instance

package/src/sap/ui/mdc/actiontoolbar/ActionToolbarAction.js

@@ -18,15 +18,16 @@ sap.ui.define([
 	 *
 	 * @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 action for an {@link sap.ui.mdc.ActionToolbar ActionToolbar}) control
+	 * @class The action for an {@link sap.ui.mdc.ActionToolbar ActionToolbar} control
 	 * @extends sap.ui.core.Control
 	 * @author SAP SE
-	 * @version 1.112.2
+	 * @version 1.114.0
 	 * @constructor
 	 * @private
 	 * @since 1.58
 	 * @experimental As of version 1.58
-	 * @ui5-restricted sap.ui.mdc
+	 * @ui5-restricted sap.ui.mdc, sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 * @alias sap.ui.mdc.actiontoolbar.ActionToolbarAction
 	 */
 	var ActionToolbarAction = Control.extend("sap.ui.mdc.actiontoolbar.ActionToolbarAction", {
@@ -74,12 +75,6 @@ sap.ui.define([
 		return oLayoutData ? oLayoutData : this.getAction() && this.getAction().getLayoutData();
 	};
 
-	/**
-	 * Sets the behavior of the <code>ActionToolbarAction</code> inside an <code>OverflowToolbar</code> configuration.
-	 *
-	 * @protected
-	 * @returns {object} Configuration information for the <code>sap.m.IOverflowToolbarContent</code> interface.
-	 */
 	ActionToolbarAction.prototype.getOverflowToolbarConfig = function() {
 		// use the Action OverflowToolbarConfig if exist
 		var oConfig = this.getAction() && this.getAction().getOverflowToolbarConfig ? this.getAction().getOverflowToolbarConfig() : { canOverflow: true };