@openui5/sap.f 1.124.2 → 1.126.0

package/.reuse/dep5

@@ -50,6 +50,11 @@ Copyright: Mario Heiderich
 License: Apache-2.0
 Comment: these files belong to: purify.js
 
+Files: src/sap.m/test/sap/m/qunit/_thirdparty/qunit-composite.css src/sap.m/test/sap/m/qunit/_thirdparty/qunit-composite.js
+Copyright: jQuery Foundation and other contributors, https://jquery.org/
+License: MIT
+Comment: these files belong to: QUnit Composite 2.0.0
+
 
 # Library: sap.ui.codeeditor:
 
@@ -379,13 +384,13 @@ Copyright: 2017 Wei Song and Oliver Nightingale
 License: MIT
 Comment: these files belong to: Elasticlunr
 
-Files: src/sap.ui.documentation/src/sap/ui/documentation/sdk/thirdparty/DataTables/DataTables-1.10.15/*
-Copyright: 2008-2017 SpryMedia Ltd
+Files: src/sap.ui.documentation/src/sap/ui/documentation/sdk/thirdparty/DataTables/DataTables-2.0.1/*
+Copyright: SpryMedia Ltd
 License: MIT
 Comment: these files belong to: DataTables
 
-Files: src/sap.ui.documentation/src/sap/ui/documentation/sdk/thirdparty/DataTables/Buttons-1.4.0/*
-Copyright: 2016 SpryMedia Ltd
+Files: src/sap.ui.documentation/src/sap/ui/documentation/sdk/thirdparty/DataTables/Buttons-3.0.0/*
+Copyright: SpryMedia Ltd
 License: MIT
 Comment: these files belong to: Buttons extension for DataTables
 

package/THIRDPARTY.txt

@@ -12,6 +12,13 @@ License: Apache-2.0
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/Apache-2.0.txt
 Contained in: src/sap.m/src/sap/m/_thirdparty/purify.js
 
+Component: QUnit Composite 2.0.0, version: 2.0.0
+Copyright: jQuery Foundation and other contributors, https://jquery.org/
+License: MIT
+License Text: https://github.com/SAP/openui5/blob/master/LICENSES/MIT.txt
+Contained in: src/sap.m/test/sap/m/qunit/_thirdparty/qunit-composite.css
+	src/sap.m/test/sap/m/qunit/_thirdparty/qunit-composite.js
+
 
 Library: sap.ui.codeeditor:
 
@@ -356,17 +363,17 @@ License: MIT
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/MIT.txt
 Contained in: src/sap.ui.documentation/src/sap/ui/documentation/sdk/thirdparty/elasticlunr.js
 
-Component: DataTables, version: 1.10.15
-Copyright: 2008-2017 SpryMedia Ltd
+Component: DataTables, version: 2.0.1
+Copyright: SpryMedia Ltd
 License: MIT
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/MIT.txt
-Contained in: src/sap.ui.documentation/src/sap/ui/documentation/sdk/thirdparty/DataTables/DataTables-1.10.15/*
+Contained in: src/sap.ui.documentation/src/sap/ui/documentation/sdk/thirdparty/DataTables/DataTables-2.0.1/*
 
-Component: Buttons extension for DataTables, version: 1.4.0
-Copyright: 2016 SpryMedia Ltd
+Component: Buttons extension for DataTables, version: 3.0.0
+Copyright: SpryMedia Ltd
 License: MIT
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/MIT.txt
-Contained in: src/sap.ui.documentation/src/sap/ui/documentation/sdk/thirdparty/DataTables/Buttons-1.4.0/*
+Contained in: src/sap.ui.documentation/src/sap/ui/documentation/sdk/thirdparty/DataTables/Buttons-3.0.0/*
 
 
 Library: sap.ui.integration:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openui5/sap.f",
-  "version": "1.124.2",
+  "version": "1.126.0",
   "description": "OpenUI5 UI Library sap.f",
   "author": "SAP SE (https://www.sap.com)",
   "license": "Apache-2.0",
@@ -14,8 +14,8 @@
     "url": "https://github.com/SAP/openui5.git"
   },
   "dependencies": {
-    "@openui5/sap.m": "1.124.2",
-    "@openui5/sap.ui.core": "1.124.2",
-    "@openui5/sap.ui.layout": "1.124.2"
+    "@openui5/sap.m": "1.126.0",
+    "@openui5/sap.ui.core": "1.126.0",
+    "@openui5/sap.ui.layout": "1.126.0"
   }
 }

package/src/sap/f/.library

@@ -6,7 +6,7 @@
   <copyright>OpenUI5
  * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.</copyright>
-  <version>1.124.2</version>
+  <version>1.126.0</version>
 
   <documentation>SAPUI5 library with Fiori controls.</documentation>
 

package/src/sap/f/Avatar.js

@@ -41,7 +41,7 @@ sap.ui.define([
 	 * @extends sap.m.Avatar
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/AvatarGroup.js

@@ -100,7 +100,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/AvatarGroupItem.js

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/AvatarGroupRenderer.js

@@ -5,8 +5,10 @@
  */
 
 // Provides default renderer for control sap.f.AvatarGroupRenderer
-sap.ui.define(["sap/m/AvatarSize"],
-	function (AvatarSize) {
+sap.ui.define([
+	"sap/m/AvatarSize",
+	"./library"],
+	function (AvatarSize, library) {
 		"use strict";
 
 		/**
@@ -33,7 +35,8 @@ sap.ui.define(["sap/m/AvatarSize"],
 				sAvatarGroupTypeClass = sAvatarGroupClass + sGroupType,
 				aItems = oAvatarGroup.getItems(),
 				bShowMoreButton = oAvatarGroup._shouldShowMoreButton(),
-				bInteractive = oAvatarGroup.getProperty("_interactive");
+				bInteractive = oAvatarGroup.getProperty("_interactive"),
+				sTooltip = oAvatarGroup.getTooltip_AsString();
 
 			oRm.openStart("div", oAvatarGroup)
 				.class(sAvatarGroupClass)
@@ -52,7 +55,7 @@ sap.ui.define(["sap/m/AvatarSize"],
 				oRm.style("width", "auto");
 			}
 
-			if (sGroupType === "Group") {
+			if (sGroupType === library.AvatarGroupType.Group) {
 				oRm.attr("role", "button");
 			}
 
@@ -63,6 +66,10 @@ sap.ui.define(["sap/m/AvatarSize"],
 				oRm.style("line-height", sAvatarCustomDisplaySize);
 			}
 
+			if (sTooltip && sGroupType === library.AvatarGroupType.Group) {
+				oRm.attr("title", sTooltip);
+			}
+
 			oRm.openEnd();
 
 			for (var i = 0; i < oAvatarGroup._iAvatarsToShow; i++) {

package/src/sap/f/CalendarAppointmentInCard.js

@@ -21,7 +21,7 @@ sap.ui.define([
 	 * This calendar appointment is used in card content of type Calendar.
 	 *
 	 * @extends sap.ui.unified.CalendarAppointment
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/CalendarInCard.js

@@ -45,7 +45,7 @@ sap.ui.define([
 	 * <code>sap.m.Toolbar</code> with <code>sap.m.Buttons</code>.
 	 *
 	 * @extends sap.ui.unified.Calendar
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/Card.js

@@ -71,7 +71,7 @@ sap.ui.define([
 	 * @extends sap.f.CardBase
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/CardBase.js

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public
@@ -244,13 +244,20 @@ sap.ui.define([
 	 */
 	CardBase.prototype._getAriaLabelledIds = function () {
 		var oHeader = this.getCardHeader();
+		const sBlockingMessageAriaLabelsIds = this._getBlockingMessageAriaLabelledByIds();
 
 		if (oHeader) {
 			if (this._isInsideGridContainer()) {
+				if (sBlockingMessageAriaLabelsIds) {
+					return oHeader._getAriaLabelledBy() + " " + sBlockingMessageAriaLabelsIds;
+				}
 				return oHeader._getAriaLabelledBy();
 			}
 
 			if (oHeader._getTitle && oHeader._getTitle()) {
+				if (sBlockingMessageAriaLabelsIds) {
+					return oHeader._getTitle().getId() + " " + sBlockingMessageAriaLabelsIds;
+				}
 				return oHeader._getTitle().getId();
 			}
 		}
@@ -258,6 +265,26 @@ sap.ui.define([
 		return this._ariaText.getId();
 	};
 
+	/**
+	 * Gets the ids of the elements in the illustrated message that have to be labelled.
+	 *
+	 * @return {string} sAriaLabelledBy ids of elements that have to be labelled
+	 * @private
+	 */
+	CardBase.prototype._getBlockingMessageAriaLabelledByIds = function () {
+		if (!this.getCardContent()?.getAggregation("_blockingMessage")) {
+			return "";
+		}
+		const oIllustration = this.getCardContent().getAggregation("_blockingMessage")._getIllustratedMessage();
+		const sTitleId = oIllustration._getTitle().sId;
+		const sDescriptionId = oIllustration._getDescription()?.sId;
+
+		if (oIllustration._getDescription().getText()) {
+			return sTitleId + " " + sDescriptionId;
+		}
+		return sTitleId;
+	};
+
 	/**
 	 * Returns if the control is inside a sap.f.GridContainer
 	 *

package/src/sap/f/DynamicPage.js

@@ -118,7 +118,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public
@@ -514,7 +514,7 @@ sap.ui.define([
 	};
 
 	DynamicPage.prototype.setShowFooter = function (bShowFooter) {
-		var vResult = this.setProperty("showFooter", bShowFooter);
+		var vResult = this.setProperty("showFooter", bShowFooter, /* bSuppressInvalidate */ true);
 
 		this._toggleFooter(bShowFooter);
 

package/src/sap/f/DynamicPageAccessibleLandmarkInfo.js

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

package/src/sap/f/DynamicPageHeader.js

@@ -64,7 +64,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.124.2
+		 * @version 1.126.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/f/DynamicPageTitle.js

@@ -95,7 +95,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/FlexibleColumnLayout.js

@@ -108,7 +108,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Control
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/FlexibleColumnLayoutAccessibleLandmarkInfo.js

@@ -22,7 +22,7 @@ sap.ui.define(['sap/ui/core/Element', './library'],
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 * @since 1.95
 	 *
 	 * @constructor

package/src/sap/f/FlexibleColumnLayoutSemanticHelper.js

@@ -49,7 +49,7 @@ sap.ui.define([
 	 *
 	 * For more information, see {@link sap.f.FlexibleColumnLayoutSemanticHelper#getCurrentUIState} and {@link sap.f.FlexibleColumnLayoutSemanticHelper#getNextUIState}
 	 *
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 * @param {sap.f.FlexibleColumnLayout} oFlexibleColumnLayout
 	 * The <code>sap.f.FlexibleColumnLayout</code> object whose state will be manipulated.
 	 *

package/src/sap/f/GridContainer.js

@@ -177,7 +177,7 @@ sap.ui.define([
 	 * @see {@link sap.f.dnd.GridDropInfo}
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @extends sap.ui.core.Control
 	 *

package/src/sap/f/GridContainerItemLayoutData.js

@@ -21,7 +21,7 @@ sap.ui.define(['sap/ui/core/LayoutData'],
 		 * @see {@link topic:32d4b9c2b981425dbc374d3e9d5d0c2e Grid Controls}
 		 *
 		 * @author SAP SE
-		 * @version 1.124.2
+		 * @version 1.126.0
 		 *
 		 * @extends sap.ui.core.LayoutData
 		 *

package/src/sap/f/GridContainerSettings.js

@@ -58,14 +58,14 @@ sap.ui.define([
 	 * Can be used to define the sizes of columns and rows for different screen sizes, by using the <code>layout</code> aggregations of <code>sap.f.GridContainer</code>.
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @see {@link topic:32d4b9c2b981425dbc374d3e9d5d0c2e Grid Controls}
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @since 1.65
 	 * @public

package/src/sap/f/GridList.js

@@ -93,7 +93,7 @@ sap.ui.define([
 	 * @see {@link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Grid_Layout MDN web docs: CSS Grid Layout}
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @extends sap.m.ListBase
 	 * @implements sap.ui.layout.cssgrid.IGridConfigurable

package/src/sap/f/GridListItem.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @since 1.70
 	 * @constructor

package/src/sap/f/IllustratedMessage.js

@@ -56,7 +56,7 @@ sap.ui.define([
 	 * @extends sap.m.IllustratedMessage
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/Illustration.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @extends sap.m.Illustration
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/PlanningCalendarInCardLegend.js

@@ -22,7 +22,7 @@ sap.ui.define(['sap/m/PlanningCalendarLegend', "sap/ui/core/Lib", 'sap/ui/unifie
 		 * @extends sap.m.PlanningCalendarLegend
 		 *
 		 * @author SAP SE
-		 * @version 1.124.2
+		 * @version 1.126.0
 		 *
 		 * @constructor
 		 * @private

package/src/sap/f/ProductSwitch.js

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

package/src/sap/f/ProductSwitchItem.js

@@ -40,7 +40,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.124.2
+		 * @version 1.126.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/f/SearchManager.js

@@ -23,7 +23,7 @@ sap.ui.define(['sap/ui/core/Element', 'sap/ui/base/ManagedObjectObserver', './sh
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.124.2
+		 * @version 1.126.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/f/ShellBar.js

@@ -58,7 +58,7 @@ function(
 	 * @implements sap.f.IShellBar, sap.m.IBar, sap.tnt.IToolHeader
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/SidePanel.js

@@ -151,7 +151,7 @@ sap.ui.define([
  	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/SidePanelItem.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Item
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/cards/BaseHeader.js

@@ -50,7 +50,7 @@ sap.ui.define([
 	 * @abstract
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public
@@ -188,8 +188,10 @@ sap.ui.define([
 		if (oToolbar) {
 			oToolbar.addStyleClass("sapFCardHeaderToolbar");
 			oToolbar.removeEventDelegate(this._oToolbarDelegate, this);
+			if (oToolbar.updateVisibility) {
+				oToolbar.updateVisibility();
+			}
 		}
-
 		if (aBannerLines) {
 			aBannerLines.forEach((oText) => {
 				oText.setTextAlign(TextAlign.End);
@@ -250,10 +252,7 @@ sap.ui.define([
 	 * @private
 	 */
 	BaseHeader.prototype._onToolbarFocusin = function () {
-		var oDomRef = this.getDomRef();
-		if (oDomRef) {
-			this.getDomRef().classList.add("sapFCardHeaderToolbarFocused");
-		}
+		this.addStyleClass("sapFCardHeaderToolbarFocused");
 	};
 
 	/**
@@ -261,10 +260,7 @@ sap.ui.define([
 	 * @private
 	 */
 	BaseHeader.prototype._onToolbarFocusout = function () {
-		var oDomRef = this.getDomRef();
-		if (oDomRef) {
-			this.getDomRef().classList.remove("sapFCardHeaderToolbarFocused");
-		}
+		this.removeStyleClass("sapFCardHeaderToolbarFocused");
 	};
 
 	/*

package/src/sap/f/cards/Header.js

@@ -48,7 +48,7 @@ sap.ui.define([
 	 * @implements sap.f.cards.IHeader
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/cards/HeaderRenderer.js

@@ -49,6 +49,10 @@ sap.ui.define([
 			oRm.class("sapFCardHeaderHasIcon");
 		}
 
+		if (oToolbar?.getVisible()) {
+			oRm.class("sapFCardHeaderHasToolbar");
+		}
+
 		oRm.openEnd();
 
 		if (bRenderAsLink) {

package/src/sap/f/cards/NumericHeader.js

@@ -57,7 +57,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.BaseHeader
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/cards/NumericHeaderRenderer.js

@@ -20,9 +20,10 @@ sap.ui.define([
 	 * @param {sap.f.cards.NumericHeader} oNumericHeader An object representation of the control that should be rendered
 	 */
 	NumericHeaderRenderer.render = function (oRm, oNumericHeader) {
-		var bLoading = oNumericHeader.isLoading(),
+		const bLoading = oNumericHeader.isLoading(),
 			oError = oNumericHeader.getAggregation("_error"),
-			bRenderAsLink = oNumericHeader.isLink();
+			bRenderAsLink = oNumericHeader.isLink(),
+			oToolbar = oNumericHeader.getToolbar();
 
 		oRm.openStart("div", oNumericHeader)
 			.class("sapFCardHeader")
@@ -44,6 +45,10 @@ sap.ui.define([
 			oRm.class("sapFCardHeaderHasNumber");
 		}
 
+		if (oToolbar?.getVisible()) {
+			oRm.class("sapFCardHeaderHasToolbar");
+		}
+
 		oRm.openEnd();
 
 		if (bRenderAsLink) {

package/src/sap/f/cards/NumericIndicators.js

@@ -25,7 +25,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/NumericSideIndicator.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/f/cards/loading/AnalyticalPlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/CalendarPlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.loading.ListPlaceholder
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/GenericPlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/f/cards/loading/ListPlaceholder.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.124.2
+	 * @version 1.126.0
 	 *
 	 * @constructor
 	 * @private