@openui5/sap.m 1.120.6 → 1.120.8

package/src/sap/m/ViewSettingsFilterItem.js

@@ -24,7 +24,7 @@ sap.ui.define(['./ViewSettingsItem', './library'],
 	 * @extends sap.m.ViewSettingsItem
 	 *
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/ViewSettingsItem.js

@@ -25,7 +25,7 @@ sap.ui.define(['./library', 'sap/ui/core/Item'],
 	 * @extends sap.ui.core.Item
 	 *
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/VisibleItem.js

@@ -21,7 +21,7 @@ sap.ui.define(['./library', 'sap/ui/core/Item', "sap/ui/thirdparty/jquery"],
 		 * @extends sap.ui.core.Item
 		 *
 		 * @author SAP SE
-		 * @version 1.120.6
+		 * @version 1.120.8
 		 *
 		 * @constructor
 		 * @private

package/src/sap/m/WheelSlider.js

@@ -29,7 +29,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.120.6
+		 * @version 1.120.8
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/WheelSliderContainer.js

@@ -31,7 +31,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.120.6
+		 * @version 1.120.8
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/Wizard.js

@@ -100,7 +100,7 @@ sap.ui.define([
 		 *
 		 * @extends sap.ui.core.Control
 		 * @author SAP SE
-		 * @version 1.120.6
+		 * @version 1.120.8
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/WizardProgressNavigator.js

@@ -43,7 +43,7 @@ function(
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 *
 	 * @constructor
 	 * @private

package/src/sap/m/WizardStep.js

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * <li>If the execution needs to branch after a given step, you should set all possible next steps in the <code>subsequentSteps</code> aggregation.
 	 * @extends sap.ui.core.Control
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/changeHandler/AddTableColumn.js

@@ -43,7 +43,7 @@ sap.ui.define([
 	 *
 	 * @author SAP SE
 	 *
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 *
 	 * @experimental Since 1.51.0 This class is experimental and provides only limited functionality.
 	 * Also the API might be changed in future.

package/src/sap/m/changeHandler/ChangeLinkTarget.js

@@ -12,7 +12,7 @@ sap.ui.define(function () {
 	 *
 	 * @alias sap.m.changeHandler.ChangeLinkTarget
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 * @experimental Since 1.71
 	 */
 	var ChangeLinkTarget = {};

package/src/sap/m/changeHandler/CombineButtons.js

@@ -18,7 +18,7 @@ sap.ui.define([
 	 *
 	 * @alias sap.m.changeHandler.CombineButtons
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 * @experimental Since 1.48
 	 */
 	var CombineButtons = {};

package/src/sap/m/changeHandler/MoveTableColumns.js

@@ -13,7 +13,7 @@ sap.ui.define(["sap/base/Log"], function(Log) {
 	 *
 	 * @alias sap.m.changeHandler.MoveTableColumns
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 * @experimental Since 1.48
 	 */
 	var MoveTableColumns = {};

package/src/sap/m/changeHandler/SelectIconTabBarFilter.js

@@ -14,7 +14,7 @@ sap.ui.define([
 	 *
 	 * @alias sap.m.changeHandler.SelectIconTabBarFilter
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 * @experimental Since 1.96
 	 */
 	var SelectIconTabBarFilter = {};

package/src/sap/m/changeHandler/SplitMenuButton.js

@@ -20,7 +20,7 @@ sap.ui.define([
 	 *
 	 * @alias sap.m.changeHandler.SplitMenuButton
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 * @experimental Since 1.48
 	 */
 	var SplitMenuButton = {};

package/src/sap/m/library.js

@@ -72,13 +72,13 @@ sap.ui.define([
 	 * @namespace
 	 * @alias sap.m
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 * @since 1.4
 	 * @public
 	 */
 	var thisLib = Library.init({
 		name : "sap.m",
-		version: "1.120.6",
+		version: "1.120.8",
 		dependencies : ["sap.ui.core"],
 		designtime: "sap/m/designtime/library.designtime",
 		types: [

package/src/sap/m/p13n/AbstractContainer.js

@@ -22,12 +22,12 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 *
 	 * @constructor
 	 * @alias sap.m.p13n.AbstractContainer
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 * @since 1.96
 	 *
 	 * @private

package/src/sap/m/p13n/AbstractContainerItem.js

@@ -20,12 +20,12 @@ sap.ui.define(['sap/ui/core/Element'],
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.120.6
+		 * @version 1.120.8
 		 *
 		 * @constructor
 		 * @alias sap.m.p13n.AbstractContainerItem
 		 * @author SAP SE
-		 * @version 1.120.6
+		 * @version 1.120.8
 	 	 * @since 1.96
 	 	 * @private
 		 * @ui5-restricted

package/src/sap/m/p13n/BasePanel.js

@@ -52,7 +52,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 *
 	 * @public
 	 * @abstract

package/src/sap/m/p13n/Container.js

@@ -42,7 +42,7 @@ sap.ui.define([
 	 * @extends sap.m.p13n.AbstractContainer
 	 *
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 *
 	 * @private
 	 * @ui5-restricted

package/src/sap/m/p13n/Engine.js

@@ -57,7 +57,7 @@ sap.ui.define([
 	 * @alias sap.m.p13n.Engine
 	 * @extends sap.m.p13n.modules.AdaptationProvider
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 * @public
 	 * @since 1.104
 	 */
@@ -259,8 +259,8 @@ sap.ui.define([
 	 * Check if there are changes for a given control instance
 	 *
 	 * @private
-         * @ui5-restricted sap.m, sap.ui.mdc
-         *
+	 * @ui5-restricted sap.m, sap.ui.mdc
+	 *
 	 * @param {sap.ui.core.Control} control The control instance
 	 * @param {string} key The affected controller key
 	 * @returns {Promise<boolean>} A Promise that resolves if the given control instance has applied changes
@@ -1356,8 +1356,7 @@ sap.ui.define([
 	/**
 	 * This method is the central point of access to the Engine Singleton.
 	 *
-	 * @private
-	 * @ui5-restricted sap.m, sap.ui.mdc
+	 * @public
 	 *
 	 * @returns {sap.m.p13n.Engine} The Engine instance
 	 */

package/src/sap/m/p13n/GroupController.js

@@ -4,16 +4,28 @@
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
-    'sap/m/p13n/SelectionController', 'sap/m/p13n/GroupPanel', 'sap/m/p13n/modules/xConfigAPI'
+	'sap/m/p13n/SelectionController', 'sap/m/p13n/GroupPanel', 'sap/m/p13n/modules/xConfigAPI'
 ], function (BaseController, GroupPanel, xConfigAPI) {
-    "use strict";
+	"use strict";
 
-     /**
+	/**
+	 * Personalization <code>GroupState</code> object type. This object describes the state processed by this controller when accessing it through the {@link sap.m.p13n.Engine Engine}.
+	 *
+	 * @public
+	 * @typedef {object} sap.m.p13n.GroupState
+	 * @property {string} key The key for the group state
+	 * @property {boolean} [grouped] Defines whether the item is grouped (if a group state is provided, it's grouped automatically)
+	 * @property {int} [index] Describes the index of the grouping
+	 *
+	 */
+
+	 /**
+
+	 /**
 	 * Constructor for a new <code>GroupController</code>.
 	 *
-	 * @param {string} [sId] ID for the new control, generated automatically if no ID is given
-	 * @param {object} [mSettings] Initial settings for the new control
-     * @param {sap.ui.core.Control} mSettings.control The control instance that is personalized by this controller
+	 * @param {object} mSettings Initial settings for the new controller
+	 * @param {sap.ui.core.Control} mSettings.control The control instance that is personalized by this controller
 	 *
 	 * @class
 	 * The <code>GroupController</code> entity serves as a base class to create group-specific personalization implementations.
@@ -21,103 +33,103 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 *
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 * @public
 	 * @since 1.104
 	 * @alias sap.m.p13n.GroupController
 	 */
-    var GroupController = BaseController.extend("sap.m.p13n.subcontroller.GroupController");
+	var GroupController = BaseController.extend("sap.m.p13n.subcontroller.GroupController");
 
-    GroupController.prototype.getStateKey = function () {
-        return "groupLevels";
-    };
+	GroupController.prototype.getStateKey = function () {
+		return "groupLevels";
+	};
 
-    GroupController.prototype.getCurrentState = function(bExternalize) {
-        var oXConfig = xConfigAPI.readConfig(this.getAdaptationControl()) || {};
-        var aSortConditions = oXConfig.hasOwnProperty("properties") ? oXConfig.properties.groupConditions : [];
+	GroupController.prototype.getCurrentState = function(bExternalize) {
+		var oXConfig = xConfigAPI.readConfig(this.getAdaptationControl()) || {};
+		var aSortConditions = oXConfig.hasOwnProperty("properties") ? oXConfig.properties.groupConditions : [];
 
-        return aSortConditions || [];
-    };
+		return aSortConditions || [];
+	};
 
-    GroupController.prototype.initAdaptationUI = function(oPropertyHelper){
-        var oGroupPanel = new GroupPanel();
-        var oAdaptationData = this.mixInfoAndState(oPropertyHelper);
+	GroupController.prototype.initAdaptationUI = function(oPropertyHelper){
+		var oGroupPanel = new GroupPanel();
+		var oAdaptationData = this.mixInfoAndState(oPropertyHelper);
 		var oAdaptationControl = this.getAdaptationControl();
 
 		if (oAdaptationControl.isA("sap.m.Table")) {
 			oGroupPanel.setQueryLimit(1);
 		}
 
-        oGroupPanel.setP13nData(oAdaptationData.items);
-        this._oPanel = oGroupPanel;
-
-        return Promise.resolve(oGroupPanel);
-    };
-
-    GroupController.prototype.model2State = function() {
-        var aItems = [];
-        this._oPanel.getP13nData(true).forEach(function(oItem){
-            if (oItem.grouped){
-                aItems.push({
-                    key: oItem.key
-                });
-            }
-        });
-        return aItems;
-    };
-
-    GroupController.prototype.getChangeOperations = function () {
-        return {
-            add: "addGroup",
-            remove: "removeGroup",
-            move: "moveGroup"
-        };
-    };
-
-    GroupController.prototype._getPresenceAttribute = function () {
-        return "grouped";
-    };
-
-    GroupController.prototype._createAddRemoveChange = function(oControl, sOperation, oContent){
-        var oAddRemoveChange = {
-            selectorElement: oControl,
-            changeSpecificData: {
-                changeType: sOperation,
-                content: oContent
-            }
-        };
-        return oAddRemoveChange;
-    };
+		oGroupPanel.setP13nData(oAdaptationData.items);
+		this._oPanel = oGroupPanel;
+
+		return Promise.resolve(oGroupPanel);
+	};
+
+	GroupController.prototype.model2State = function() {
+		var aItems = [];
+		this._oPanel.getP13nData(true).forEach(function(oItem){
+			if (oItem.grouped){
+				aItems.push({
+					key: oItem.key
+				});
+			}
+		});
+		return aItems;
+	};
+
+	GroupController.prototype.getChangeOperations = function () {
+		return {
+			add: "addGroup",
+			remove: "removeGroup",
+			move: "moveGroup"
+		};
+	};
+
+	GroupController.prototype._getPresenceAttribute = function () {
+		return "grouped";
+	};
+
+	GroupController.prototype._createAddRemoveChange = function(oControl, sOperation, oContent){
+		var oAddRemoveChange = {
+			selectorElement: oControl,
+			changeSpecificData: {
+				changeType: sOperation,
+				content: oContent
+			}
+		};
+		return oAddRemoveChange;
+	};
 
 	GroupController.prototype.mixInfoAndState = function(oPropertyHelper) {
 
-        var aItemState = this.getCurrentState();
-        var mItemState = this.arrayToMap(aItemState);
-        var oController = this.getAdaptationControl();
-        var oAggregations = oController.getAggregateConditions ? oController.getAggregateConditions() || {} : {};
+		var aItemState = this.getCurrentState();
+		var mItemState = this.arrayToMap(aItemState);
+		var oController = this.getAdaptationControl();
+		var oAggregations = oController.getAggregateConditions ? oController.getAggregateConditions() || {} : {};
 
-        var oP13nData = this.prepareAdaptationData(oPropertyHelper, function(mItem, oProperty){
-            var oExisting = mItemState[oProperty.key];
-            mItem.grouped = !!oExisting;
-            mItem.position =  oExisting ? oExisting.position : -1;
-            return !(oProperty.groupable === false || oAggregations[oProperty.key]);
-        });
+		var oP13nData = this.prepareAdaptationData(oPropertyHelper, function(mItem, oProperty){
+			var oExisting = mItemState[oProperty.key];
+			mItem.grouped = !!oExisting;
+			mItem.position =  oExisting ? oExisting.position : -1;
+			return !(oProperty.groupable === false || oAggregations[oProperty.key]);
+		});
 
-        this.sortP13nData({
-            visible: "grouped",
-            position: "position"
-        }, oP13nData.items);
+		this.sortP13nData({
+			visible: "grouped",
+			position: "position"
+		}, oP13nData.items);
 
-        oP13nData.presenceAttribute = this._getPresenceAttribute();
-        oP13nData.items.forEach(function(oItem){delete oItem.position;});
+		oP13nData.presenceAttribute = this._getPresenceAttribute();
+		oP13nData.items.forEach(function(oItem){delete oItem.position;});
 
-        return oP13nData;
-    };
+		return oP13nData;
+	};
 
-    GroupController.prototype.applyChange = function(aSortState){
-        return Promise.resolve();
-    };
+	GroupController.prototype.applyChange = function(aSortState){
+		return Promise.resolve();
+	};
 
-    return GroupController;
+	return GroupController;
 
 });

package/src/sap/m/p13n/GroupPanel.js

@@ -21,7 +21,7 @@ sap.ui.define([
 	 * @extends sap.m.p13n.QueryPanel
 	 *
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 *
 	 * @public
 	 * @alias sap.m.p13n.GroupPanel

package/src/sap/m/p13n/MetadataHelper.js

@@ -5,38 +5,83 @@
  */
 
 sap.ui.define([
-    "sap/ui/base/Object"
-], function (BaseObject) {
+	"sap/ui/base/Object"
+], function(BaseObject) {
 	"use strict";
 
-    /**
-     * @class
-     * The <code>MetadataHelper</code> entity offers utility functionality for providing service metadata during the <code>Engine#register</code> process.
-     *
+	/**
+	 * Personalization <code>MetadataObject</code> type.
+	 *
+	 * @public
+	 * @experimental Since 1.104.
+	 * @typedef {object} sap.m.p13n.MetadataObject
+	 * @property {string} key The unique key for the p13n metadata object
+	 * @property {string} label Defines the text that will be displayed in the personalization popup
+	 * @property {string} path Defines the technical path to apply binding-related updates
+	 * @property {boolean} [sortable] Defines whether the metadata object is sortable
+	 * @property {boolean} [groupable] Defines whether the metadata object is groupable
+	 * @property {boolean} [visible] Defines whether the metadata object is visible for selection
+	 *
+	 */
+
+	/**
 	 * @author SAP SE
 	 * @public
 	 * @alias sap.m.p13n.MetadataHelper
-     */
-    var MetadataHelper = BaseObject.extend("sap.m.p13n.MetadataHelper", {
-        constructor: function(aProperties) {
+	 * @class
+	 * The <code>MetadataHelper</code> entity offers utility functionality for service metadata during the <code>Engine#register</code> process.
+	 *
+	 * @see {@link topic:75c08fdebf784575947927e052712bab Personalization}
+	 *
+	 * @constructor
+	 * @param {sap.m.p13n.MetadataObject[]} aProperties Array of objects defining available items for personalization
+	 * @example
+	 *   [
+	 *      {key: country, label: Country, path: modelPath/to/country},
+	 *      {key: region, label: Region, path: modelPath/to/region},
+	 *      {key: city, label: City, path: modelPath/to/city}
+	 * ]
+	 */
+	var MetadataHelper = BaseObject.extend("sap.m.p13n.MetadataHelper", {
+		constructor: function(aProperties) {
 			BaseObject.apply(this, arguments);
 			this._aProperties = aProperties;
 		}
-    });
+	});
 
-    MetadataHelper.prototype.getProperties = function() {
-        return this._aProperties;
-    };
+	/**
+	 * Gets the array of properties.
+	 *
+	 * @public
+	 * @returns {sap.m.p13n.MetadataObject[]} Array of properties
+	 */
+	MetadataHelper.prototype.getProperties = function() {
+		return this._aProperties;
+	};
 
-    MetadataHelper.prototype.getProperty = function(sKey) {
-        return this._aProperties.find(function(oProp){
-            return oProp.key === sKey;
-        });
-    };
+	/**
+	 * Gets a single property.
+	 *
+	 * @public
+	 * @param {string} sKey The property key identifying a property entry
+	 * @returns {sap.m.p13n.MetadataObject} A single property
+	 */
+	MetadataHelper.prototype.getProperty = function(sKey) {
+		return this._aProperties.find(function(oProp){
+			return oProp.key === sKey;
+		});
+	};
 
-    MetadataHelper.prototype.getPath = function(sKey) {
-        return this.getProperty(sKey).path;
-    };
+	/**
+	 * Gets a property path based on its key.
+	 *
+	 * @public
+	 * @param {string} sKey The property key identifying a property entry
+	 * @returns {string} The property path based on its key
+	 */
+	MetadataHelper.prototype.getPath = function(sKey) {
+		return this.getProperty(sKey).path;
+	};
 
 	return MetadataHelper;
 

package/src/sap/m/p13n/Popup.js

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 *
 	 * @public
 	 * @since 1.97
@@ -379,7 +379,7 @@ sap.ui.define([
 		var fnReset = this.getReset();
 		var sTitle = this.getTitle();
 		var sWarningText = this.getWarningText();
-        var oPopup = this;
+		var oPopup = this;
 
 		var oBar;
 

package/src/sap/m/p13n/QueryPanel.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.m.p13n.BasePanel
 	 *
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 *
 	 * @private
 	 * @ui5-restricted sap.m, sap.ui.mdc

package/src/sap/m/p13n/SelectionController.js

@@ -16,11 +16,21 @@ sap.ui.define([
 ], function (diff, BaseObject, merge, deepEqual, SelectionPanel, xConfigAPI, Configuration, View) {
 	"use strict";
 
+	/**
+	 * Personalization <code>SelectionState</code> object type. This object describes the state processed by this controller when accessing it through the {@link sap.m.p13n.Engine Engine}.
+	 *
+	 * @public
+	 * @typedef {object} sap.m.p13n.SelectionState
+	 * @property {string} key The key for the group state
+	 * @property {boolean} [visible] Defines whether the item is selected (if a selection state is provided, it's selected automatically)
+	 * @property {int} [index] Describes the index of the selection item
+	 *
+	 */
+
 	/**
 	 * Constructor for a new <code>SelectionController</code>.
 	 *
-	 * @param {string} [sId] ID for the new control, generated automatically if no ID is given
-	 * @param {object} [mSettings] Initial settings for the new control
+	 * @param {object} mSettings Initial settings for the new controller
 	 * @param {sap.ui.core.Control} mSettings.control The control instance that is personalized by this controller
 	 * @param {function} [mSettings.getKeyForItem] By default the SelectionController tries to identify the existing item through the
 	 * key by checking if there is an existing item with this id. This behaviour can be overruled by implementing this method which will
@@ -33,7 +43,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 *
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 *
 	 * @public
 	 * @alias sap.m.p13n.SelectionController

package/src/sap/m/p13n/SelectionPanel.js

@@ -51,7 +51,7 @@ sap.ui.define([
 	 * @extends sap.m.p13n.BasePanel
 	 *
 	 * @author SAP SE
-	 * @version 1.120.6
+	 * @version 1.120.8
 	 *
 	 * @public
 	 * @since 1.96