@openui5/sap.m 1.107.0 → 1.108.0

package/src/sap/m/CarouselLayout.js

@@ -15,7 +15,7 @@ sap.ui.define(["sap/ui/base/ManagedObject"], function (ManagedObject) {
 	 * Applies a <code>sap.m.CarouselLayout</code> to a provided DOM element or Control.
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 *

package/src/sap/m/CarouselRenderer.js

@@ -42,9 +42,10 @@ sap.ui.define([
 			iPageCount = aPages.length,
 			sPageIndicatorPlacement = oCarousel.getPageIndicatorPlacement(),
 			sArrowsPlacement = oCarousel.getArrowsPlacement(),
-			iIndex = oCarousel._getPageNumber(oCarousel.getActivePage());
+			iIndex = oCarousel._getPageIndex(oCarousel.getActivePage());
 
 		this._renderOpeningDiv(oRM, oCarousel);
+		this._renderDummyArea(oRM, oCarousel, "before");
 
 		//visual indicator
 		if (sPageIndicatorPlacement === PlacementType.Top) {
@@ -74,6 +75,7 @@ sap.ui.define([
 			});
 		}
 
+		this._renderDummyArea(oRM, oCarousel, "after");
 		oRM.close("div");
 		//page-wrap ends
 	};
@@ -88,7 +90,6 @@ sap.ui.define([
 			.style("width", oCarousel.getWidth())
 			.style("height", oCarousel.getHeight())
 			.attr("data-sap-ui-customfastnavgroup", true) // custom F6 handling
-			.attr("tabindex", 0)
 			.accessibilityState(oCarousel, {
 				role: "listbox"
 			});
@@ -126,32 +127,55 @@ sap.ui.define([
 
 		oRM.openEnd();
 
-		var fnRenderPage = function (oPage, iIndex, aArray) {
-			//item div
-			oRM.openStart("div", oCarousel.getId() + "-" + oPage.getId() + "-slide")
-				.class("sapMCrslItem")
-				.accessibilityState(oPage, {
-					role: "option",
-					posinset: iIndex + 1,
-					setsize: aArray.length,
-					selected: oCarousel.getActivePage() === oPage.getId() ? true : false
-				}).openEnd();
-
-			CarouselRenderer._renderPageInScrollContainer(oRM, oCarousel, oPage);
-
-			oRM.close("div");
-		};
-
 		// Render Pages
 		if (aPages.length) {
-			aPages.forEach(fnRenderPage);
+			aPages.forEach(function (oPage, iIndex, aArray) {
+				CarouselRenderer._renderPage(oRM, oPage, oCarousel, iIndex, aArray);
+			});
 		} else {
-			oRM.renderControl(oCarousel._getEmptyPage());
+			CarouselRenderer._renderNoData(oRM, oCarousel);
 		}
 
 		oRM.close("div");
 	};
 
+	CarouselRenderer._renderPage = function (oRM, oPage, oCarousel, iIndex, aArray) {
+		var bSelected = oCarousel.getActivePage() === oPage.getId();
+
+		oRM.openStart("div", oCarousel.getId() + "-" + oPage.getId() + "-slide")
+			.class("sapMCrslItem")
+			.accessibilityState(oPage, {
+				role: "option",
+				posinset: iIndex + 1,
+				setsize: aArray.length,
+				selected: bSelected,
+				hidden: !oCarousel._isPageDisplayed(iIndex)
+			})
+			.attr("tabindex", bSelected ? 0 : -1)
+			.openEnd();
+
+		CarouselRenderer._renderPageInScrollContainer(oRM, oCarousel, oPage);
+
+		oRM.close("div");
+	};
+
+	CarouselRenderer._renderNoData = function (oRM, oCarousel) {
+		var oEmptyPage = oCarousel._getEmptyPage();
+		var oAccInfo = oEmptyPage.getAccessibilityInfo();
+
+		oRM.openStart("div", oCarousel.getId() + "-noData")
+			.attr("tabindex", 0)
+			.class("sapMCrslNoDataItem")
+			.accessibilityState({
+				label: oAccInfo.type + " " + oAccInfo.description
+			})
+			.openEnd();
+
+		oRM.renderControl(oCarousel._getEmptyPage());
+
+		oRM.close("div");
+	};
+
 	/**
 	 * Renders the page indicator, using the provided {@link sap.ui.core.RenderManager}.
 	 * Page indicator is only rendered if there is more than one carousel page
@@ -349,5 +373,13 @@ sap.ui.define([
 		// end wrapping in scroll container
 	};
 
+	CarouselRenderer._renderDummyArea = function(oRM, oControl, sAreaId) {
+		oRM.openStart("div", oControl.getId() + "-" + sAreaId)
+			.class("sapMCrslDummyArea")
+			.attr("tabindex", 0)
+			.openEnd()
+			.close("div");
+	};
+
 	return CarouselRenderer;
 }, /* bExport= */ true);

package/src/sap/m/CheckBox.js

@@ -86,7 +86,7 @@ sap.ui.define([
 	 * @implements sap.ui.core.IFormContent, sap.ui.core.ISemanticFormContent, sap.ui.core.IAccessKeySupport
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/ColorPalette.js

@@ -104,7 +104,7 @@ sap.ui.define([
 		 * To prevent this, apps using the <code>ColorPalette</code> should also load the <code>sap.ui.unified</code> library in advance.
 		 *
 		 * @extends sap.ui.core.Control
-		 * @version 1.107.0
+		 * @version 1.108.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/ColorPalettePopover.js

@@ -37,7 +37,7 @@ sap.ui.define([
 		 * A thin wrapper over {@link sap.m.ColorPalette} allowing the latter to be used in a popover.
 		 *
 		 * @extends sap.ui.core.Control
-		 * @version 1.107.0
+		 * @version 1.108.0
 		 *
 		 * @public
 		 * @since 1.54

package/src/sap/m/Column.js

@@ -11,9 +11,10 @@ sap.ui.define([
 	'sap/ui/core/Renderer',
 	'sap/ui/core/library',
 	'sap/ui/Device',
-	"sap/ui/thirdparty/jquery"
+	"sap/ui/thirdparty/jquery",
+	"sap/ui/core/InvisibleText"
 ],
-	function(library, Element, Renderer, coreLibrary, Device, jQuery) {
+	function(library, Element, Renderer, coreLibrary, Device, jQuery, InvisibleText) {
 	"use strict";
 
 
@@ -46,7 +47,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @public
@@ -723,16 +724,43 @@ sap.ui.define([
 	};
 
 	/**
-	 * Returns the <code>sap.ui.core.IColumnHeaderMenu<\code>, which is the current target of the association <code>headerMenu</code>, or null.
+	 * Returns the column header menu instance that this column is associated with via the <code>headerMenu</code> association.
 	 *
-	 * @returns {sap.ui.core.IColumnHeaderMenu}
-	 * @since 1.98.0
-	 * @public
+	 * @returns {sap.ui.core.IColumnHeaderMenu | undefined} The column header menu instance
+	 * @private
 	 */
-	Column.prototype.getColumnHeaderMenu = function () {
+	Column.prototype._getHeaderMenuInstance = function () {
 		return sap.ui.getCore().byId(this.getAssociation("headerMenu"));
 	};
 
+	Column.prototype.setHeader = function (oControl) {
+		var oOldHeader = this.getHeader();
+		if (oOldHeader && oOldHeader.isA("sap.m.Label")) {
+			oOldHeader.detachEvent("_change", this._onLabelPropertyChange, this);
+			oOldHeader.setIsInColumnHeaderContext(false);
+		}
+
+		this.setAggregation("header", oControl);
+
+		var oNewHeader = this.getHeader();
+		if (oNewHeader && oNewHeader.isA("sap.m.Label")) {
+			oNewHeader.attachEvent("_change", this._onLabelPropertyChange, this);
+			oNewHeader.setIsInColumnHeaderContext(true);
+		}
+
+		return this;
+	};
+
+	Column.prototype._onLabelPropertyChange = function (oEvent) {
+		if (oEvent.getParameter("name") != "required") {
+			return;
+		}
+
+		if (this.getTable().bActiveHeaders || this._getHeaderMenuInstance()) {
+			this.$("ah")[oEvent.getSource().getRequired() ? "addAriaDescribedBy" : "removeAriaDescribedBy"](InvisibleText.getStaticId("sap.m", "CONTROL_IN_COLUMN_REQUIRED"));
+		}
+	};
+
 	return Column;
 
 });

package/src/sap/m/ColumnHeaderPopover.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @since 1.63

package/src/sap/m/ColumnListItem.js

@@ -42,7 +42,7 @@ sap.ui.define([
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/ColumnPopoverActionItem.js

@@ -16,7 +16,7 @@ sap.ui.define(['./ColumnPopoverItem', 'sap/m/Button'], function(ColumnPopoverIte
 	 * @extends sap.m.ColumnPopoverItem
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @since 1.63

package/src/sap/m/ColumnPopoverCustomItem.js

@@ -17,7 +17,7 @@ sap.ui.define(['./ColumnPopoverItem', 'sap/m/ToggleButton'], function(ColumnPopo
 	 * @extends sap.m.ColumnPopoverItem
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @since 1.63

package/src/sap/m/ColumnPopoverItem.js

@@ -16,7 +16,7 @@ sap.ui.define(['sap/ui/core/Element'], function(Element) {
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @since 1.63

package/src/sap/m/ColumnPopoverSelectListItem.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @extends sap.m.ColumnPopoverItem
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @since 1.86

package/src/sap/m/ColumnPopoverSortItem.js

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @extends sap.m.ColumnPopoverItem
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @since 1.66

package/src/sap/m/ComboBox.js

@@ -106,7 +106,7 @@ sap.ui.define([
 		 * </ul>
 		 *
 		 * @author SAP SE
-		 * @version 1.107.0
+		 * @version 1.108.0
 		 *
 		 * @constructor
 		 * @extends sap.m.ComboBoxBase

package/src/sap/m/ComboBoxBase.js

@@ -66,7 +66,7 @@ sap.ui.define([
 		 * @abstract
 		 *
 		 * @author SAP SE
-		 * @version 1.107.0
+		 * @version 1.108.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/ComboBoxTextField.js

@@ -29,7 +29,7 @@ sap.ui.define([
 		 * @extends sap.m.InputBase
 		 *
 		 * @author SAP SE
-		 * @version 1.107.0
+		 * @version 1.108.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/CustomDynamicDateOption.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/m/DynamicDateOption'],
 		 * @extends sap.m.DynamicDateOption
 		 *
 		 * @author SAP SE
-		 * @version 1.107.0
+		 * @version 1.108.0
 		 *
 		 * @public
 		 * @since 1.92

package/src/sap/m/CustomListItem.js

@@ -24,7 +24,7 @@ sap.ui.define(['./ListItemBase', './library', './CustomListItemRenderer'],
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/CustomTile.js

@@ -21,7 +21,7 @@ sap.ui.define(['./Tile', './library', './CustomTileRenderer'],
 	 * Use the CustomTile control to display application specific content in the Tile control.
 	 * The tile width is 8.5em and height is 10em.
 	 * @extends sap.m.Tile
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/CustomTreeItem.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 *        <code>Table, Form</code> etc, should not be aggregated as content.
 	 * @extends sap.m.TreeItemBase
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 * @constructor
 	 * @public
 	 * @since 1.48.0

package/src/sap/m/DatePicker.js

@@ -34,6 +34,7 @@ sap.ui.define([
 	"sap/ui/core/LabelEnablement",
 	"sap/ui/unified/library",
 	"sap/ui/core/Configuration",
+	"sap/ui/core/date/CalendarWeekNumbering",
 	"sap/ui/dom/jquery/cursorPos"
 ],
 	function(
@@ -63,7 +64,8 @@ sap.ui.define([
 		CustomYearPicker,
 		LabelEnablement,
 		unifiedLibrary,
-		Configuration
+		Configuration,
+		CalendarWeekNumbering
 	) {
 	"use strict";
 
@@ -152,7 +154,7 @@ sap.ui.define([
 	 * the close event), or select Cancel.
 	 *
 	 * @extends sap.m.DateTimeField
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @public
@@ -230,7 +232,14 @@ sap.ui.define([
 				 *
 				 * @since 1.97
 				 */
-				 hideInput: { type: "boolean", group: "Misc", defaultValue: false }
+				 hideInput: { type: "boolean", group: "Misc", defaultValue: false },
+
+				 /**
+				 * If set, the calendar week numbering is used for display.
+				 * If not set, the calendar week numbering of the global configuration is used.
+				 * @since 1.108.0
+				 */
+				calendarWeekNumbering : { type : "sap.ui.core.date.CalendarWeekNumbering", group : "Appearance", defaultValue: null}
 
 			},
 
@@ -367,7 +376,8 @@ sap.ui.define([
 			id: this.getId() + "-icon",
 			src: this.getIconSrc(),
 			noTabStop: true,
-			tooltip: oResourceBundle.getText("OPEN_PICKER_TEXT")
+			decorative: false,
+			useIconTooltip: false
 		});
 
 		// idicates whether the picker is still open
@@ -1243,12 +1253,12 @@ sap.ui.define([
 		var CalendarConstructor = this._getCalendarConstructor();
 
 		if (!this._getCalendar()) {
-
 			this._oCalendar = new CalendarConstructor(this.getId() + "-cal", {
 				intervalSelection: this._bIntervalSelection,
 				minDate: this.getMinDate(),
 				maxDate: this.getMaxDate(),
 				legend: this.getLegend(),
+				calendarWeekNumbering: this.getCalendarWeekNumbering(),
 				startDateChange: function () {
 						this.fireNavigate({
 							dateRange: this._getVisibleDatesRange(this._getCalendar())
@@ -1261,7 +1271,6 @@ sap.ui.define([
 			this._getCalendar().addSelectedDate(this._oDateRange);
 			this._getCalendar()._setSpecialDatesControlOrigin(this);
 			this._getCalendar().attachCancel(_cancel, this);
-
 			if (this.$().closest(".sapUiSizeCompact").length > 0) {
 				this._getCalendar().addStyleClass("sapUiSizeCompact");
 			}

package/src/sap/m/DateRangeSelection.js

@@ -130,8 +130,8 @@ sap.ui.define([
 	 * compact mode and provides a touch-friendly size in cozy mode.
 	 *
 	 * @extends sap.m.DatePicker
-	 * @version 1.107.0
-	 * @version 1.107.0
+	 * @version 1.108.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/DateTimeField.js

@@ -61,7 +61,7 @@ sap.ui.define([
 	 * @extends sap.m.InputBase
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/DateTimeInput.js

@@ -64,7 +64,7 @@ function(
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/DateTimePicker.js

@@ -143,7 +143,7 @@ sap.ui.define([
 	 * mobile devices, it opens in full screen.
 	 *
 	 * @extends sap.m.DatePicker
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @public
@@ -885,7 +885,7 @@ sap.ui.define([
 
 			if (Device.system.phone) {
 				sLabelId = this.$("inner").attr("aria-labelledby");
-				sLabel = sLabelId ? document.getElementById(sLabelId).getAttribute("aria-label") : "";
+				sLabel = sLabelId ? document.getElementById(sLabelId).textContent : "";
 				this._oPopup.setTitle(sLabel);
 				this._oPopup.setShowHeader(true);
 				this._oPopup.setShowCloseButton(true);

package/src/sap/m/Dialog.js

@@ -178,7 +178,7 @@ function(
 		*
 		* @implements sap.ui.core.PopupInterface
 		* @author SAP SE
-		* @version 1.107.0
+		* @version 1.108.0
 		*
 		* @constructor
 		* @public
@@ -533,6 +533,8 @@ function(
 			this._initTitlePropagationSupport();
 
 			this._initResponsivePaddingsEnablement();
+
+			this._oAriaDescribedbyText = new InvisibleText({id: this.getId() + "-ariaDescribedbyText"});
 		};
 
 		Dialog.prototype.onBeforeRendering = function () {
@@ -582,6 +584,8 @@ function(
 				oHeader._setRootAccessibilityRole("heading");
 				oHeader._setRootAriaLevel("2");
 			}
+
+			this._oAriaDescribedbyText.setText(this._getAriaDescribedByText());
 		};
 
 		Dialog.prototype.onAfterRendering = function () {
@@ -631,6 +635,11 @@ function(
 				this._toolbarSpacer.destroy();
 				this._toolbarSpacer = null;
 			}
+
+			if (this._oAriaDescribedbyText) {
+				this._oAriaDescribedbyText.destroy();
+				this._oAriaDescribedbyText = null;
+			}
 		};
 		/* =========================================================== */
 		/*                   end: Lifecycle functions                  */
@@ -1452,7 +1461,7 @@ function(
 				return null;
 			}
 
-			return this.$().find('header.sapMDialogTitle')[0];
+			return this.$().find('header.sapMDialogTitle .sapMDialogTitleGroup')[0];
 		};
 
 		/**
@@ -1749,6 +1758,24 @@ function(
 			return !this.getStretch() && (this.getDraggable() || this.getResizable());
 		};
 
+		/**
+		 * Returns the correct message to be read by the aria-describedby attribute
+		 * @private
+		 */
+		Dialog.prototype._getAriaDescribedByText = function () {
+			var oRb = Core.getLibraryResourceBundle("sap.m");
+			if (this.getResizable() && this.getDraggable()) {
+				return oRb.getText("DIALOG_HEADER_ARIA_DESCRIBEDBY_DRAGGABLE_RESIZABLE");
+			}
+			if (this.getDraggable()) {
+				return oRb.getText("DIALOG_HEADER_ARIA_DESCRIBEDBY_DRAGGABLE");
+			}
+			if (this.getResizable()) {
+				return oRb.getText("DIALOG_HEADER_ARIA_DESCRIBEDBY_RESIZABLE");
+			}
+			return "";
+		};
+
 		/* =========================================================== */
 		/*                      end: private functions                 */
 		/* =========================================================== */

package/src/sap/m/DialogRenderer.js

@@ -6,8 +6,9 @@
 sap.ui.define([
 	"sap/m/library",
 	"sap/ui/Device",
-	"sap/ui/core/library"
-], function (library, Device, coreLibrary) {
+	"sap/ui/core/library",
+	"sap/ui/core/Core"
+], function (library, Device, coreLibrary, Core) {
 	"use strict";
 
 	// shortcut for sap.m.DialogType
@@ -159,6 +160,7 @@ sap.ui.define([
 			// In that case, the controller will focus the last focusable element.
 			oRM.openStart("span", sId + "-firstfe")
 				.class("sapMDialogFirstFE")
+				.attr("role", "none")
 				.attr("tabindex", "0")
 				.openEnd()
 				.close("span");
@@ -167,15 +169,26 @@ sap.ui.define([
 		if (oHeader) {
 			oHeader._applyContextClassFor("header");
 			oRM.openStart("header")
-				.class("sapMDialogTitle");
+				.class("sapMDialogTitle")
+				.openEnd()
+				.openStart("div")
+				.class("sapMDialogTitleGroup");
 
 			if (oDialog._isDraggableOrResizable()) {
-				oRM.attr("tabindex", 0);
+				oRM.attr("tabindex", 0)
+					.accessibilityState(oHeader, {
+						role: "group",
+						roledescription: Core.getLibraryResourceBundle("sap.m").getText("DIALOG_HEADER_ARIA_ROLE_DESCRIPTION"),
+						describedby: { value: oDialog.getId() + "-ariaDescribedbyText", append: true }
+					});
 			}
 
 			oRM.openEnd()
-				.renderControl(oHeader)
-				.close("header");
+			.renderControl(oHeader)
+			.renderControl(oDialog._oAriaDescribedbyText)
+			.close("div")
+			.close("header");
+
 		}
 
 		if (oSubHeader && oSubHeader.getVisible()) {
@@ -229,6 +242,7 @@ sap.ui.define([
 			// In that case, the controller will focus the first focusable element.
 			oRM.openStart("span", sId + "-lastfe")
 				.class("sapMDialogLastFE")
+				.attr("role", "none")
 				.attr("tabindex", "0")
 				.openEnd()
 				.close("span");

package/src/sap/m/DisplayListItem.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/DraftIndicator.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @abstract
 	 *
 	 * @author SAP SE
-	 * @version 1.107.0
+	 * @version 1.108.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/DynamicDate.js

@@ -36,7 +36,7 @@ sap.ui.define([
 		 * @extends sap.ui.model.SimpleType
 		 *
 		 * @author SAP SE
-		 * @version 1.107.0
+		 * @version 1.108.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/DynamicDateOption.js

@@ -38,7 +38,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.107.0
+		 * @version 1.108.0
 		 *
 		 * @public
 		 * @since 1.92