@sapui5/sap.suite.ui.commons 1.99.0 → 1.100.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/package.json +1 -1
  2. package/src/sap/suite/ui/commons/.library +1 -1
  3. package/src/sap/suite/ui/commons/AriaProperties.js +1 -1
  4. package/src/sap/suite/ui/commons/CalculationBuilder.js +1 -1
  5. package/src/sap/suite/ui/commons/CalculationBuilderExpression.js +1 -1
  6. package/src/sap/suite/ui/commons/CalculationBuilderFunction.js +1 -1
  7. package/src/sap/suite/ui/commons/CalculationBuilderGroup.js +1 -1
  8. package/src/sap/suite/ui/commons/CalculationBuilderItem.js +1 -1
  9. package/src/sap/suite/ui/commons/CalculationBuilderValidationResult.js +1 -1
  10. package/src/sap/suite/ui/commons/CalculationBuilderVariable.js +1 -1
  11. package/src/sap/suite/ui/commons/MicroProcessFlow.js +1 -1
  12. package/src/sap/suite/ui/commons/MicroProcessFlowItem.js +23 -24
  13. package/src/sap/suite/ui/commons/flexibility/changeHandler/PropertyChangeMapper.js +1 -1
  14. package/src/sap/suite/ui/commons/imageeditor/CropCustomShapeHistoryItem.js +1 -1
  15. package/src/sap/suite/ui/commons/imageeditor/CropEllipseHistoryItem.js +1 -1
  16. package/src/sap/suite/ui/commons/imageeditor/CropRectangleHistoryItem.js +1 -1
  17. package/src/sap/suite/ui/commons/imageeditor/CustomSizeItem.js +1 -1
  18. package/src/sap/suite/ui/commons/imageeditor/FilterHistoryItem.js +1 -1
  19. package/src/sap/suite/ui/commons/imageeditor/FlipHistoryItem.js +1 -1
  20. package/src/sap/suite/ui/commons/imageeditor/HistoryItem.js +1 -1
  21. package/src/sap/suite/ui/commons/imageeditor/ImageEditor.js +1 -1
  22. package/src/sap/suite/ui/commons/imageeditor/ImageEditorContainer.js +1 -1
  23. package/src/sap/suite/ui/commons/imageeditor/ImageEditorResponsiveContainer.js +1 -1
  24. package/src/sap/suite/ui/commons/imageeditor/ResizeHistoryItem.js +1 -1
  25. package/src/sap/suite/ui/commons/imageeditor/RotateHistoryItem.js +1 -1
  26. package/src/sap/suite/ui/commons/library.js +1 -1
  27. package/src/sap/suite/ui/commons/messagebundle_pt.properties +2 -2
  28. package/src/sap/suite/ui/commons/networkgraph/Graph.js +2 -1
  29. package/src/sap/suite/ui/commons/networkgraph/Line.js +1 -1
  30. package/src/sap/suite/ui/commons/statusindicator/Circle.js +1 -1
  31. package/src/sap/suite/ui/commons/statusindicator/CustomShape.js +1 -1
  32. package/src/sap/suite/ui/commons/statusindicator/DiscreteThreshold.js +1 -1
  33. package/src/sap/suite/ui/commons/statusindicator/FillingOption.js +1 -1
  34. package/src/sap/suite/ui/commons/statusindicator/LibraryShape.js +1 -1
  35. package/src/sap/suite/ui/commons/statusindicator/Path.js +1 -1
  36. package/src/sap/suite/ui/commons/statusindicator/PropertyThreshold.js +1 -1
  37. package/src/sap/suite/ui/commons/statusindicator/Rectangle.js +1 -1
  38. package/src/sap/suite/ui/commons/statusindicator/Shape.js +1 -1
  39. package/src/sap/suite/ui/commons/statusindicator/ShapeGroup.js +1 -1
  40. package/src/sap/suite/ui/commons/statusindicator/SimpleShape.js +1 -1
  41. package/src/sap/suite/ui/commons/statusindicator/StatusIndicator.js +1 -1
  42. package/src/sap/suite/ui/commons/taccount/TAccount.js +1 -1
  43. package/src/sap/suite/ui/commons/taccount/TAccountGroup.js +1 -1
  44. package/src/sap/suite/ui/commons/taccount/TAccountItem.js +1 -1
  45. package/src/sap/suite/ui/commons/taccount/TAccountItemProperty.js +1 -1
  46. package/src/sap/suite/ui/commons/taccount/TAccountPanel.js +1 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sapui5/sap.suite.ui.commons",
3
- "version": "1.99.0",
3
+ "version": "1.100.0",
4
4
  "description": "SAPUI5 Library sap.suite.ui.commons",
5
5
  "homepage": "https://sap.github.io/ui5-tooling/pages/SAPUI5/",
6
6
  "author": "SAP SE (https://www.sap.com)",
@@ -7,7 +7,7 @@
7
7
  SAP UI development toolkit for HTML5 (SAPUI5)
8
8
  (c) Copyright 2009-2015 SAP SE. All rights reserved
9
9
  </copyright>
10
- <version>1.99.0</version>
10
+ <version>1.100.0</version>
11
11
 
12
12
  <documentation>SAP UI library: sap.suite.ui.commons</documentation>
13
13
 
@@ -19,7 +19,7 @@ sap.ui.define([
19
19
  * @extends sap.ui.core.Element
20
20
  *
21
21
  * @author SAP SE
22
- * @version 1.99.0
22
+ * @version 1.100.0
23
23
  * @since 1.65.0
24
24
  *
25
25
  * @constructor
@@ -124,7 +124,7 @@ sap.ui.define([
124
124
  * @extends sap.ui.core.Control
125
125
  *
126
126
  * @author SAP SE
127
- * @version 1.99.0
127
+ * @version 1.100.0
128
128
  * @since 1.56.0
129
129
  *
130
130
  * @constructor
@@ -120,7 +120,7 @@ sap.ui.define([
120
120
  * @extends sap.ui.core.Control
121
121
  *
122
122
  * @author SAP SE
123
- * @version 1.99.0
123
+ * @version 1.100.0
124
124
  * @since 1.56.0
125
125
  *
126
126
  * @constructor
@@ -18,7 +18,7 @@ sap.ui.define([
18
18
  * @extends sap.ui.core.Control
19
19
  *
20
20
  * @author SAP SE
21
- * @version 1.99.0
21
+ * @version 1.100.0
22
22
  * @since 1.56.0
23
23
  *
24
24
  * @constructor
@@ -15,7 +15,7 @@ sap.ui.define([
15
15
  * @extends sap.ui.core.Control
16
16
  *
17
17
  * @author SAP SE
18
- * @version 1.99.0
18
+ * @version 1.100.0
19
19
  * @since 1.60.0
20
20
  *
21
21
  * @constructor
@@ -30,7 +30,7 @@ sap.ui.define([
30
30
  * @extends sap.ui.core.Control
31
31
  *
32
32
  * @author SAP SE
33
- * @version 1.99.0
33
+ * @version 1.100.0
34
34
  * @since 1.56.0
35
35
  *
36
36
  * @constructor
@@ -16,7 +16,7 @@ sap.ui.define([
16
16
  * @extends sap.ui.base.ManagedObject
17
17
  *
18
18
  * @author SAP SE
19
- * @version 1.99.0
19
+ * @version 1.100.0
20
20
  * @since 1.56.0
21
21
  *
22
22
  * @constructor
@@ -15,7 +15,7 @@ sap.ui.define([
15
15
  * @extends sap.ui.core.Control
16
16
  *
17
17
  * @author SAP SE
18
- * @version 1.99.0
18
+ * @version 1.100.0
19
19
  * @since 1.56.0
20
20
  *
21
21
  * @constructor
@@ -28,7 +28,7 @@ sap.ui.define([
28
28
  * @extends sap.ui.core.Control
29
29
  *
30
30
  * @author SAP SE
31
- * @version 1.99.0
31
+ * @version 1.100.0
32
32
  *
33
33
  * @constructor
34
34
  * @public
@@ -30,7 +30,7 @@ sap.ui.define([
30
30
  * @extends sap.ui.core.Control
31
31
  *
32
32
  * @author SAP SE
33
- * @version 1.99.0
33
+ * @version 1.100.0
34
34
  *
35
35
  * @constructor
36
36
  * @public
@@ -189,7 +189,7 @@ sap.ui.define([
189
189
  if (oCustomControl) {
190
190
  oRM.renderControl(oCustomControl);
191
191
  } else {
192
- oRM.write("<div tabindex=\"-1\" id=\"" + sId + "-itemContent\" class=\"sapSuiteUiCommonsMicroProcessFlowItem sapSuiteUiCommonsMicroProcessFlowItem" +
192
+ oRM.write("<div tabindex=\"0\" id=\"" + sId + "-itemContent\" class=\"sapSuiteUiCommonsMicroProcessFlowItem sapSuiteUiCommonsMicroProcessFlowItem" +
193
193
  oMicroProcessFlowItem.getState() + "\"");
194
194
  oRM.writeAttributeEscaped("aria-label", oMicroProcessFlowItem._getAriaText());
195
195
  oRM.writeAttributeEscaped("role", "option");
@@ -224,25 +224,15 @@ sap.ui.define([
224
224
  /* Private methods */
225
225
  /* =========================================================== */
226
226
  MicroProcessFlowItem.prototype._setAccessibility = function () {
227
- var item = this._getAccessibleItem()[0],
227
+ var $item = this._getAccessibleItem(),
228
228
  sAriaLabel = this._getAriaText();
229
-
230
- var selectedItem = document.getElementsByClassName('sapSuiteILCSelected')[0];
231
- if (selectedItem) {
232
- selectedItem.setAttribute("tabindex", -1);
233
- selectedItem.setAttribute("aria-selected", false);
234
- selectedItem.classList.remove("sapSuiteILCSelected");
235
- }
236
-
237
- if (item.tabIndex == "0") {
238
- item.setAttribute("aria-selected", true);
239
- item.classList.add("sapSuiteILCSelected");
229
+ if ($item.attr("tabindex") !== "0") {
230
+ $item.attr("tabindex", 0);
240
231
  }
241
-
242
- item.setAttribute("aria-label", sAriaLabel);
243
- item.setAttribute("role", "option");
244
- item.setAttribute("aria-posinset", this._iIndex);
245
- item.setAttribute("aria-setsize", this._iItemsCount);
232
+ $item.attr("aria-label", sAriaLabel);
233
+ $item.attr("role", "option");
234
+ $item.attr("aria-posinset", this._iIndex);
235
+ $item.attr("aria-setsize", this._iItemsCount);
246
236
  };
247
237
 
248
238
  MicroProcessFlowItem.prototype._getAccessibleItem = function () {
@@ -272,6 +262,7 @@ sap.ui.define([
272
262
  if (bHasPressEvent) {
273
263
  $item.css("cursor", "pointer");
274
264
  $item.attr("role", "button");
265
+ $item.attr("aria-hidden", "true");
275
266
  }
276
267
  };
277
268
 
@@ -333,20 +324,28 @@ sap.ui.define([
333
324
  };
334
325
 
335
326
  MicroProcessFlowItem.prototype._firePress = function (oEvent) {
336
- if(this.hasListeners("press")) {
327
+ if (this.hasListeners("press")) {
337
328
  this.firePress({
338
329
  item: this.getFocusDomRef()
339
330
  });
340
- if(oEvent.preventDefault) {
331
+ if (oEvent.preventDefault) {
341
332
  oEvent.preventDefault();
342
333
  }
343
- if(oEvent.stopPropagation) {
334
+ if (oEvent.stopPropagation) {
344
335
  oEvent.stopPropagation();
345
336
  }
346
337
  }
347
338
 
348
- this.getFocusDomRef().tabIndex = 0;
349
- this._setAccessibility();
339
+ var selectedItem = document.getElementsByClassName('sapSuiteMicroProcessFlowItemSelected')[0];
340
+ var item = this._getAccessibleItem()[0];
341
+ if (selectedItem) {
342
+ selectedItem.setAttribute("aria-selected", false);
343
+ selectedItem.classList.remove("sapSuiteMicroProcessFlowItemSelected");
344
+ }
345
+ if (item.tabIndex == "0") {
346
+ item.setAttribute("aria-selected", true);
347
+ item.classList.add("sapSuiteMicroProcessFlowItemSelected");
348
+ }
350
349
  };
351
350
 
352
351
  MicroProcessFlowItem.prototype._getIconByState = function () {
@@ -22,7 +22,7 @@ sap.ui.define([
22
22
  *
23
23
  * @constructor
24
24
  * @alias sap.suite.ui.commons.flexibility.changeHandler.PropertyChangeMapper
25
- * @version 1.99.0
25
+ * @version 1.100.0
26
26
  * @since 1.50
27
27
  * @private
28
28
  */
@@ -21,7 +21,7 @@ sap.ui.define([
21
21
  * @extends sap.suite.ui.commons.imageeditor.HistoryItem
22
22
  *
23
23
  * @author SAP SE
24
- * @version 1.99.0
24
+ * @version 1.100.0
25
25
  * @since 1.67.0
26
26
  *
27
27
  * @constructor
@@ -23,7 +23,7 @@ sap.ui.define([
23
23
  * @extends sap.suite.ui.commons.imageeditor.HistoryItem
24
24
  *
25
25
  * @author SAP SE
26
- * @version 1.99.0
26
+ * @version 1.100.0
27
27
  * @since 1.66.0
28
28
  *
29
29
  * @constructor
@@ -21,7 +21,7 @@ sap.ui.define([
21
21
  * @extends sap.suite.ui.commons.imageeditor.HistoryItem
22
22
  *
23
23
  * @author SAP SE
24
- * @version 1.99.0
24
+ * @version 1.100.0
25
25
  * @since 1.66.0
26
26
  *
27
27
  * @constructor
@@ -15,7 +15,7 @@ sap.ui.define([
15
15
  * @extends sap.ui.core.Element
16
16
  *
17
17
  * @author SAP SE
18
- * @version 1.99.0
18
+ * @version 1.100.0
19
19
  * @since 1.66.0
20
20
  *
21
21
  * @constructor
@@ -21,7 +21,7 @@ sap.ui.define([
21
21
  * @extends sap.suite.ui.commons.imageeditor.HistoryItem
22
22
  *
23
23
  * @author SAP SE
24
- * @version 1.99.0
24
+ * @version 1.100.0
25
25
  * @since 1.66.0
26
26
  *
27
27
  * @constructor
@@ -18,7 +18,7 @@ sap.ui.define([
18
18
  * @extends sap.suite.ui.commons.imageeditor.HistoryItem
19
19
  *
20
20
  * @author SAP SE
21
- * @version 1.99.0
21
+ * @version 1.100.0
22
22
  * @since 1.66.0
23
23
  *
24
24
  * @constructor
@@ -10,7 +10,7 @@ sap.ui.define([
10
10
  * @extends sap.ui.base.Object
11
11
  *
12
12
  * @author SAP SE
13
- * @version 1.99.0
13
+ * @version 1.100.0
14
14
  * @since 1.66.0
15
15
  *
16
16
  * @abstract
@@ -42,7 +42,7 @@ sap.ui.define([
42
42
  * @extends sap.ui.core.Control
43
43
  *
44
44
  * @author SAP SE
45
- * @version 1.99.0
45
+ * @version 1.100.0
46
46
  * @since 1.66.0
47
47
  *
48
48
  * @constructor
@@ -124,7 +124,7 @@ sap.ui.define([
124
124
  * @extends sap.ui.core.Control
125
125
  *
126
126
  * @author SAP SE
127
- * @version 1.99.0
127
+ * @version 1.100.0
128
128
  * @since 1.66.0
129
129
  *
130
130
  * @constructor
@@ -26,7 +26,7 @@ sap.ui.define([
26
26
  * @extends sap.suite.ui.commons.imageeditor.ImageEditorContainer
27
27
  *
28
28
  * @author SAP SE
29
- * @version 1.99.0
29
+ * @version 1.100.0
30
30
  * @since 1.68.0
31
31
  *
32
32
  * @constructor
@@ -22,7 +22,7 @@ sap.ui.define([
22
22
  * @extends sap.suite.ui.commons.imageeditor.HistoryItem
23
23
  *
24
24
  * @author SAP SE
25
- * @version 1.99.0
25
+ * @version 1.100.0
26
26
  * @since 1.66.0
27
27
  *
28
28
  * @constructor
@@ -16,7 +16,7 @@ sap.ui.define([
16
16
  * @extends sap.suite.ui.commons.imageeditor.HistoryItem
17
17
  *
18
18
  * @author SAP SE
19
- * @version 1.99.0
19
+ * @version 1.100.0
20
20
  * @since 1.66.0
21
21
  *
22
22
  * @constructor
@@ -184,7 +184,7 @@ sap.ui.define([
184
184
  "sap.suite.ui.commons.TargetFilterMeasureColumn",
185
185
  "sap.suite.ui.commons.AriaProperties"
186
186
  ],
187
- version: "1.99.0",
187
+ version: "1.100.0",
188
188
  extensions: {
189
189
  flChangeHandlers: {
190
190
  "sap.suite.ui.commons.Timeline": "sap/suite/ui/commons/flexibility/Timeline"
@@ -196,8 +196,8 @@ NUMERICCONTENT_DEVIATION_DOWN=Decrescente
196
196
  CHARTCONTAINER_VIEWBY=Exibi\u00E7\u00E3o por
197
197
  CHARTCONTAINER_LEGEND=Legenda
198
198
  CHARTCONTAINER_PERSONALIZE=Personalizar
199
- CHARTCONTAINER_FULLSCREEN=AbrTlInt.
200
- CHARTCONTAINER_FULLSCREEN_CLOSE=FechTlInt.
199
+ CHARTCONTAINER_FULLSCREEN=Abrir tela inteira
200
+ CHARTCONTAINER_FULLSCREEN_CLOSE=Fechar tela inteira
201
201
  CHARTCONTAINER_OPTIONS=Op\u00E7\u00F5es
202
202
  CHARTCONTAINER_CLOSE=Fechar
203
203
  CHARTCONTAINER_ZOOMIN=Ampliar
@@ -844,7 +844,6 @@ sap.ui.define([
844
844
  }
845
845
  return oResourceBundle.getText("NETWORK_GRAPH_ACCESSIBILITY_ACTION_BUTTON") + " " + sLabel;
846
846
  };
847
-
848
847
  if (oFocus) {
849
848
  if (oFocus.button) {
850
849
  if (oFocus.item instanceof Node) {
@@ -866,6 +865,8 @@ sap.ui.define([
866
865
  }
867
866
  } else if (oFocus.item) {
868
867
  this._setAccessibilityTitle(oFocus.item._getAccessibilityLabel());
868
+ } else {
869
+ fnSetDefaultAccessibilityTitle();
869
870
  }
870
871
  } else {
871
872
  fnSetDefaultAccessibilityTitle();
@@ -690,7 +690,7 @@ sap.ui.define([
690
690
  /**
691
691
  * Adds coordinates for points that should define the shape of the line between its start and end points.
692
692
  * This method doesn't call invalidate on the object.
693
- * @param {{x:float,y:float}} oPoint X and Y coordinates
693
+ * @param {{x: float, y: float}} oPoint X and Y coordinates
694
694
  * @returns {sap.suite.ui.commons.networkgraph.Coordinate} Newly added coordinates object
695
695
  * @public
696
696
  */
@@ -26,7 +26,7 @@ sap.ui.define([
26
26
  * @extends sap.suite.ui.commons.statusindicator.SimpleShape
27
27
  *
28
28
  * @author SAP SE
29
- * @version 1.99.0
29
+ * @version 1.100.0
30
30
  * @since 1.50
31
31
  *
32
32
  * @constructor
@@ -33,7 +33,7 @@ sap.ui.define([
33
33
  * @extends sap.suite.ui.commons.statusindicator.Shape
34
34
  *
35
35
  * @author SAP SE
36
- * @version 1.99.0
36
+ * @version 1.100.0
37
37
  * @since 1.50
38
38
  *
39
39
  * @constructor
@@ -21,7 +21,7 @@ sap.ui.define([
21
21
  * @extends sap.ui.core.Control
22
22
  *
23
23
  * @author SAP SE
24
- * @version 1.99.0
24
+ * @version 1.100.0
25
25
  * @since 1.50
26
26
  *
27
27
  * @constructor
@@ -23,7 +23,7 @@ sap.ui.define([
23
23
  * @extends sap.ui.core.Control
24
24
  *
25
25
  * @author SAP SE
26
- * @version 1.99.0
26
+ * @version 1.100.0
27
27
  * @since 1.50
28
28
  *
29
29
  * @constructor
@@ -23,7 +23,7 @@ sap.ui.define([
23
23
  * @extends sap.suite.ui.commons.statusindicator.CustomShape
24
24
  *
25
25
  * @author SAP SE
26
- * @version 1.99.0
26
+ * @version 1.100.0
27
27
  * @since 1.60.0
28
28
  *
29
29
  * @constructor
@@ -25,7 +25,7 @@ sap.ui.define([
25
25
  * @extends sap.suite.ui.commons.statusindicator.SimpleShape
26
26
  *
27
27
  * @author SAP SE
28
- * @version 1.99.0
28
+ * @version 1.100.0
29
29
  * @since 1.50
30
30
  *
31
31
  * @constructor
@@ -24,7 +24,7 @@ sap.ui.define([
24
24
  * @extends sap.ui.core.Control
25
25
  *
26
26
  * @author SAP SE
27
- * @version 1.99.0
27
+ * @version 1.100.0
28
28
  * @since 1.50
29
29
  *
30
30
  * @constructor
@@ -18,7 +18,7 @@ sap.ui.define(
18
18
  * @extends sap.suite.ui.commons.statusindicator.SimpleShape
19
19
  *
20
20
  * @author SAP SE
21
- * @version 1.99.0
21
+ * @version 1.100.0
22
22
  * @since 1.50
23
23
  *
24
24
  * @constructor
@@ -37,7 +37,7 @@ sap.ui.define([
37
37
  * @extends sap.ui.core.Control
38
38
  *
39
39
  * @author SAP SE
40
- * @version 1.99.0
40
+ * @version 1.100.0
41
41
  * @since 1.50
42
42
  *
43
43
  * @constructor
@@ -29,7 +29,7 @@ sap.ui.define([
29
29
  * @extends sap.ui.core.Control
30
30
  *
31
31
  * @author SAP SE
32
- * @version 1.99.0
32
+ * @version 1.100.0
33
33
  * @since 1.50
34
34
  *
35
35
  * @constructor
@@ -27,7 +27,7 @@ sap.ui.define([
27
27
  * @extends sap.suite.ui.commons.statusindicator.Shape
28
28
  *
29
29
  * @author SAP SE
30
- * @version 1.99.0
30
+ * @version 1.100.0
31
31
  * @since 1.50
32
32
  *
33
33
  * @constructor
@@ -47,7 +47,7 @@ sap.ui.define([
47
47
  * @extends sap.ui.core.Control
48
48
  *
49
49
  * @author SAP SE
50
- * @version 1.99.0
50
+ * @version 1.100.0
51
51
  * @since 1.50
52
52
  *
53
53
  * @constructor
@@ -47,7 +47,7 @@ sap.ui.define([
47
47
  * @extends sap.ui.core.Control
48
48
  *
49
49
  * @author SAP SE
50
- * @version 1.99.0
50
+ * @version 1.100.0
51
51
  * @since 1.58.0
52
52
  *
53
53
  * @constructor
@@ -31,7 +31,7 @@ sap.ui.define([
31
31
  * @extends sap.ui.core.Control
32
32
  *
33
33
  * @author SAP SE
34
- * @version 1.99.0
34
+ * @version 1.100.0
35
35
  * @since 1.58.0
36
36
  *
37
37
  * @constructor
@@ -27,7 +27,7 @@ sap.ui.define([
27
27
  * @extends sap.ui.core.Control
28
28
  *
29
29
  * @author SAP SE
30
- * @version 1.99.0
30
+ * @version 1.100.0
31
31
  * @since 1.58.0
32
32
  *
33
33
  * @constructor
@@ -17,7 +17,7 @@ sap.ui.define([
17
17
  * @extends sap.ui.core.Control
18
18
  *
19
19
  * @author SAP SE
20
- * @version 1.99.0
20
+ * @version 1.100.0
21
21
  * @since 1.58.0
22
22
  *
23
23
  * @constructor
@@ -54,7 +54,7 @@ sap.ui.define([
54
54
  * @extends sap.ui.core.Control
55
55
  *
56
56
  * @author SAP SE
57
- * @version 1.99.0
57
+ * @version 1.100.0
58
58
  * @since 1.58.0
59
59
  *
60
60
  * @constructor