@openui5/sap.m 1.96.5 → 1.99.0

package/src/sap/m/Select.js

@@ -100,7 +100,7 @@ function(
 		 * @implements sap.ui.core.IFormContent, sap.ui.core.ISemanticFormContent
 		 *
 		 * @author SAP SE
-		 * @version 1.96.5
+		 * @version 1.99.0
 		 *
 		 * @constructor
 		 * @public
@@ -539,7 +539,7 @@ function(
 			var	sValueStateText = this._getValueStateText();
 
 			if (this._oInvisibleMessage) {
-				this._oInvisibleMessage.announce(sValueStateText, InvisibleMessageMode.Assertive);
+				this._oInvisibleMessage.announce(sValueStateText, InvisibleMessageMode.Polite);
 			}
 		};
 
@@ -2050,9 +2050,8 @@ function(
 		/**
 		 * Synchronizes the <code>selectedItem</code> association and the <code>selectedItemId</code> property.
 		 *
-		 * @param {sap.ui.core.Item} vItem
-		 * @param {string} sKey
-		 * @param {array} [aItems]
+		 * @param {object} [mOptions] Options
+		 * @param {boolean} [mOptions.forceSelection] Whether to force a selection
 		 */
 		Select.prototype.synchronizeSelection = function() {
 			SelectList.prototype.synchronizeSelection.apply(this, arguments);
@@ -2157,6 +2156,9 @@ function(
 					}
 				}
 			}, this)
+			.addEventDelegate({
+				onAfterRendering: this.onAfterRenderingList
+			}, this)
 			.attachSelectionChange(this.onSelectionChange, this);
 
 			 this._oList.setProperty("_tabIndex", "-1");
@@ -2214,6 +2216,11 @@ function(
 			fnOnAfterRenderingPickerType && fnOnAfterRenderingPickerType.call(this);
 		};
 
+		/**
+		 * This event handler is called after the SelectList is rendered.
+		 */
+		 Select.prototype.onAfterRenderingList = function(){};
+
 		/**
 		 * Open the control's picker popup.
 		 *
@@ -3083,7 +3090,10 @@ function(
 		 * @returns {object} The <code>sap.m.Select</code> accessibility information
 		 */
 		Select.prototype.getAccessibilityInfo = function() {
-			var bIconOnly = this._isIconOnly(),
+			var aDescriptions = [],
+				sDescription = "",
+				oResourceBundle = Core.getLibraryResourceBundle("sap.m"),
+				bIconOnly = this._isIconOnly(),
 				oInfo = {
 					role: this.getRenderer().getAriaRole(this),
 					focusable: this.getEnabled(),
@@ -3098,13 +3108,21 @@ function(
 					sDesc = oIconInfo && oIconInfo.text ? oIconInfo.text : "";
 				}
 
-				oInfo.type = Core.getLibraryResourceBundle("sap.m").getText("ACC_CTR_TYPE_BUTTON");
-				oInfo.description = sDesc;
+				oInfo.type = oResourceBundle.getText("ACC_CTR_TYPE_BUTTON");
+				aDescriptions.push(sDesc);
 			} else if (this.getType() === "Default") {
-				oInfo.type = Core.getLibraryResourceBundle("sap.m").getText("SELECT_ROLE_DESCRIPTION");
-				oInfo.description = this._getSelectedItemText();
+				oInfo.type = oResourceBundle.getText("SELECT_ROLE_DESCRIPTION");
+				aDescriptions.push(this._getSelectedItemText());
+			}
+
+			if (this._isRequired()) {
+				aDescriptions.push(oResourceBundle.getText("SELECT_REQUIRED"));
 			}
 
+			sDescription = aDescriptions.join(" ").trim();
+			if (sDescription) {
+				oInfo.description = sDescription;
+			}
 			return oInfo;
 		};
 

package/src/sap/m/SelectDialog.js

@@ -112,7 +112,7 @@ function(
 	 * @extends sap.m.SelectDialogBase
 	 *
 	 * @author SAP SE
-	 * @version 1.96.5
+	 * @version 1.99.0
 	 *
 	 * @constructor
 	 * @public
@@ -165,7 +165,7 @@ function(
 			/**
 			 * This flag controls whether the dialog clears the selection after the confirm event has been fired. If the dialog needs to be opened multiple times in the same context to allow for corrections of previous user inputs, set this flag to <code>true</code>.
 			 *
-			 * <b>Note:</b> The sap.m.SelectDialog uses {@link sap.m.ListBase#rememberSelections this} property of the ListBase and therefore its limitations also apply here.
+			 * <b>Note:</b> The sap.m.SelectDialog uses {@link sap.m.ListBase#rememberSelections this} property of the ListBase and therefore its behavior and restrictions also apply here.
 			 * @since 1.18
 			 */
 			rememberSelections : {type : "boolean", group : "Behavior", defaultValue : false},

package/src/sap/m/SelectDialogBase.js

@@ -27,7 +27,7 @@ function(
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.96.5
+	 * @version 1.99.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/SelectList.js

@@ -37,7 +37,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.96.5
+		 * @version 1.99.0
 		 *
 		 * @constructor
 		 * @public
@@ -325,8 +325,7 @@ sap.ui.define([
 		/**
 		 * Retrieves the enabled items DOM references.
 		 *
-		 * @param {object} [oDomRef] The selectList DOM reference.
-		 * @returns {array} The enabled items DOM references.
+		 * @returns {Element[]} The enabled items DOM references.
 		 * @private
 		 */
 		SelectList.prototype._queryEnabledItemsDomRefs = function() {
@@ -591,6 +590,8 @@ sap.ui.define([
 		/*
 		 * Synchronize selected item and key.
 		 *
+		 * @param {object} [mOptions] Options
+		 * @param {boolean} [mOptions.forceSelection] Whether to force a selection
 		 * @protected
 		 */
 		SelectList.prototype.synchronizeSelection = function(mOptions) {

package/src/sap/m/SelectListRenderer.js

@@ -31,7 +31,7 @@ sap.ui.define(["sap/ui/core/Element", "sap/ui/core/library", "sap/ui/core/Icon",
 		 * 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} oList An object representation of the control that should be rendered.
+		 * @param {sap.m.SelectionList} oList An object representation of the control that should be rendered.
 		 */
 		SelectListRenderer.render = function(oRm, oList) {
 			this.writeOpenListTag(oRm, oList, { elementData: true });
@@ -76,7 +76,7 @@ sap.ui.define(["sap/ui/core/Element", "sap/ui/core/library", "sap/ui/core/Icon",
 		 * 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} oList An object representation of the control that should be rendered.
+		 * @param {sap.m.SelectionList} oList An object representation of the control that should be rendered.
 		 */
 		SelectListRenderer.renderItems = function(oRm, oList) {
 			var iSize = oList._getNonSeparatorItemsCount(),
@@ -116,7 +116,7 @@ sap.ui.define(["sap/ui/core/Element", "sap/ui/core/library", "sap/ui/core/Icon",
 		 * 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} oList An object representation of the control that should be rendered.
+		 * @param {sap.m.SelectionList} oList An object representation of the control that should be rendered.
 		 * @param {sap.ui.core.Element} oItem An object representation of the element that should be rendered.
 		 * @param {object} mStates
 		 * @param {boolean} bForceSelectedVisualState Forces the visual focus (selected state) to be se on the item.
@@ -238,7 +238,7 @@ sap.ui.define(["sap/ui/core/Element", "sap/ui/core/library", "sap/ui/core/Icon",
 		 * 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} oList An object representation of the control that should be rendered.
+		 * @param {sap.m.SelectionList} oList An object representation of the control that should be rendered.
 		 */
 		SelectListRenderer.writeAccessibilityState = function(oRm, oList) {
 			oRm.accessibilityState(oList, {
@@ -251,7 +251,7 @@ sap.ui.define(["sap/ui/core/Element", "sap/ui/core/library", "sap/ui/core/Icon",
 		 * 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} oList An object representation of the control that should be rendered.
+		 * @param {sap.m.SelectionList} oList An object representation of the control that should be rendered.
 		 * @param {sap.ui.core.Element} oItem An object representation of the element that should be rendered.
 		 * @param {object} mStates
 		 */

package/src/sap/m/SelectRenderer.js

@@ -334,7 +334,7 @@ sap.ui.define(['sap/ui/core/Renderer', 'sap/ui/core/IconPool', 'sap/m/library',
 		 * This method is reserved for derived class to add extra 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} oSelect An object representation of the control that should be rendered.
+		 * @param {sap.m.Select} oSelect An object representation of the control that should be rendered.
 		 * @protected
 		 */
 		SelectRenderer.addClass = function(oRm, oSelect) {};
@@ -344,7 +344,7 @@ sap.ui.define(['sap/ui/core/Renderer', 'sap/ui/core/IconPool', 'sap/m/library',
 		 * 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} oSelect An object representation of the control that should be rendered.
+		 * @param {sap.m.Select} oSelect An object representation of the control that should be rendered.
 		 */
 		SelectRenderer.addValueStateClasses = function(oRm, oSelect) {
 			oRm.class(SelectRenderer.CSS_CLASS + "State");
@@ -355,7 +355,7 @@ sap.ui.define(['sap/ui/core/Renderer', 'sap/ui/core/IconPool', 'sap/m/library',
 		 * Gets accessibility role.
 		 * To be overwritten by subclasses.
 		 *
-		 * @param {sap.ui.core.Control} oSelect An object representation of the control that should be rendered.
+		 * @param {sap.m.Select} oSelect An object representation of the control that should be rendered.
 		 * @protected
 		 */
 		SelectRenderer.getAriaRole = function(oSelect) {
@@ -375,7 +375,7 @@ sap.ui.define(['sap/ui/core/Renderer', 'sap/ui/core/IconPool', 'sap/m/library',
 		 * 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} oSelect An object representation of the control that should be rendered.
+		 * @param {sap.m.Select} oSelect An object representation of the control that should be rendered.
 		 */
 		SelectRenderer.writeAccessibilityState = function(oRm, oSelect) {
 			var sValueState = oSelect.getValueState(),
@@ -443,7 +443,7 @@ sap.ui.define(['sap/ui/core/Renderer', 'sap/ui/core/IconPool', 'sap/m/library',
 		 * Render value state accessibility DOM nodes for screen readers.
 		 *
 		 * @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.Select} oControl An object representation of the control that should be rendered.
 		 */
 		SelectRenderer.renderAccessibilityDomNodes = function (oRm, oControl) {
 			var sValueState = oControl.getValueState(),

package/src/sap/m/SelectionDetails.js

@@ -39,7 +39,7 @@ function(
 	 * <b><i>Note:</i></b>It is protected and should only be used within the framework itself.
 	 *
 	 * @author SAP SE
-	 * @version 1.96.5
+	 * @version 1.99.0
 	 *
 	 * @extends sap.ui.core.Control
 	 * @constructor

package/src/sap/m/SelectionDetailsFacade.js

@@ -10,7 +10,7 @@
  * @since 1.48.0
  * @public
  * @author SAP SE
- * @version 1.96.5
+ * @version 1.99.0
  * @borrows sap.ui.core.Element#addCustomData as #addCustomData
  * @borrows sap.ui.core.Element#getCustomData as #getCustomData
  * @borrows sap.ui.core.Element#indexOfCustomData as #indexOfCustomData
@@ -45,7 +45,7 @@
  * @since 1.48.0
  * @public
  * @author SAP SE
- * @version 1.96.5
+ * @version 1.99.0
  * @borrows sap.ui.core.Element#addCustomData as #addCustomData
  * @borrows sap.ui.core.Element#getCustomData as #getCustomData
  * @borrows sap.ui.core.Element#indexOfCustomData as #indexOfCustomData

package/src/sap/m/SelectionDetailsItem.js

@@ -58,7 +58,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.96.5
+	 * @version 1.99.0
 	 *
 	 * @constructor
 	 * @protected

package/src/sap/m/SelectionDetailsItemLine.js

@@ -23,7 +23,7 @@ sap.ui.define(["sap/ui/core/Element", "sap/base/Log", "sap/base/util/isPlainObje
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.96.5
+	 * @version 1.99.0
 	 *
 	 * @constructor
 	 * @protected

package/src/sap/m/SelectionDetailsRenderer.js

@@ -19,7 +19,7 @@ sap.ui.define([],
 	 * 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} oControl The control to be rendered
+	 * @param {sap.m.SelectionDetails} oControl The control to be rendered
 	 * @public
 	 */
 	SelectionDetailsRenderer.render = function(oRm, oControl) {

package/src/sap/m/Shell.js

@@ -35,7 +35,7 @@ sap.ui.define([
 		 * The Shell control can be used as root element of applications. It can contain an App or a <code>SplitApp</code> control.
 		 * The Shell provides some overarching functionality for the overall application and takes care of visual adaptation, such as a frame around the App, on desktop browser platforms.
 		 * @extends sap.ui.core.Control
-		 * @version 1.96.5
+		 * @version 1.99.0
 		 *
 		 * @constructor
 		 * @public
@@ -113,15 +113,15 @@ sap.ui.define([
 				 * Different image sizes for device home screen need to be given as PNG images, an ICO file needs to be given as desktop browser bookmark icon (other file formats may not work in all browsers).
 				 * The <code>precomposed</code> flag defines whether there is already a glow effect contained in the home screen images (or whether iOS should add such an effect). The given structure could look like this:
 				 * {
-			 * 'phone':'phone-icon_57x57.png',
-			 * 'phone@2':'phone-retina_114x114.png',
+				 * 'phone':'phone-icon_57x57.png',
+				 * 'phone@2':'phone-retina_114x114.png',
 				 * 'tablet':'tablet-icon_72x72.png',
 				 * 'tablet@2':'tablet-retina_144x144.png',
 				 * 'precomposed':true,
 				 * 'favicon':'favicon.ico'
 				 * }
 				 *
-				 * See jQuery.sap.setIcons() for full documentation.
+				 * See {@link module:sap/ui/util/Mobile.setIcons} for full documentation.
 				 *
 				 */
 				homeIcon : {type : "object", group : "Misc", defaultValue : null},

package/src/sap/m/ShellRenderer.js

@@ -32,7 +32,7 @@ function(coreLibrary, library) {
 	 * Renders the HTML for the given control, using the provided {@link sap.ui.core.RenderManager}.
 	 *
 	 * @param {sap.ui.core.RenderManager} rm 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.Shell} oControl An object representation of the control that should be rendered
 	 */
 	ShellRenderer.render = function(rm, oControl) {
 		var sTitleLevel = (oControl.getTitleLevel() === TitleLevel.Auto) ? TitleLevel.H1 : oControl.getTitleLevel();

package/src/sap/m/SimpleFixFlex.js

@@ -31,7 +31,7 @@ function (Control, ResizeHandler, Log /**, SimpleFixFlexRenderer */) {
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.96.5
+	 * @version 1.99.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/m/SimpleFixFlexRenderer.js

@@ -19,7 +19,7 @@ sap.ui.define([],
 		 * 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} oControl an object representation of the control that should be rendered
+		 * @param {sap.m.SimpleFixFlex} oControl an object representation of the control that should be rendered
 		 */
 		SimpleFixFlexRenderer.render = function (oRm, oControl) {
 			var oFixContent = oControl.getFixContent();

package/src/sap/m/SinglePlanningCalendar.js

@@ -19,6 +19,7 @@ sap.ui.define([
 	'sap/ui/core/ResizeHandler',
 	'sap/ui/core/format/DateFormat',
 	'sap/ui/unified/calendar/CalendarDate',
+	'sap/ui/unified/calendar/CalendarUtils',
 	'sap/ui/unified/DateRange',
 	'sap/ui/unified/DateTypeRange',
 	'sap/ui/unified/library',
@@ -39,6 +40,7 @@ function(
 	ResizeHandler,
 	DateFormat,
 	CalendarDate,
+	CalendarUtils,
 	DateRange,
 	DateTypeRange,
 	unifiedLibrary,
@@ -102,7 +104,7 @@ function(
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.96.5
+	 * @version 1.99.0
 	 *
 	 * @constructor
 	 * @public
@@ -163,6 +165,15 @@ function(
 			stickyMode: {type: "sap.m.PlanningCalendarStickyMode", group: "Behavior", defaultValue: PlanningCalendarStickyMode.None},
 
 			/**
+			 * Determines scale factor for the appointments.
+			 *
+			 * Acceptable range is from 1 to 6.
+			 * @since 1.99
+			 */
+			scaleFactor: {type: "float", group: "Data", defaultValue: 1},
+
+
+			 /**
 			 * Determines whether the appointments in the grid are draggable.
 			 *
 			 * The drag and drop interaction is visualized by a placeholder highlighting the area where the
@@ -192,7 +203,18 @@ function(
 			 *
 			 * @since 1.65
 			 */
-			enableAppointmentsCreate: { type: "boolean", group: "Misc", defaultValue: false }
+			enableAppointmentsCreate: { type: "boolean", group: "Misc", defaultValue: false },
+
+			/**
+			 * If set, the first day of the displayed week is this day. Valid values are 0 to 6 starting on Sunday.
+			 * If there is no valid value set, the default of the used locale is used.
+			 *
+			 * Note: This property will only have effect in Week view and Month view of the SinglePlanningCalendar,
+			 * but it wouldn't have effect in WorkWeek view.
+			 *
+			 * @since 1.98
+			 */
+			firstDayOfWeek : {type : "int", group : "Appearance", defaultValue : -1}
 		},
 
 		aggregations : {
@@ -547,6 +569,16 @@ function(
 		return this.setProperty("title", sTitle);
 	};
 
+	SinglePlanningCalendar.prototype.setScaleFactor = function(iScaleFactor) {
+		if (iScaleFactor <  1 || iScaleFactor > 6) {
+			return;
+		}
+
+		this.setProperty("scaleFactor", parseInt(iScaleFactor));
+		this.getAggregation("_grid").setProperty("scaleFactor", parseInt(iScaleFactor));
+		return this;
+	};
+
 	SinglePlanningCalendar.prototype.setStartDate = function (oDate) {
 		this.setProperty("startDate", oDate);
 		this._alignColumns();
@@ -905,6 +937,30 @@ function(
 		return this;
 	};
 
+	SinglePlanningCalendar.prototype.setFirstDayOfWeek = function (iFirstDayOfWeek) {
+		if (iFirstDayOfWeek < -1 || iFirstDayOfWeek > 6) {
+			Log.error("" + iFirstDayOfWeek + " is not a valid value to the property firstDayOfWeek. Valid values are from -1 to 6.");
+			return;
+		}
+		this.setProperty("firstDayOfWeek", iFirstDayOfWeek);
+		this.getViews().forEach(function (oView) {
+			oView.setFirstDayOfWeek(iFirstDayOfWeek);
+		});
+
+		var oHeader = this._getHeader(),
+			oPicker = oHeader.getAggregation("_calendarPicker") ? oHeader.getAggregation("_calendarPicker") : oHeader._oPopup.getContent()[0],
+			oSelectedView = this._getSelectedView(),
+			oStartDate = this.getStartDate() || new Date(),
+			oSPCStart = oSelectedView.calculateStartDate(new Date(oStartDate.getTime())),
+			oMonthGrid = this.getAggregation("_mvgrid");
+
+		this.setStartDate(oSPCStart);
+		oMonthGrid.setFirstDayOfWeek(iFirstDayOfWeek);
+		oPicker.setFirstDayOfWeek(iFirstDayOfWeek);
+
+		return this;
+	};
+
 	/**
 	 * Switches the visibility of the SegmentedButton in the _header and aligns the columns in the grid after an
 	 * operation (add, insert, remove, removeAll, destroy) with the views is performed.
@@ -1207,7 +1263,7 @@ function(
 	/**
 	 * Sets given view in the selectedView association and then prepares the calendar
 	 * for the new view.
-	 * @param {Object | String} vView The new view
+	 * @param {Object | string} vView The new view
 	 * @private
 	 */
 	SinglePlanningCalendar.prototype._setupNewView = function(vView) {

package/src/sap/m/SinglePlanningCalendarDayView.js

@@ -25,7 +25,7 @@ function (library, SinglePlanningCalendarView) {
 	 * @extends sap.m.SinglePlanningCalendarView
 	 *
 	 * @author SAP SE
-	 * @version 1.96.5
+	 * @version 1.99.0
 	 *
 	 * @constructor
 	 * @public