@openui5/sap.m 1.98.0 → 1.101.0

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.98.0
+	 * @version 1.101.0
 	 *
 	 * @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.98.0
+		 * @version 1.101.0
 		 *
 		 * @constructor
 		 * @private
@@ -68,7 +68,7 @@ sap.ui.define(['./library', 'sap/ui/core/Item', "sap/ui/thirdparty/jquery"],
 		 */
 		VisibleItem.prototype.setVisible = function(bValue) {
 			if (this.getVisible() === bValue) {
-				return;
+				return this;
 			}
 
 			var $refs = this._getRefs();

package/src/sap/m/WheelSlider.js

@@ -28,7 +28,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.98.0
+		 * @version 1.101.0
 		 *
 		 * @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.98.0
+		 * @version 1.101.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/WheelSliderContainerRenderer.js

@@ -19,7 +19,7 @@ sap.ui.define(["sap/ui/Device"], function(Device) {
 	 * Renders the HTML for the given {@link sap.m.WheelSliderContainer} control, using the provided {@link sap.ui.core.RenderManager}.
 	 *
 	 * @param {sap.ui.core.RenderManager} oRM The RenderManager that can be used for writing to the render output buffer
-	 * @param {sap.ui.core.Control} oControl An object representation of the control that should be rendered
+	 * @param {sap.m.WheelSliderContainer} oControl An object representation of the control that should be rendered
 	 */
 	WheelSliderContainerRenderer.render = function(oRM, oControl) {
 		var aSliders = oControl.getSliders(),

package/src/sap/m/WheelSliderRenderer.js

@@ -22,7 +22,7 @@ sap.ui.define([],
 		 * Renders the HTML for a {@link sap.m.WheelSlider}, using the provided {@link sap.ui.core.RenderManager}.
 		 *
 		 * @param {sap.ui.core.RenderManager} oRm The RenderManager that can be used for writing to the render output buffer
-		 * @param {sap.ui.core.Control} oControl An object representation of the control that should be rendered
+		 * @param {sap.m.WheelSlider} oControl An object representation of the control that should be rendered
 		 */
 		WheelSliderRenderer.render = function(oRm, oControl) {
 			var iIndex,
@@ -147,7 +147,7 @@ sap.ui.define([],
 		 * Adds a class to the current element in the RenderManager's buffer based on the number of visible items in the slider.
 		 *
 		 * @param {sap.ui.core.RenderManager} oRm The RenderManager that can be used for writing to the render output buffer
-		 * @param {sap.ui.core.Control} oControl An object representation of the control that should be rendered
+		 * @param {sap.m.WheelSlider} oControl An object representation of the control that should be rendered
 		 * @protected
 		 */
 		WheelSliderRenderer.addItemValuesCssClass = function(oRm, oControl) {

package/src/sap/m/Wizard.js

@@ -86,7 +86,7 @@ sap.ui.define([
 		 *
 		 * @extends sap.ui.core.Control
 		 * @author SAP SE
-		 * @version 1.98.0
+		 * @version 1.101.0
 		 *
 		 * @constructor
 		 * @public
@@ -143,7 +143,7 @@ sap.ui.define([
 					},
 					/**
 					 * Defines how the steps of the Wizard would be visualized.
-					 * @experimental since 1.84
+					 * @since 1.84
 					 */
 					renderMode: {
 						type: "sap.m.WizardRenderMode",
@@ -188,6 +188,18 @@ sap.ui.define([
 							index: {type: "int"}
 						}
 					},
+					/**
+					 * This event is fired when the the current visible step is changed by either taping on the <code>WizardProgressNavigator</code> or scrolling through the steps.
+					 * @since 1.101
+					 */
+					navigationChange: {
+						parameters: {
+							/**
+							* The newly selected step.
+							*/
+							step: {type: "sap.m.WizardStep"}
+						}
+					},
 					/**
 					 * The complete event is fired when the user clicks the finish button of the Wizard.
 					 * The finish button is only available on the last step of the Wizard.
@@ -788,7 +800,7 @@ sap.ui.define([
 				oProgressNavigator.incrementProgress();
 
 				this._handleStepActivated(oProgressNavigator.getProgress());
-				this._handleStepChanged(oProgressNavigator.getProgress());
+				this._handleStepChanged(oProgressNavigator.getProgress(), true);
 			}
 		};
 
@@ -843,14 +855,16 @@ sap.ui.define([
 		/**
 		 * Handler for the stepChanged event. The event comes from the WizardProgressNavigator.
 		 * @param {jQuery.Event} oEvent The event object
+		 * @param {boolean} bSupressEvent Whether event should be suppressed.
 		 * @private
 		 */
-		Wizard.prototype._handleStepChanged = function (oEvent) {
+		Wizard.prototype._handleStepChanged = function (oEvent, bSupressEvent) {
 			var iPreviousStepIndex = ((typeof oEvent === "number") ? oEvent : oEvent.getParameter("current")) - 2,
 				oPreviousStep = this._aStepPath[iPreviousStepIndex],
 				oSubsequentStep = this._getNextStep(oPreviousStep, iPreviousStepIndex),
 				bFocusFirstElement = Device.system.desktop ? true : false;
 
+			!bSupressEvent && this.fireNavigationChange({step: oSubsequentStep});
 			this.goToStep(oSubsequentStep, bFocusFirstElement);
 		};
 
@@ -1134,6 +1148,7 @@ sap.ui.define([
 			var iScrollTop = oEvent.target.scrollTop,
 				oProgressNavigator = this._getProgressNavigator(),
 				oCurrentStep = this._aStepPath[oProgressNavigator.getCurrentStep() - 1],
+				oSubsequentStep = this._aStepPath[oProgressNavigator.getCurrentStep()],
 				oCurrentStepDOM = oCurrentStep && oCurrentStep.getDomRef();
 
 			if (!oCurrentStepDOM) {
@@ -1146,6 +1161,7 @@ sap.ui.define([
 
 			if (iScrollTop + iStepChangeThreshold >= iStepOffset + iStepHeight && oProgressNavigator._isActiveStep(oProgressNavigator._iCurrentStep + 1)) {
 				oProgressNavigator.nextStep();
+				this.fireNavigationChange({step: oSubsequentStep});
 			}
 
 			var aSteps = this.getSteps();
@@ -1158,6 +1174,8 @@ sap.ui.define([
 					oCurrentStep = this._aStepPath[oProgressNavigator.getCurrentStep() - 1];
 					oCurrentStepDOM = oCurrentStep && oCurrentStep.getDomRef();
 
+					this.fireNavigationChange({step: oCurrentStep});
+
 					if (!oCurrentStepDOM) {
 						break;
 					}

package/src/sap/m/WizardProgressNavigator.js

@@ -43,7 +43,7 @@ function(
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 *
 	 * @constructor
 	 * @private
@@ -301,8 +301,15 @@ function(
 		this._oStepNavigation = new ItemNavigation();
 		this._oStepNavigation.setCycling(false);
 		this._oStepNavigation.setDisabledModifiers({
-			sapnext: ["alt"],
-			sapprevious: ["alt"]
+			// Alt + arrow keys are reserved for browser navigation
+			sapnext: [
+				"alt", // Windows and Linux
+				"meta" // Apple (⌘)
+			],
+			sapprevious: [
+				"alt",
+				"meta"
+			]
 		});
 		this._oStepNavigation.attachEvent("AfterFocus", function (params) {
 			var oEvent = params.mParameters.oEvent;

package/src/sap/m/WizardStep.js

@@ -36,7 +36,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.98.0
+	 * @version 1.101.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -44,7 +44,7 @@ sap.ui.define([
 	 *
 	 * @author SAP SE
 	 *
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 *
 	 * @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.98.0
+	 * @version 1.101.0
 	 * @experimental Since 1.71
 	 */
 	var ChangeLinkTarget = {};

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

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

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

@@ -13,7 +13,7 @@ sap.ui.define(["sap/base/Log", "sap/ui/thirdparty/jquery"], function(Log, jQuery
 	 *
 	 * @alias sap.m.changeHandler.MoveTableColumns
 	 * @author SAP SE
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @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.98.0
+	 * @version 1.101.0
 	 * @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.98.0
+	 * @version 1.101.0
 	 * @experimental Since 1.48
 	 */
 	var SplitMenuButton = {};
@@ -249,10 +249,10 @@ sap.ui.define([
 	 * Callback function which is attached via modifier in applyChange
 	 *
 	 * @param {sap.ui.base.Event} oEvent Event object
-	 * @param {object} mSelector Selector object
-	 * @param {string} mSelector.id ID used for determination of the flexibility target
-	 * @param {boolean} mSelector.idIsLocal flag if the selector.id has to be concatenated with the application component ID
-	 * while applying the change.
+	 * @param {object} mParameters
+	 * @param {{id: string, idIsLocal: boolean}} mParameters.selector Selector describing the target of the flexibility change
+	 * @param {sap.ui.core.ID} mParameters.appComponentId
+	 * @param {sap.ui.core.Control} mParameters.menu
 	 */
 	SplitMenuButton.pressHandler = function (oEvent, mParameters) {
 		var oMenuItem = JsControlTreeModifier.bySelector(mParameters.selector, Component.get(mParameters.appComponentId));

package/src/sap/m/delegate/DateNavigation.js

@@ -43,8 +43,8 @@ sap.ui.define([
 		});
 
 		/**
-		 * 24 hours as milliseconds
-		 * @type {number} milliseconds
+		 * 24 hours as milliseconds.
+		 * @type {int}
 		 * @private
 		 */
 		DateNavigation.HOURS24 = 1000 * 3600 * 24;

package/src/sap/m/designtime/ListBase.designtime.js

@@ -9,6 +9,21 @@ sap.ui.define([],
 	function() {
 		"use strict";
 
+		function isParentListBaseInstanceAndBound(oElement) {
+			var oParent = oElement;
+			while (oParent) {
+				if (oParent.isA("sap.m.ListBase")) {
+					var oBinding = oParent.getBinding("items");
+					if (oBinding) {
+						return true;
+					}
+					return false;
+				}
+				oParent = oParent.getParent();
+			}
+			return false;
+		}
+
 		return {
 			name: {
 				singular: "LIST_BASE_NAME",
@@ -22,6 +37,17 @@ sap.ui.define([],
 			},
 			aggregations: {
 				items: {
+					propagateMetadata: function(oElement) {
+						if (isParentListBaseInstanceAndBound(oElement)) {
+							return {
+								// prevent remove & rename actions on "items" aggregation and its inner controls when binding exists
+								actions: {
+									remove: null,
+									rename: null
+								}
+							};
+						}
+					},
 					domRef: ":sap-domref > .sapMListUl:not(.sapMGrowingList)",
 					actions: {
 						move: "moveControls"
@@ -39,6 +65,9 @@ sap.ui.define([],
 				},
 				contextMenu: {
 					ignore: true
+				},
+				noData: {
+					ignore: true
 				}
 			},
 			actions: {

package/src/sap/m/inputUtils/SuggestionsPopoverDialogMixin.js

@@ -96,7 +96,8 @@ sap.ui.define([
 		/**
 		 * Sets Show More button to <code>SuggestionsPopover</code>'s Dialog.
 		 *
-	 	 * @param {sap.m.Button} oShowMoreButton The "Show More" button for the Dialog's <code>endButton</code> aggregation
+		 * @param {sap.m.Button} oShowMoreButton The "Show More" button for the Dialog's <code>endButton</code> aggregation
+		 * @returns {this} This instance for method chaining.
 		 * @public
 		 */
 		this.setShowMoreButton = function(oShowMoreButton) {
@@ -107,6 +108,7 @@ sap.ui.define([
 		/**
 		 * Destroys Show More button from <code>SuggestionsPopover<code>'s Dialog.
 		 *
+		 * @returns {this} This instance for method chaining.
 		 * @public
 		 */
 		this.removeShowMoreButton = function() {
@@ -116,8 +118,8 @@ sap.ui.define([
 
 		/**
 		 * @override
-		 * @param fnHandler
-		 * @returns {sap.m.Button|null}
+		 * @param {function} fnHandler The press handler function.
+		 * @returns {sap.m.Button|null} The cancel button instance or null.
 		 */
 		this.setOkPressHandler = function (fnHandler) {
 			var oOkButton = this.getOkButton();
@@ -128,8 +130,8 @@ sap.ui.define([
 
 		/**
 		 * @override
-		 * @param fnHandler
-		 * @returns {sap.m.Button|null}
+		 * @param {function} fnHandler The press handler function.
+		 * @returns {sap.m.Button|null} The cancel button instance or null.
 		 */
 		this.setCancelPressHandler = function (fnHandler) {
 			var oCancelButton = this.getCancelButton();
@@ -140,8 +142,8 @@ sap.ui.define([
 
 		/**
 		 * @override
-		 * @param fnHandler
-		 * @returns {sap.m.ToggleButton|sap.m.Button|null}
+		 * @param {function} fnHandler The press handler function.
+		 * @returns {sap.m.ToggleButton|sap.m.Button|null} The filter selected button instance or null.
 		 */
 		this.setShowSelectedPressHandler = function (fnHandler) {
 			var oFilterSelectedButton = this.getFilterSelectedButton();
@@ -154,14 +156,15 @@ sap.ui.define([
 		 * Instantiates the dialog.
 		 *
 		 * @override
-		 * @param oInput
-		 * @param mOptions
-		 * @returns {sap.m.Dialog}
+		 * @param {sap.m.Input} oInput The parent Input control.
+		 * @param {object} mOptions Options object map.
+		 * @param {sap.m.Input} Input The input class as dependency injection.
+		 * @returns {sap.m.Dialog} The newly created picker.
 		 */
-		this.createPopover = function (oInput, mOptions) {
+		this.createPopover = function (oInput, mOptions, InputClass) {
 			var oMessageBundle = Core.getLibraryResourceBundle("sap.m"),
 				that = this,
-				oPopupInput = new sap.m.Input(oInput.getId() + "-popup-input", {
+				oPopupInput = InputClass && new InputClass(oInput.getId() + "-popup-input", {
 					width: "100%",
 					showValueStateMessage: false
 				});
@@ -245,9 +248,9 @@ sap.ui.define([
 		/**
 		 * Dialog's header content
 		 *
-		 * @param mOptions
-		 * @param oPopupInput
-		 * @return {sap.m.Toolbar} The toolbar
+		 * @param {object} mOptions Options map object.
+		 * @param {sap.m.Input} oPopupInput The picker's internal Input.
+		 * @return {sap.m.Toolbar} The newly created toolbar.
 		 * @private
 		 */
 		function _createSubHeaderContent(mOptions, oPopupInput) {
@@ -269,15 +272,18 @@ sap.ui.define([
 		 */
 		function _createFilterSelectedButton() {
 			var sIconURI = IconPool.getIconURI("multiselect-all");
+			var sSelectedItemsIconText = Core.getLibraryResourceBundle("sap.m").getText("SHOW_SELECTED_BUTTON");
 
 			return new ToggleButton({
-				icon: sIconURI
+				icon: sIconURI,
+				tooltip: sSelectedItemsIconText
 			});
 		}
 
 		/**
 		 * Gets the Value State Header instance.
 		 *
+		 * @returns {sap.m.ValueStateHeader} The value state header.
 		 * @private
 		 */
 		this._getValueStateHeader = function () {

package/src/sap/m/inputUtils/SuggestionsPopoverPopoverMixin.js

@@ -22,8 +22,8 @@ sap.ui.define([
 		 * Instrantiates the Popover
 		 *
 		 * @override
-		 * @param oInput
-		 * @returns {sap.m.Popover}
+		 * @param {sap.m.Input} oInput The parent Input control
+		 * @returns {sap.m.Popover} The newly created picker.
 		 */
 		this.createPopover = function (oInput) {
 			var that = this,
@@ -85,6 +85,7 @@ sap.ui.define([
 		 * Sets Show More button to <code>SuggestionsPopover</code>'s Popover.
 		 *
 	 	 * @param {sap.m.Toolbar} oButtonToolbar The "Show More" button toolbar for the Popover's <code>footer</code> aggregation
+		 * @return {this} This instance for method chaining.
 		 * @public
 		 */
 		this.setShowMoreButton = function(oButtonToolbar) {
@@ -96,6 +97,7 @@ sap.ui.define([
 		 * Destroys Show More button from <code>SuggestionsPopover</code>'s Popover.
 		 *
 		 * @public
+		 * @return {this} This instance for method chaining.
 		 */
 		this.removeShowMoreButton = function() {
 			this.getPopover().destroyAggregation("footer");
@@ -104,6 +106,10 @@ sap.ui.define([
 
 		/**
 		 * Helper function that overwrites popover in the Input.
+		 *
+		 * @param {sap.m.Popover} oPopover The picker popover's instance.
+		 * @param {sap.m.Input} oInput The parent input's instance.
+		 * @return {sap.m.Popover} The popover picker's instance.
 		 */
 		function _patchPopover(oPopover, oInput) {
 			oPopover.open = function () {
@@ -124,6 +130,7 @@ sap.ui.define([
 		 * Gets the Value State Header instance.
 		 *
 		 * @private
+		 * @returns {sap.m.ValueStateHeader} The value state header's instance.
 		 */
 		this._getValueStateHeader = function () {
 			var oPopover = this.getPopover();
@@ -140,6 +147,7 @@ sap.ui.define([
 		 * Creates the Value State Header instance.
 		 *
 		 * @private
+		 * @returns {sap.m.ValueStateHeader} The newly created value state header's instance.
 		 */
 		this._createValueStateHeader = function () {
 			var oValueStateHeader = new ValueStateHeader();

package/src/sap/m/inputUtils/highlightDOMElements.js

@@ -82,7 +82,7 @@ sap.ui.define([
 	 * @param {Array<HTMLElement>} aItemsDomRef DOM elements on which formatting would be applied
 	 * @param {string} sInputValue Text to highlight
 	 * @param {boolean} bWordMode Whether to highlight single string or to highlight each string that starts with space + sInputValue
-	 * @param {integer} iLimit Threshold of the items to enable highlighting. Above that limit, highlighting would be disabled due to performance reasons- DOM trashing. Default: 200
+	 * @param {int} iLimit Threshold of the items to enable highlighting. Above that limit, highlighting would be disabled due to performance reasons- DOM trashing. Default: 200
 	 * @ui5-restricted
 	 */
 	var highlightItems = function (aItemsDomRef, sInputValue, bWordMode, iLimit) {

package/src/sap/m/inputUtils/typeAhead.js

@@ -17,7 +17,7 @@ sap.ui.define(["sap/ui/Device"], function (Device) {
 	 *
 	 * @param sValue {string} Typed in value.
 	 * @param oInput {sap.m.Input} Input to act upon.
-	 * @param aItems {array<T>} Items to pick from.
+	 * @param aItems {Array<T>} Items to pick from.
 	 * @param vTextGetter {string|function} Name of method in oInput or a function which extracts the text.
 	 * @returns {Array<T>} A sorted array of matching items. The first item is the one that's being highlighted.
 	 */
@@ -65,9 +65,9 @@ sap.ui.define(["sap/ui/Device"], function (Device) {
 	 * A custom getter string could be provided to support further scenarios. The default one is <code>getText</code>.
 	 *
 	 * @param sTextToFilter {string}
-	 * @param aItems {array<T>}
+	 * @param aItems {Array<T>}
 	 * @param vTextGetter {string|function}
-	 * @returns {array<T>}
+	 * @returns {Array<T>}
 	 * @private
 	 */
 	function _filterItems(sTextToFilter, aItems, vTextGetter) {
@@ -110,9 +110,9 @@ sap.ui.define(["sap/ui/Device"], function (Device) {
 	 * 2. ["bar", "foo"]
 	 *
 	 * @param sTextToFilter {string}
-	 * @param aItems {array<T>}
+	 * @param aItems {Array<T>}
 	 * @param vTextGetter {string|function}
-	 * @returns {array<T>}
+	 * @returns {Array<T>}
 	 * @private
 	 */
 	function _sortItems(sTextToFilter, aItems, vTextGetter) {
@@ -149,7 +149,7 @@ sap.ui.define(["sap/ui/Device"], function (Device) {
 	 *
 	 * @param oItem {Object}
 	 * @param vTextGetter {string|function}
-	 * @returns {array<string>}
+	 * @returns {Array<string>}
 	 * @private
 	 */
 	function _extractTextsFromItem(oItem, vTextGetter) {
@@ -191,7 +191,7 @@ sap.ui.define(["sap/ui/Device"], function (Device) {
 	/**
 	 * Returns the first/best match of a startsWith.
 	 *
-	 * @param aTexts {array<string>}
+	 * @param aTexts {Array<string>}
 	 * @param sSearch {string}
 	 * @returns {string}
 	 * @private