@openui5/sap.m 1.96.5 → 1.99.0

package/src/sap/m/SliderRenderer.js

@@ -27,7 +27,7 @@ sap.ui.define(['./SliderUtilities', "sap/ui/core/InvisibleText"],
 		 * Renders the HTML for the given 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} oSlider An object representation of the slider that should be rendered.
+		 * @param {sap.m.Slider} oSlider An object representation of the slider that should be rendered.
 		 */
 		SliderRenderer.render = function(oRm, oSlider) {
 			var bEnabled = oSlider.getEnabled(),
@@ -93,7 +93,7 @@ sap.ui.define(['./SliderUtilities', "sap/ui/core/InvisibleText"],
 		 * This hook method is reserved for derived classes to render more handles.
 		 *
 		 * @param {sap.ui.core.RenderManager} oRm The RenderManager that can be used for writing to the render output buffer.
-		 * @param {sap.ui.core.Control} oSlider An object representation of the slider that should be rendered.
+		 * @param {sap.m.Slider} oSlider An object representation of the slider that should be rendered.
 		 */
 		SliderRenderer.renderHandles = function(oRm, oSlider, sForwardedLabels) {
 			this.renderHandle(oRm, oSlider,  {
@@ -133,7 +133,7 @@ sap.ui.define(['./SliderUtilities', "sap/ui/core/InvisibleText"],
 		 * To be overwritten by subclasses.
 		 *
 		 * @param {sap.ui.core.RenderManager} oRm The RenderManager that can be used for writing to the render output buffer.
-		 * @param {sap.ui.core.Control} oSlider An object representation of the control that should be rendered.
+		 * @param {sap.m.Slider} oSlider An object representation of the control that should be rendered.
 		 */
 		SliderRenderer.writeHandleTooltip = function(oRm, oSlider) {
 			oRm.attr("title", oSlider._formatValueByCustomElement(oSlider.toFixed(oSlider.getValue())));
@@ -157,7 +157,7 @@ sap.ui.define(['./SliderUtilities', "sap/ui/core/InvisibleText"],
 		 * To be overwritten by subclasses.
 		 *
 		 * @param {sap.ui.core.RenderManager} oRm The RenderManager that can be used for writing to the render output buffer.
-		 * @param {sap.ui.core.Control} oSlider An object representation of the control that should be rendered.
+		 * @param {sap.m.Slider} oSlider An object representation of the control that should be rendered.
 		 */
 		SliderRenderer.writeAccessibilityState = function(oRm, oSlider, mOptions) {
 			var fSliderValue = oSlider.getValue(),
@@ -287,7 +287,7 @@ sap.ui.define(['./SliderUtilities', "sap/ui/core/InvisibleText"],
 		 * This method is reserved for derived classes to add extra CSS classes to the HTML root element of the control.
 		 *
 		 * @param {sap.ui.core.RenderManager} oRm The RenderManager that can be used for writing to the render output buffer.
-		 * @param {sap.ui.core.Control} oSlider An object representation of the control that should be rendered.
+		 * @param {sap.m.Slider} oSlider An object representation of the control that should be rendered.
 		 * @since 1.36
 		 */
 		SliderRenderer.addClass = function(oRm, oSlider) {
@@ -298,7 +298,7 @@ sap.ui.define(['./SliderUtilities', "sap/ui/core/InvisibleText"],
 		 * This method is reserved for derived classes to add extra CSS classes to the inner element.
 		 *
 		 * @param {sap.ui.core.RenderManager} oRm The RenderManager that can be used for writing to the render output buffer.
-		 * @param {sap.ui.core.Control} oSlider An object representation of the control that should be rendered.
+		 * @param {sap.m.Slider} oSlider An object representation of the control that should be rendered.
 		 * @since 1.38
 		 */
 		SliderRenderer.addInnerClass = function(oRm, oSlider) {
@@ -309,7 +309,7 @@ sap.ui.define(['./SliderUtilities', "sap/ui/core/InvisibleText"],
 		 * This method is reserved for derived classes to add extra CSS classes to the progress indicator element.
 		 *
 		 * @param {sap.ui.core.RenderManager} oRm The RenderManager that can be used for writing to the render output buffer.
-		 * @param {sap.ui.core.Control} oSlider An object representation of the control that should be rendered.
+		 * @param {sap.m.Slider} oSlider An object representation of the control that should be rendered.
 		 * @since 1.38
 		 */
 		SliderRenderer.addProgressIndicatorClass = function(oRm, oSlider) {
@@ -320,7 +320,7 @@ sap.ui.define(['./SliderUtilities', "sap/ui/core/InvisibleText"],
 		 * This method is reserved for derived classes to add extra CSS classes to the handle element.
 		 *
 		 * @param {sap.ui.core.RenderManager} oRm The RenderManager that can be used for writing to the render output buffer.
-		 * @param {sap.ui.core.Control} oSlider An object representation of the control that should be rendered.
+		 * @param {sap.m.Slider} oSlider An object representation of the control that should be rendered.
 		 * @since 1.38
 		 */
 		SliderRenderer.addHandleClass = function(oRm, oSlider) {
@@ -331,7 +331,7 @@ sap.ui.define(['./SliderUtilities', "sap/ui/core/InvisibleText"],
 		 * This hook method is reserved for derived classes to render the labels.
 		 *
 		 * @param {sap.ui.core.RenderManager} oRm The RenderManager that can be used for writing to the render output buffer.
-		 * @param {sap.ui.core.Control} oSlider An object representation of the control that should be rendered.
+		 * @param {sap.m.Slider} oSlider An object representation of the control that should be rendered.
 		 */
 		SliderRenderer.renderLabels = function (oRm, oSlider) {
 			oSlider.getAggregation("_handlesLabels").forEach(oRm.renderControl, oRm);

package/src/sap/m/SliderTooltip.js

@@ -44,7 +44,7 @@ function(
 		 * @extends sap.m.SliderTooltipBase
 		 *
 		 * @author SAP SE
-		 * @version 1.96.5
+		 * @version 1.99.0
 		 *
 		 * @constructor
 		 * @private
@@ -207,11 +207,11 @@ function(
 		 * instance to be announced by screen readers because the value state
 		 * popup and the aria-errormessage attribute is added on the fly and not announced otherwise
 		 *
-		 * @param {string} sStateType The value state type to be announced by screen readers
+		 * @param {string} sValueStateType The value state type to be announced by screen readers
 		 *
 		 * @private
 		 */
-		SliderTooltip.prototype._invisibleMessageAnnouncement = function (sValueStateType, bOpenValueStateMessage) {
+		SliderTooltip.prototype._invisibleMessageAnnouncement = function (sValueStateType) {
 			if (sValueStateType !== ValueState.Error) {
 				return;
 			}

package/src/sap/m/SliderTooltipBase.js

@@ -21,7 +21,7 @@ function(Control, Library, SliderTooltipBaseRenderer) {
 		 * @abstract
 		 *
 		 * @author SAP SE
-		 * @version 1.96.5
+		 * @version 1.99.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/SliderTooltipBaseRenderer.js

@@ -25,7 +25,7 @@ sap.ui.define(['sap/ui/core/Renderer'],
 		 * Renders the HTML for the given 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 renderer output buffer
-		 * @param {sap.ui.core.Control} oControl An object representation of the control that should be rendered
+		 * @param {sap.m.SliderTooltipBase} oControl An object representation of the control that should be rendered
 		 */
 		SliderTooltipBaseRenderer.render = function (oRM, oControl) {
 			oRM.openStart("div", oControl)
@@ -41,7 +41,7 @@ sap.ui.define(['sap/ui/core/Renderer'],
 		 * To be overwritten by subclasses.
 		 *
 		 * @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.SliderTooltipBase} oControl An object representation of the control that should be rendered.
 		 */
 		SliderTooltipBaseRenderer.renderTooltipContent = function (oRM, oControl) {};
 

package/src/sap/m/SliderTooltipContainer.js

@@ -35,7 +35,7 @@ function(
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.96.5
+		 * @version 1.99.0
 		 *
 		 * @constructor
 		 * @private
@@ -277,7 +277,7 @@ function(
 		 * @param {float} fMin Min property of the Slider/RangeSlider.
 		 * @param {float} fMax Max property of the Slider/RangeSlider.
 		 * @private
-		 * @return {String}
+		 * @return {string}
 		 */
 		SliderTooltipContainer.prototype._getTooltipPosition = function (fTooltipValue, fMin, fMax) {
 			var fPerValue = SliderUtilities.getPercentOfValue(+(fTooltipValue), fMin, fMax),

package/src/sap/m/SliderTooltipContainerRenderer.js

@@ -26,7 +26,7 @@ sap.ui.define(['sap/ui/core/Renderer'],
 	 * Renders the HTML for the given 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 renderer output buffer
-	 * @param {sap.ui.core.Control} oControl An object representation of the control that should be rendered
+	 * @param {sap.m.SliderTooltipContainer} oControl An object representation of the control that should be rendered
 	 */
 	SliderTooltipContainerRenderer.render = function(oRm, oControl) {
 		var aTooltips = oControl.getAssociatedTooltipsAsControls();

package/src/sap/m/SliderTooltipRenderer.js

@@ -25,7 +25,7 @@ sap.ui.define(['sap/ui/core/Renderer', "sap/ui/core/Core"],
 	 * Renders the HTML for the given 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 renderer output buffer
-	 * @param {sap.ui.core.Control} oControl An object representation of the control that should be rendered
+	 * @param {sap.m.SliderTooltip} oControl An object representation of the control that should be rendered
 	 */
 	SliderTooltipRenderer.render = function(oRM, oControl){
 		oRM.openStart("div", oControl)

package/src/sap/m/SplitApp.js

@@ -36,7 +36,7 @@ sap.ui.define([
 	 * @extends sap.m.SplitContainer
 	 *
 	 * @author SAP SE
-	 * @version 1.96.5
+	 * @version 1.99.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/SplitButton.js

@@ -48,7 +48,7 @@ function(
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.96.5
+		 * @version 1.99.0
 		 *
 		 * @constructor
 		 * @private
@@ -190,6 +190,7 @@ function(
 
 			if (!oCtrl) {
 				oCtrl = new Button({
+					id: this.getId() + "-textButton",
 					width: '100%',
 					icon: this.getIcon(),
 					text: this.getText(),
@@ -207,6 +208,7 @@ function(
 
 			if (!oCtrl) {
 				oCtrl = new Button({
+					id: this.getId() + "-arrowButton",
 					icon: "sap-icon://slim-arrow-down",
 					press: this._handleAction.bind(this, true),
 					tooltip: sap.ui.getCore().getLibraryResourceBundle("sap.m").getText("SPLIT_BUTTON_ARROW_TOOLTIP"),

package/src/sap/m/SplitButtonRenderer.js

@@ -29,7 +29,7 @@ sap.ui.define(["sap/m/library", "sap/ui/core/InvisibleText", "sap/ui/core/Shortc
 		 * @param {sap.ui.core.RenderManager} oRm
 		 *            the RenderManager that can be used for writing to
 		 *            the Render-Output-Buffer
-		 * @param {sap.ui.core.Control} oButton
+		 * @param {sap.m.SplitButton} oButton
 		 *            the button to be rendered
 		 */
 		SplitButtonRenderer.render = function(oRm, oButton) {

package/src/sap/m/SplitContainer.js

@@ -86,7 +86,7 @@ function(
 	 *
 	 * @extends sap.ui.core.Control
 	 * @author SAP SE
-	 * @version 1.96.5
+	 * @version 1.99.0
 	 *
 	 * @constructor
 	 * @public
@@ -817,7 +817,6 @@ function(
 	 *
 	 *         NOTE: It depends on the transition function how the object should be structured and which parameters are actually used to influence the transition.
 	 *         The "show", "slide" and "fade" transitions do not use any parameter.
-	 * @type this
 	 * @public
 	 * @since 1.10.0
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
@@ -859,7 +858,6 @@ function(
 	 *         In order to use the transitionParameters property, the data property must be used (at least "null" must be given) for a proper parameter order.
 	 *
 	 *         NOTE: it depends on the transition function how the object should be structured and which parameters are actually used to influence the transition.
-	 * @type this
 	 * @public
 	 * @since 1.10.0
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
@@ -874,10 +872,10 @@ function(
 
 	/**
 	 * Proxy to the _safeBackToPage methods of the internal nav containers
-	 * @param pageId
-	 * @param transitionName
-	 * @param backData
-	 * @param oTransitionParameters
+	 * @param {string} pageId
+	 * @param {string} transitionName
+	 * @param {object} backData
+	 * @param {object} oTransitionParameters
 	 * @private
 	 */
 	SplitContainer.prototype._safeBackToPage = function(pageId, transitionName, backData, oTransitionParameters) {
@@ -901,7 +899,7 @@ function(
 	 *         Options are "slide" (horizontal movement from the right), "baseSlide", "fade", "flip", and "show" and the names of any registered custom transitions.
 	 * @param {object} oData
 	 *         This optional object can carry any payload data which would have been given to the inserted previous page if the user would have done a normal forward navigation to it.
-	 * @type this
+	 * @returns {this}
 	 * @public
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
@@ -939,7 +937,6 @@ function(
 	 *
 	 *         NOTE: it depends on the transition function how the object should be structured and which parameters are actually used to influence the transition.
 	 *         The "show", "slide" and "fade" transitions do not use any parameter.
-	 * @type this
 	 * @public
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
@@ -959,14 +956,13 @@ function(
 	 *         For back navigation this can be used, for example, when returning from a detail page to transfer any settings done there.
 	 *
 	 *         When the transitionParameters object is used, this data object must also be given (either as object or as null) in order to have a proper parameter order.
-	 * @param {object} oTransitionParameter
+	 * @param {object} oTransitionParameters
 	 *         This optional object can give additional information to the transition function, like the DOM element, which triggered the transition or the desired transition duration.
 	 *         The animation type can NOT be selected here - it is always the inverse of the "to" navigation.
 	 *
 	 *         In order to use the transitionParameters property, the data property must be used (at least "null" must be given) for a proper parameter order.
 	 *
 	 *         NOTE: it depends on the transition function how the object should be structured and which parameters are actually used to influence the transition.
-	 * @type this
 	 * @public
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
@@ -994,14 +990,13 @@ function(
 	 *         Use case: in scenarios where the entity triggering the navigation can or should not directly initialize the target page, it can fill this object and the target page itself (or a listener on it) can take over the initialization, using the given data.
 	 *
 	 *         When the transitionParameters object is used, this data object must also be given (either as object or as null) in order to have a proper parameter order.
-	 * @param {object} oTransitionParameter
+	 * @param {object} oTransitionParameters
 	 *         This optional object can contain additional information for the transition function, like the DOM element, which triggered the transition or the desired transition duration.
 	 *
 	 *         For a proper parameter order, the data parameter must be given when the transitionParameters parameter is used (it can be given as "null").
 	 *
 	 *         NOTE: it depends on the transition function how the object should be structured and which parameters are actually used to influence the transition.
 	 *         The "show", "slide" and "fade" transitions do not use any parameter.
-	 * @type this
 	 * @public
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
@@ -1020,14 +1015,13 @@ function(
 	 *         For back navigation this can be used, for example, when returning from a detail page to transfer any settings done there.
 	 *
 	 *         When the transitionParameters object is used, this data object must also be given (either as object or as null) in order to have a proper parameter order.
-	 * @param {object} oTransitionParameter
+	 * @param {object} oTransitionParameters
 	 *         This optional object can give additional information to the transition function, like the DOM element, which triggered the transition or the desired transition duration.
 	 *         The animation type can NOT be selected here - it is always the inverse of the "to" navigation.
 	 *
 	 *         In order to use the transitionParameters property, the data property must be used (at least "null" must be given) for a proper parameter order.
 	 *
 	 *         NOTE: it depends on the transition function how the object should be structured and which parameters are actually used to influence the transition.
-	 * @type this
 	 * @public
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
@@ -1052,14 +1046,13 @@ function(
 	 *         For back navigation this can be used e.g. when returning from a detail page to transfer any settings done there.
 	 *
 	 *         When the "transitionParameters" object is used, this "data" object must also be given (either as object or as null) in order to have a proper parameter order.
-	 * @param {object} oTransitionParameter
+	 * @param {object} oTransitionParameters
 	 *         This optional object can give additional information to the transition function, like the DOM element which triggered the transition or the desired transition duration.
 	 *         The animation type can NOT be selected here - it is always the inverse of the "to" navigation.
 	 *
 	 *         In order to use the transitionParameters property, the data property must be used (at least "null" must be given) for a proper parameter order.
 	 *
 	 *         NOTE: it depends on the transition function how the object should be structured and which parameters are actually used to influence the transition.
-	 * @type sap.ui.core.Control
 	 * @public
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
@@ -1080,14 +1073,13 @@ function(
 	 *         For back navigation this can be used, for example, when returning from a detail page to transfer any settings done there.
 	 *
 	 *         When the transitionParameters object is used, this data object must also be given (either as object or as null) in order to have a proper parameter order.
-	 * @param {object} oTransitionParameter
+	 * @param {object} oTransitionParameters
 	 *         This optional object can give additional information to the transition function, like the DOM element, which triggered the transition or the desired transition duration.
 	 *         The animation type can NOT be selected here - it is always the inverse of the "to" navigation.
 	 *
 	 *         In order to use the transitionParameters property, the data property must be used (at least "null" must be given) for a proper parameter order.
 	 *
 	 *         NOTE: it depends on the transition function how the object should be structured and which parameters are actually used to influence the transition.
-	 * @type sap.ui.core.Control
 	 * @public
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
@@ -1285,7 +1277,7 @@ function(
 	 *         The content entities between which this SplitContainer navigates in either master area or detail area depending on the master parameter. These can be of type sap.m.Page, sap.ui.core.mvc.View, sap.m.Carousel or any other control with fullscreen/page semantics.
 	 * @param {boolean} bMaster
 	 *         States if the page should be added to the master area. If it's set to false, the page is added to detail area.
-	 * @type this
+	 * @returns {this}
 	 * @public
 	 * @since 1.11.1
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
@@ -1302,7 +1294,7 @@ function(
 	/**
 	 * Used to make the master page visible when in ShowHideMode and the device is in portrait mode.
 	 *
-	 * @type this
+	 * @@returns {this}
 	 * @public
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
@@ -1358,7 +1350,7 @@ function(
 	/**
 	 * Used to hide the master page when in ShowHideMode and the device is in portrait mode.
 	 *
-	 * @type this
+	 * @returns {this}
 	 * @public
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
 	 */
@@ -1484,7 +1476,8 @@ function(
 	 *
 	 * @param {string} sId
 	 *         The ID of the page that needs to be fetched
-	 * @type sap.ui.core.Control
+	 * @returns {sap.ui.core.Control|null}
+	 *         The requested page
 	 * @public
 	 * @since 1.11.1
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
@@ -1498,7 +1491,7 @@ function(
 	 * Returns the page with the given ID in detail area. If there's no page that has the given ID, null is returned.
 	 *
 	 * @param {string} sId The ID of the page that needs to be fetched.
-	 * @type sap.ui.core.Control
+	 * @returns {sap.ui.core.Control|null} the requested page
 	 * @public
 	 * @since 1.11.1
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
@@ -1511,11 +1504,11 @@ function(
 	/**
 	 * Returns the page with the given ID from either master area, or detail area depending on the master parameter (if there's no page that has the given ID, null is returned).
 	 *
-	 * @param {string} sId
+	 * @param {string} pageId
 	 *         The ID of the page that needs to be fetched
 	 * @param {boolean} bMaster
 	 *         If the page with given ID should be fetched from the master area. If it's set to false, the page will be fetched from detail area.
-	 * @type sap.ui.core.Control
+	 * @returns {sap.ui.core.Control|null}
 	 * @public
 	 * @since 1.11.1
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel
@@ -1530,12 +1523,12 @@ function(
 
 
 	/**
-	 *
 	 * Returns whether master area is currently displayed on the screen.
+	 *
 	 * In desktop browser or tablet, this method returns true when master area is displayed on the screen, regardless if in portrait or landscape mode.
 	 * On mobile phone devices, this method returns true when the currently displayed page is from the pages, which are added to the master area, otherwise, it returns false.
 	 *
-	 * @type boolean
+	 * @returns {boolean}
 	 * @public
 	 * @since 1.16.5
 	 * @ui5-metamodel This method also will be described in the UI5 (legacy) designtime metamodel