@openui5/sap.m 1.130.1 → 1.131.0

package/src/sap/m/RadioButtonGroup.js

@@ -68,7 +68,7 @@ sap.ui.define([
 			 * @borrows sap.ui.core.ISemanticFormContent.getFormRenderAsControl as #getFormRenderAsControl
 			 *
 			 * @author SAP SE
-			 * @version 1.130.1
+			 * @version 1.131.0
 			 *
 			 * @constructor
 			 * @public

package/src/sap/m/RangeSlider.js

@@ -53,7 +53,7 @@ sap.ui.define([
          * @extends sap.m.Slider
          *
          * @author SAP SE
-         * @version 1.130.1
+         * @version 1.131.0
          *
          * @constructor
          * @public

package/src/sap/m/RatingIndicator.js

@@ -56,7 +56,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/ResponsivePopover.js

@@ -63,7 +63,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/ResponsiveScale.js

@@ -34,7 +34,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/ScrollBar.js

@@ -25,7 +25,7 @@ function(Control, ScrollBarRenderer) {
 	 * care of only rendering the currently visible rows and use this <code>ScrollBar</code> control to make
 	 * the users think they are actually scrolling through a long list.
 	 * @extends sap.ui.core.Control
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @private
 	 * @alias sap.m.ScrollBar

package/src/sap/m/ScrollContainer.js

@@ -39,7 +39,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/SearchField.js

@@ -67,7 +67,7 @@ sap.ui.define([
 	* @extends sap.ui.core.Control
 	* @implements sap.ui.core.IFormContent
 	* @author SAP SE
-	* @version 1.130.1
+	* @version 1.131.0
 	*
 	* @constructor
 	* @public

package/src/sap/m/SegmentedButton.js

@@ -59,7 +59,7 @@ function(
 	 * @implements sap.ui.core.IFormContent
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/SegmentedButtonItem.js

@@ -23,7 +23,7 @@ sap.ui.define(['./library', 'sap/ui/core/Item', 'sap/m/Button', 'sap/ui/core/Cus
 		 * @extends sap.ui.core.Item
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/Select.js

@@ -116,7 +116,7 @@ function(
 		 * @borrows sap.ui.core.ILabelable.hasLabelableHTMLElement as #hasLabelableHTMLElement
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/SelectDialog.js

@@ -128,7 +128,7 @@ function(
 	 * @extends sap.m.SelectDialogBase
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/SelectDialogBase.js

@@ -34,7 +34,7 @@ function(
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/SelectList.js

@@ -34,7 +34,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/SelectionDetails.js

@@ -43,7 +43,7 @@ function(
 	 * <b><i>Note:</i></b>It is protected and should only be used within the framework itself.
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.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.130.1
+ * @version 1.131.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.130.1
+ * @version 1.131.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.130.1
+	 * @version 1.131.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.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @protected

package/src/sap/m/Shell.js

@@ -38,7 +38,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.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public

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.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/m/SinglePlanningCalendar.js

@@ -111,7 +111,7 @@ function(
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/SinglePlanningCalendarDayView.js

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

package/src/sap/m/SinglePlanningCalendarGrid.js

@@ -115,7 +115,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @private
@@ -1744,10 +1744,8 @@ sap.ui.define([
 			var $nowMarker = this.$("nowMarker"),
 				$nowMarkerText = this.$("nowMarkerText"),
 				$nowMarkerAMPM = this.$("nowMarkerAMPM"),
-				bCurrentHourNotVisible = !this._isVisibleHour(oDate.getHours()),
 				oMarkerDate = UI5Date.getInstance(oDate.getTime());
 
-			$nowMarker.toggleClass("sapMSinglePCNowMarkerHidden", bCurrentHourNotVisible);
 			$nowMarker.css("top", this._calculateTopPosition(oMarkerDate) + "rem");
 			$nowMarkerText.text(this._formatTimeAsString(oDate));
 			$nowMarkerAMPM.text(this._addAMPM(oDate));

package/src/sap/m/SinglePlanningCalendarGridRenderer.js

@@ -746,10 +746,6 @@ sap.ui.define([
 			oRm.style("top", oControl._calculateTopPosition(oDate) + "rem");
 			oRm.class("sapMSinglePCNowMarker");
 
-			if (!oControl._isVisibleHour(oDate.getHours())) {
-				oRm.class("sapMSinglePCNowMarkerHidden");
-			}
-
 			oRm.openEnd();
 			oRm.openStart("span", oControl.getId() + "-nowMarkerText");
 			oRm.class("sapMSinglePCNowMarkerText");

package/src/sap/m/SinglePlanningCalendarMonthGrid.js

@@ -95,7 +95,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @private
@@ -612,19 +612,19 @@ sap.ui.define([
 			}
 
 			if (oEvent.target.classList.contains("sapMSPCMonthDay")) {
-				const parentContainer = oEvent.target.parentElement;
-				const aAppointments = parentContainer.querySelectorAll(".sapUiCalendarRowApps");
+				const oAppointmentsList = oEvent.target.parentElement;
+				const aAppointments = oAppointmentsList.querySelectorAll(".sapUiCalendarRowApps");
 				if (aAppointments.length) {
 					oEvent.preventDefault();
 					aAppointments[0].focus();
 				}
 			} else if (oEvent.shiftKey && oEvent.target.classList.contains("sapMLnk")) {
-				const parentContainer = oEvent.target.parentElement.parentElement.parentElement;
-				const aLinks = parentContainer.querySelectorAll(".sapMSPCMonthLnkMore");
+				const oAppointmentsList = oEvent.target.parentElement.parentElement.parentElement;
+				const aLinks = oAppointmentsList.querySelectorAll(".sapMSPCMonthLnkMore");
 				const oFirstLink = aLinks[0].querySelector(".sapMLnk");
 
 				if (oFirstLink.id === oEvent.target.id) {
-					const aAppointments = parentContainer.querySelectorAll(".sapUiCalendarRowApps");
+					const aAppointments = oAppointmentsList.querySelectorAll(".sapUiCalendarRowApps");
 					if (aAppointments.length) {
 						const oLastApp = aAppointments[aAppointments.length - 1];
 						oEvent.preventDefault();
@@ -632,12 +632,13 @@ sap.ui.define([
 					}
 				}
 			} else if (!oEvent.shiftKey && oEvent.target.classList.contains("sapUiCalendarRowApps")) {
-				const parentContainer = oEvent.target.parentElement;
-				const aAppointments = parentContainer.children;
+				const oAppointmentsList = oEvent.target.parentElement;
+				const aAppointments = oAppointmentsList.children;
 				if (aAppointments.length) {
 					const oLastApp = aAppointments[aAppointments.length - 1];
 					if (oLastApp.id === oEvent.target.id) {
-						const oMoreLink = parentContainer.parentElement.querySelector(".sapMSPCMonthLnkMore > .sapMLnk");
+						const oRow = oAppointmentsList.parentElement.parentElement;
+						const oMoreLink = oRow.querySelector(".sapMSPCMonthLnkMore > .sapMLnk");
 						if (oMoreLink) {
 							oEvent.preventDefault();
 							oMoreLink.focus();

package/src/sap/m/SinglePlanningCalendarMonthView.js

@@ -28,7 +28,7 @@ sap.ui.define([
 		 * @extends sap.m.SinglePlanningCalendarView
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/SinglePlanningCalendarView.js

@@ -26,7 +26,7 @@ function (library, Log, Element) {
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/SinglePlanningCalendarWeekView.js

@@ -31,7 +31,7 @@ function (library, SinglePlanningCalendarView, Formatting, LocaleData, CalendarD
 	 * @extends sap.m.SinglePlanningCalendarView
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/SinglePlanningCalendarWorkWeekView.js

@@ -30,7 +30,7 @@ function(library, SinglePlanningCalendarView, Formatting, Locale, CalendarDate,
 	 * @extends sap.m.SinglePlanningCalendarView
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/SlideTile.js

@@ -51,7 +51,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @since 1.34
 	 *
 	 * @public

package/src/sap/m/Slider.js

@@ -104,7 +104,7 @@ function(
 		 * @borrows sap.ui.core.ISemanticFormContent.getFormRenderAsControl as #getFormRenderAsControl
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/SliderTooltip.js

@@ -42,7 +42,7 @@ function(
 		 * @extends sap.m.SliderTooltipBase
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @private

package/src/sap/m/SliderTooltipBase.js

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

package/src/sap/m/SliderTooltipContainer.js

@@ -39,7 +39,7 @@ function(
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @private

package/src/sap/m/SplitApp.js

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

package/src/sap/m/SplitButton.js

@@ -48,7 +48,7 @@ function(
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @private

package/src/sap/m/SplitContainer.js

@@ -88,7 +88,7 @@ function(
 	 *
 	 * @extends sap.ui.core.Control
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/StandardDynamicDateOption.js

@@ -52,7 +52,7 @@ sap.ui.define([
 		 * @extends sap.m.DynamicDateOption
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @private
 		 * @alias sap.m.StandardDynamicDateOption

package/src/sap/m/StandardListItem.js

@@ -39,7 +39,7 @@ sap.ui.define([
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/StandardTile.js

@@ -35,7 +35,7 @@ sap.ui.define([
 	 * @extends sap.m.Tile
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/StandardTreeItem.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @extends sap.m.TreeItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/StepInput.js

@@ -121,7 +121,7 @@ function(
 		 * @implements sap.ui.core.IFormContent
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/SuggestionItem.js

@@ -22,7 +22,7 @@ sap.ui.define(['./library', 'sap/ui/core/Item', 'sap/ui/core/IconPool'],
 	 * @extends sap.ui.core.Item
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 * @since 1.34
 	 *
 	 * @constructor

package/src/sap/m/SuggestionsPopover.js

@@ -52,7 +52,7 @@ sap.ui.define([
 	 * @alias sap.m.SuggestionsPopover
 	 *
 	 * @author SAP SE
-	 * @version 1.130.1
+	 * @version 1.131.0
 	 */
 	var SuggestionsPopover = EventProvider.extend("sap.m.SuggestionsPopover", /** @lends sap.m.SuggestionsPopover.prototype */ {
 
@@ -221,9 +221,10 @@ sap.ui.define([
 	 *
 	 * @private
 	 * @param {sap.ui.core.Control} oParent The input control that instantiates this suggestions popover
+	 * @param {boolean} bTypeAhead Indicates whether the autocomplete is switch on or not.
 	 * @param {jQuery.Event} oEvent Arrow key event.
 	 */
-	SuggestionsPopover.prototype.handleListNavigation = function(oParent, oEvent) {
+	SuggestionsPopover.prototype.handleListNavigation = function(oParent, oEvent, bTypeAhead) {
 		var	oPopover = this.getPopover();
 
 		if (oEvent.isMarked()) {
@@ -248,12 +249,13 @@ sap.ui.define([
 			aSelectableItems = oList && oList.getItems().filter(function (oItem) {
 				return oItem.getVisible && oItem.getVisible();
 			}),
-			iSelectedItemIndex = aSelectableItems.indexOf(this.getFocusedListItem()),
 			oNewItem;
 
+		const iSelectedItemIndex = this.getSelectedListItemIndex();
+
 		switch (oEvent.type) {
 			case "sapdown":
-				oNewItem = this.handleArrowDown(aSelectableItems, iSelectedItemIndex, bFocusInInput, bHasValueStateHeader);
+				oNewItem = this.handleArrowDown(aSelectableItems, iSelectedItemIndex, bFocusInInput, bHasValueStateHeader, bTypeAhead);
 				break;
 			case "sapup":
 				oNewItem = this.handleArrowUp(aSelectableItems, iSelectedItemIndex, bFocusInInput, bHasValueStateHeader);
@@ -293,14 +295,14 @@ sap.ui.define([
 	 *
 	 * @private
 	 */
-	SuggestionsPopover.prototype.handleArrowDown = function(aSelectableItems, iSelectedItemIndex, bFocusInInput, bHasValueStateHeader) {
+	SuggestionsPopover.prototype.handleArrowDown = function (aSelectableItems, iSelectedItemIndex, bFocusInInput, bHasValueStateHeader, bTypeAhead) {
 		// if the focus is on the input and there is no VSH available, return the first selectable item
-		if (bFocusInInput && !bHasValueStateHeader) {
+		if (bFocusInInput && !bHasValueStateHeader && !bTypeAhead) {
 			return aSelectableItems[0];
 		}
 
 		// if the focus is on the list, return the next item
-		if (!bFocusInInput && !this.getValueStateActiveState()) {
+		if (!bFocusInInput && !this.getValueStateActiveState() && !bTypeAhead) {
 			// if the focus is on the last item, it should remain there
 			if (iSelectedItemIndex === aSelectableItems.length - 1) {
 				return aSelectableItems[iSelectedItemIndex];
@@ -308,14 +310,29 @@ sap.ui.define([
 			return aSelectableItems[iSelectedItemIndex + 1];
 		}
 
+		if (bFocusInInput && bHasValueStateHeader && !bTypeAhead) {
+			this.setValueStateActiveState(true);
+			return undefined;
+		}
+
 		// if the focus is on the value state header, return the first selectable item
 		// otherwise focus on the value state header
-		if (this.getValueStateActiveState()) {
+		if (this.getValueStateActiveState() && !bTypeAhead) {
+			this.setValueStateActiveState(false);
+			return  aSelectableItems[0];
+		}
+
+		if (bHasValueStateHeader && this.getValueStateActiveState() && bTypeAhead) {
 			this.setValueStateActiveState(false);
 			return aSelectableItems[0];
-		} else {
-			this.setValueStateActiveState(true);
 		}
+
+		// if the focus is on the last item, it should remain there
+		if (iSelectedItemIndex === aSelectableItems.length - 1 && bTypeAhead) {
+			return aSelectableItems[iSelectedItemIndex];
+		}
+		// if the focus is on the list, return the next item
+		return aSelectableItems[iSelectedItemIndex + 1];
 	};
 
 	/**
@@ -323,7 +340,7 @@ sap.ui.define([
 	 *
 	 * @private
 	 */
-	SuggestionsPopover.prototype.handleArrowUp = function(aSelectableItems, iSelectedItemIndex, bFocusInInput, bHasValueStateHeader) {
+	SuggestionsPopover.prototype.handleArrowUp = function (aSelectableItems, iSelectedItemIndex, bFocusInInput, bHasValueStateHeader) {
 		// if the focus is on the input field, do nothing
 		if (bFocusInInput) {
 			return;
@@ -549,6 +566,23 @@ sap.ui.define([
 		}
 	};
 
+	/**
+	 * Gets the index of currently selected list item, if any, or the currently focused group header item
+	 *
+	 * @private
+	 */
+	SuggestionsPopover.prototype.getSelectedListItemIndex = function () {
+		const oList = this.getItemsContainer();
+		const aListItems = oList && oList.getItems() || [];
+		const aVisibleItems = aListItems.filter((item) => item.getVisible && item.getVisible());
+
+		if (aListItems.filter((item) => item.getSelected()).length) {
+			return aVisibleItems.findIndex((item) => item.getSelected());
+		}
+
+		return aVisibleItems.findIndex((groupItem) => groupItem.hasStyleClass("sapMLIBFocused"));
+	};
+
 
 	/* =================== Value State Header =================== */
 

package/src/sap/m/Switch.js

@@ -52,7 +52,7 @@ function(
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/TabContainer.js

@@ -69,7 +69,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/TabContainerItem.js

@@ -23,7 +23,7 @@ sap.ui.define(['sap/ui/core/Element',
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.130.1
+		 * @version 1.131.0
 		 *
 		 * @constructor
 		 * @public