@openui5/sap.m 1.108.0 → 1.109.0

package/src/sap/m/SliderTooltipContainer.js

@@ -37,7 +37,7 @@ function(
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.108.0
+		 * @version 1.109.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.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/SplitButton.js

@@ -46,7 +46,7 @@ function(
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.108.0
+		 * @version 1.109.0
 		 *
 		 * @constructor
 		 * @private

package/src/sap/m/SplitContainer.js

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

package/src/sap/m/StandardDynamicDateOption.js

@@ -42,7 +42,7 @@ sap.ui.define([
 		 * @extends sap.m.DynamicDateOption
 		 *
 		 * @author SAP SE
-		 * @version 1.108.0
+		 * @version 1.109.0
 		 *
 		 * @public
 		 * @alias sap.m.StandardDynamicDateOption

package/src/sap/m/StandardListItem.js

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

package/src/sap/m/StandardTile.js

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * @extends sap.m.Tile
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.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.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/StepInput.js

@@ -119,7 +119,7 @@ function(
 		 * @implements sap.ui.core.IFormContent
 		 *
 		 * @author SAP SE
-		 * @version 1.108.0
+		 * @version 1.109.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.108.0
+	 * @version 1.109.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.108.0
+	 * @version 1.109.0
 	 */
 	var SuggestionsPopover = EventProvider.extend("sap.m.SuggestionsPopover", /** @lends sap.m.SuggestionsPopover.prototype */ {
 

package/src/sap/m/Switch.js

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

package/src/sap/m/TabContainer.js

@@ -66,7 +66,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.108.0
+		 * @version 1.109.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/TabContainerItem.js

@@ -26,7 +26,7 @@ sap.ui.define(['sap/ui/core/Element',
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.108.0
+		 * @version 1.109.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/TabStrip.js

@@ -73,7 +73,7 @@ function(
 		 * space is exceeded, a horizontal scrollbar appears.
 		 *
 		 * @extends sap.ui.core.Control
-		 * @version 1.108.0
+		 * @version 1.109.0
 		 *
 		 * @constructor
 		 * @private

package/src/sap/m/TabStripItem.js

@@ -25,7 +25,7 @@ sap.ui.define(["./library", "sap/ui/core/Item", "sap/ui/base/ManagedObject", "sa
 		 * @extends sap.ui.core.Item
 		 *
 		 * @author SAP SE
-		 * @version 1.108.0
+		 * @version 1.109.0
 		 *
 		 * @constructor
 		 * @private

package/src/sap/m/Table.js

@@ -65,7 +65,7 @@ sap.ui.define([
 	 * @extends sap.m.ListBase
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public
@@ -445,7 +445,7 @@ sap.ui.define([
 	Table.prototype.onAfterRendering = function() {
 		ListBase.prototype.onAfterRendering.call(this);
 		this.updateSelectAllCheckbox();
-		this._renderOverlay();
+		this._adaptBlockLayer();
 
 		if (this._bFirePopinChanged) {
 			this._firePopinChangedEvent();
@@ -487,15 +487,26 @@ sap.ui.define([
 		return this;
 	};
 
-	Table.prototype._renderOverlay = function() {
-		var $this = this.$(),
-			$overlay = $this.find(".sapMTableOverlay"),
-			bShowOverlay = this.getShowOverlay();
-		if (bShowOverlay && $overlay.length === 0) {
-			$overlay = jQuery("<div>").addClass("sapUiOverlay sapMTableOverlay").css("z-index", "1");
-			$this.append($overlay);
-		} else if (!bShowOverlay) {
-			$overlay.remove();
+	Table.prototype._adaptBlockLayer = function(bLastTry) {
+		if (!this.getShowOverlay()) {
+			return;
+		}
+
+		var oBlockLayer = this.getDomRef("blockedLayer");
+		if (oBlockLayer) {
+			var aValidAttributes = ["id", "class", "tabindex"];
+			oBlockLayer.getAttributeNames().forEach(function(sAttribute) {
+				if (!aValidAttributes.includes(sAttribute)) {
+					oBlockLayer.removeAttribute(sAttribute);
+				}
+			});
+			oBlockLayer.setAttribute("role", "region");
+			oBlockLayer.setAttribute("aria-labelledby", [
+				TableRenderer.getAriaLabelledBy(this),
+				TableRenderer.getAriaAnnouncement("TABLE_INVALID")
+			].join(" ").trimLeft());
+		} else if (!bLastTry) {
+			setTimeout(this._adaptBlockLayer.bind(this, true));
 		}
 	};
 
@@ -522,7 +533,8 @@ sap.ui.define([
 
 	Table.prototype.setShowOverlay = function(bShow) {
 		this.setProperty("showOverlay", bShow, true);
-		this._renderOverlay();
+		this.setBlocked(this.getShowOverlay());
+		this._adaptBlockLayer();
 		return this;
 	};
 
@@ -563,6 +575,7 @@ sap.ui.define([
 	Table.prototype.selectAll = function () {
 		ListBase.prototype.selectAll.apply(this, arguments);
 		this.updateSelectAllCheckbox();
+
 		return this;
 	};
 
@@ -840,20 +853,21 @@ sap.ui.define([
 	};
 
 	Table.prototype.onkeydown = function(oEvent) {
-		// handles the F2 and F7 key on the table header row and column header,
-		// switch focus between the table header row and column header and if F2 is pressed the also switching the keyboardMode
-		var bFocusToggled = false;
+
 
 		if (oEvent.which === KeyCodes.F2 || oEvent.which === KeyCodes.F7) {
-			var $TblHeader = this.$("tblHeader"),
+			// handles the F2 and F7 key on the table header row and column header,
+			// switch focus between the table header row and column header and if F2 is pressed the also switching the keyboardMode
+			var bFocusToggled = false,
+				$TblHeader = this.$("tblHeader"),
 				$Tabbables = $TblHeader.find(":sapTabbable");
 
 			if (oEvent.target.classList.contains("sapMColumnHeader")) {
-				this._iLastFocusPosOfColumnHeader = $Tabbables.length && $Tabbables.index(oEvent.target);
+				this._iLastFocusPosOfItem = $Tabbables.length && $Tabbables.index(oEvent.target);
 				$TblHeader.trigger("focus");
 				bFocusToggled = true;
 			} else if (oEvent.target === $TblHeader[0]) {
-				var iFocusPos = this._iLastFocusPosOfColumnHeader || 0;
+				var iFocusPos = this._iLastFocusPosOfItem || 0;
 				iFocusPos = $Tabbables[iFocusPos] ? iFocusPos : -1;
 				$Tabbables.eq(iFocusPos).trigger("focus");
 				bFocusToggled = true;
@@ -945,7 +959,10 @@ sap.ui.define([
 		if (this.getMode() !== "MultiSelect") {
 			return;
 		}
-		if (this._selectAllCheckBox && this.getMultiSelectMode() == "Default") {
+
+		Util.hideSelectionLimitPopover();
+
+		if (this._selectAllCheckBox && this.getMultiSelectMode() != "ClearAll") {
 			var aItems = this.getItems(),
 				iSelectedItemCount = this.getSelectedItems().length,
 				iSelectableItemCount = aItems.filter(function(oItem) {
@@ -1103,7 +1120,7 @@ sap.ui.define([
 			var sMultiSelectMode = this.getMultiSelectMode();
 
 			// toggle select all header checkbox and fire its event
-			if (this._selectAllCheckBox && sMultiSelectMode == "Default") {
+			if (this._selectAllCheckBox && sMultiSelectMode != "ClearAll") {
 				this._selectAllCheckBox.setSelected(!this._selectAllCheckBox.getSelected()).fireSelect();
 				oEvent.setMarked();
 			} else if (this._clearAllButton && sMultiSelectMode == "ClearAll" && !this._clearAllButton.hasStyleClass("sapMTableDisableClearAll")) {

package/src/sap/m/TablePersoController.js

@@ -39,7 +39,7 @@ sap.ui.define([
 	 * @class Table Personalization Controller
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 * @alias sap.m.TablePersoController
 	 */
 	var TablePersoController = ManagedObject.extend("sap.m.TablePersoController", /** @lends sap.m.TablePersoController.prototype */

package/src/sap/m/TablePersoDialog.js

@@ -85,7 +85,7 @@ sap.ui.define([
 	 * @class Table Personalization Dialog
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 * @alias sap.m.TablePersoDialog
 	 */
 	var TablePersoDialog = ManagedObject.extend("sap.m.TablePersoDialog", /** @lends sap.m.TablePersoDialog.prototype */

package/src/sap/m/TablePersoProvider.js

@@ -21,7 +21,7 @@ sap.ui.define(['sap/ui/base/ManagedObject', "sap/base/Log"],
 	 * @extends sap.ui.base.ManagedObject
 	 * @abstract
 	 * @author SAP
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 * @alias sap.m.TablePersoProvider
 	 */
 	var TablePersoProvider = ManagedObject.extend("sap.m.TablePersoProvider", /** @lends sap.m.TablePersoProvider.prototype */

package/src/sap/m/TableRenderer.js

@@ -145,7 +145,7 @@ sap.ui.define(["sap/ui/core/Renderer", "sap/ui/core/Core", "sap/ui/core/Invisibl
 				rm.class(clsPrefix + "SelCol");
 				rm.attr("role", "presentation");
 				rm.openEnd();
-				rm.renderControl(oTable.getMultiSelectMode() == MultiSelectMode.Default ? oTable._getSelectAllCheckbox() : oTable._getClearAllButton());
+				rm.renderControl(oTable.getMultiSelectMode() == MultiSelectMode.ClearAll ? oTable._getClearAllButton() : oTable._getSelectAllCheckbox());
 				rm.close("th");
 				index++;
 			} else {

package/src/sap/m/TableSelectDialog.js

@@ -11,10 +11,11 @@ sap.ui.define([
 	'./SearchField',
 	'./Table',
 	'./library',
-	"sap/ui/core/library",
+	'sap/ui/core/library',
 	'./SelectDialogBase',
 	'sap/ui/core/InvisibleText',
-	"sap/ui/core/InvisibleMessage",
+	'sap/ui/core/InvisibleMessage',
+	'sap/ui/core/UIArea',
 	'sap/ui/Device',
 	'sap/m/Toolbar',
 	'sap/m/Text',
@@ -32,6 +33,7 @@ sap.ui.define([
 	SelectDialogBase,
 	InvisibleText,
 	InvisibleMessage,
+	UIArea,
 	Device,
 	Toolbar,
 	Text,
@@ -105,7 +107,7 @@ sap.ui.define([
 	 * When using the <code>sap.m.TableSelectDialog</code> in SAP Quartz and Horizon themes, the breakpoints and layout paddings could be determined by the dialog's width. To enable this concept and add responsive paddings to an element of the control, you have to add the following classes depending on your use case: <code>sapUiResponsivePadding--header</code>, <code>sapUiResponsivePadding--subHeader</code>, <code>sapUiResponsivePadding--content</code>, <code>sapUiResponsivePadding--footer</code>.
 	 * @extends sap.m.SelectDialogBase
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public
@@ -479,7 +481,7 @@ sap.ui.define([
 		// but only if it added it there itself. As we did that, we have to remove it also on our own
 		if ( this._bAppendedToUIArea ) {
 			var oStatic = sap.ui.getCore().getStaticAreaRef();
-			oStatic = sap.ui.getCore().getUIArea(oStatic);
+			oStatic = UIArea.registry.get(oStatic.id);
 			oStatic.removeContent(this, true);
 		}
 
@@ -547,7 +549,7 @@ sap.ui.define([
 	TableSelectDialog.prototype.open = function (sSearchValue) {
 		if (!this.getParent() && !this._bAppendedToUIArea) {
 			var oStatic = sap.ui.getCore().getStaticAreaRef();
-			oStatic = sap.ui.getCore().getUIArea(oStatic);
+			oStatic = UIArea.registry.get(oStatic.id);
 			oStatic.addContent(this, true);
 			this._bAppendedToUIArea = true;
 		}

package/src/sap/m/Text.js

@@ -54,7 +54,7 @@ function(library, Core, Control, coreLibrary, Device, HyphenationSupport, TextRe
 	 * @implements sap.ui.core.IShrinkable, sap.ui.core.IFormContent, sap.ui.core.ISemanticFormContent
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/TextArea.js

@@ -84,7 +84,7 @@ function(
 	 * @extends sap.m.InputBase
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/Tile.js

@@ -35,7 +35,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/TileContainer.js

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

package/src/sap/m/TileContent.js

@@ -24,7 +24,7 @@ sap.ui.define(['./library', 'sap/ui/core/library', 'sap/ui/core/Control', './Til
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 * @since 1.34.0
 	 *
 	 * @public

package/src/sap/m/TimePicker.js

@@ -144,7 +144,7 @@ function(
 		 * @extends sap.m.DateTimeField
 		 *
 		 * @author SAP SE
-		 * @version 1.108.0
+		 * @version 1.109.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/TimePickerClock.js

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

package/src/sap/m/TimePickerClocks.js

@@ -50,7 +50,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.108.0
+		 * @version 1.109.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/TimePickerInputs.js

@@ -49,7 +49,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.108.0
+		 * @version 1.109.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/TimePickerInternals.js

@@ -47,7 +47,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.108.0
+		 * @version 1.109.0
 		 *
 		 * @constructor
 		 * @private

package/src/sap/m/TimePickerSlider.js

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

package/src/sap/m/TimePickerSliders.js

@@ -50,7 +50,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Control
 		 *
 		 * @author SAP SE
-		 * @version 1.108.0
+		 * @version 1.109.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/Title.js

@@ -73,7 +73,7 @@ sap.ui.define([
 	 * @implements sap.ui.core.IShrinkable
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 * @since 1.27.0
 	 *
 	 * @constructor

package/src/sap/m/TitlePropagationSupport.js

@@ -51,7 +51,7 @@ sap.ui.define(["sap/ui/core/Configuration"],
 		 * style class support on existing elements by calling this function.
 		 *
 		 * @author SAP SE
-		 * @version 1.108.0
+		 * @version 1.109.0
 		 *
 		 * @param {string} sAggregationName the name of the aggregation which should be affected
 		 * @param {object} fnGetTitleID function that would return the ID of the title

package/src/sap/m/ToggleButton.js

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @extends sap.m.Button
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/Token.js

@@ -50,7 +50,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Control
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public
@@ -164,7 +164,8 @@ sap.ui.define([
 				id : this.getId() + "-icon",
 				src : "sap-icon://decline",
 				noTabStop: true,
-				press : this._fireDeleteToken.bind(this)
+				press : this._fireDeleteToken.bind(this),
+				tooltip: Core.getLibraryResourceBundle("sap.m").getText("TOKEN_ICON_TOOLTIP")
 			});
 
 		oDeleteIcon.addStyleClass("sapMTokenIcon");
@@ -193,14 +194,7 @@ sap.ui.define([
 	 * @return {string} The tooltip text
 	 */
 	Token.prototype._getTooltip = function (oControl, bEditable) {
-		var sTooltip = oControl.getTooltip_AsString(),
-			sDeletableTooltip = Core.getLibraryResourceBundle("sap.m").getText("TOKEN_ARIA_DELETABLE");
-
-		if (bEditable && !sTooltip) {
-			return sDeletableTooltip;
-		}
-
-		return sTooltip;
+		return oControl.getTooltip_AsString();
 	};
 
 	/**

package/src/sap/m/Tokenizer.js

@@ -78,7 +78,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Control
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public
@@ -300,6 +300,7 @@ sap.ui.define([
 				tokens: [oToken]
 			});
 
+			oEvent.cancelBubble();
 		}, this);
 	};
 

package/src/sap/m/Toolbar.js

@@ -72,7 +72,7 @@ function(
 	 * @implements sap.ui.core.Toolbar,sap.m.IBar
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/ToolbarLayoutData.js

@@ -25,7 +25,7 @@ sap.ui.define(['./library', 'sap/ui/core/LayoutData'],
 	 * <code>layoutData</code> aggregation of {@link sap.m.ToolbarSpacer} and if set it's ignored.
 	 *
 	 * @extends sap.ui.core.LayoutData
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/ToolbarSeparator.js

@@ -23,7 +23,7 @@ sap.ui.define(['./library', 'sap/ui/core/Control', './ToolbarSeparatorRenderer']
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/ToolbarSpacer.js

@@ -29,7 +29,7 @@ function(library, Control, ToolbarSpacerRenderer, Log) {
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/Tree.js

@@ -41,7 +41,7 @@ function(
 	 * @extends sap.m.ListBase
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/TreeItemBase.js

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

package/src/sap/m/TreeRenderer.js

@@ -16,6 +16,10 @@ sap.ui.define(['sap/ui/core/Renderer', './ListBaseRenderer'],
 	var TreeRenderer = Renderer.extend(ListBaseRenderer);
 	TreeRenderer.apiVersion = 2;
 
+	TreeRenderer.getNoDataAriaRole = function() {
+		return "treeitem";
+	};
+
 	return TreeRenderer;
 
 }, /* bExport= */ true);

package/src/sap/m/UploadCollection.js

@@ -92,7 +92,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 *
 	 * @constructor
 	 * @public