@openui5/sap.ui.webc.main 1.115.1 → 1.116.0

package/src/sap/ui/webc/main/MultiComboBoxItem.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * The <code>sap.ui.webc.main.MultiComboBoxItem</code> represents the item for a <code>sap.ui.webc.main.MultiComboBox</code>.
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/webc/main/MultiInput.js

@@ -33,12 +33,12 @@ sap.ui.define([
 	 *
 	 * User can choose interaction for creating tokens. Fiori Guidelines say that user should create tokens when:
 	 * <ul>
-	 *     <li>Type a value in the input and press enter or focus out the input field (<code>change</code> event is fired)
-	 *     <li>Select a value from the suggestion list</li> (<code>suggestion-item-select</code> event is fired)
+	 *     <li>Type a value in the input and press enter or focus out the input field (<code>change</code> event is fired)</li>
+	 *     <li>Select a value from the suggestion list (<code>suggestion-item-select</code> event is fired)</li>
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -58,7 +58,7 @@ sap.ui.define([
 			properties: {
 
 				/**
-				 * Defines the accessible aria name of the component.
+				 * Defines the accessible ARIA name of the component.
 				 */
 				accessibleName: {
 					type: "string"

package/src/sap/ui/webc/main/Option.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * The <code>sap.ui.webc.main.Option</code> component defines the content of an option in the <code>sap.ui.webc.main.Select</code>.
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/webc/main/Panel.js

@@ -61,7 +61,7 @@ sap.ui.define([
 	 * <h3>Keyboard Handling</h3>
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -76,7 +76,7 @@ sap.ui.define([
 			properties: {
 
 				/**
-				 * Defines the accessible aria name of the component.
+				 * Defines the accessible ARIA name of the component.
 				 */
 				accessibleName: {
 					type: "string",
@@ -84,7 +84,7 @@ sap.ui.define([
 				},
 
 				/**
-				 * Sets the accessible aria role of the component. Depending on the usage, you can change the role from the default <code>Form</code> to <code>Region</code> or <code>Complementary</code>.
+				 * Sets the accessible ARIA role of the component. Depending on the usage, you can change the role from the default <code>Form</code> to <code>Region</code> or <code>Complementary</code>.
 				 */
 				accessibleRole: {
 					type: "sap.ui.webc.main.PanelAccessibleRole",

package/src/sap/ui/webc/main/Popover.js

@@ -15,6 +15,7 @@ sap.ui.define([
 	var PopoverHorizontalAlign = library.PopoverHorizontalAlign;
 	var PopoverPlacementType = library.PopoverPlacementType;
 	var PopoverVerticalAlign = library.PopoverVerticalAlign;
+	var PopupAccessibleRole = library.PopupAccessibleRole;
 
 	/**
 	 * Constructor for a new <code>Popover</code>.
@@ -51,7 +52,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -70,7 +71,20 @@ sap.ui.define([
 				 */
 				accessibleName: {
 					type: "string",
-					defaultValue: ""
+					defaultValue: undefined
+				},
+
+				/**
+				 * Allows setting a custom role. Available options are:
+				 * <ul>
+				 *     <li><code>Dialog</code></li>
+				 *     <li><code>None</code></li>
+				 *     <li><code>AlertDialog</code></li>
+				 * </ul>
+				 */
+				accessibleRole: {
+					type: "sap.ui.webc.main.PopupAccessibleRole",
+					defaultValue: PopupAccessibleRole.Dialog
 				},
 
 				/**
@@ -227,7 +241,7 @@ sap.ui.define([
 			associations: {
 
 				/**
-				 * Defines the opener id of the element that the popover is shown at
+				 * Defines the ID or DOM Reference of the element that the popover is shown at
 				 */
 				opener: {
 					type: "sap.ui.core.Control",
@@ -315,7 +329,7 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Hides the block layer (for modal popups only)
+	 * Closes the popup.
 	 * @public
 	 * @name sap.ui.webc.main.Popover#close
 	 * @function

package/src/sap/ui/webc/main/ProgressIndicator.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * <h3>Responsive Behavior</h3> You can change the size of the Progress Indicator by changing its <code>width</code> or <code>height</code> CSS properties.
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/webc/main/RadioButton.js

@@ -39,7 +39,7 @@ sap.ui.define([
 	 * <b>Note:</b> On entering radio button group, the focus goes to the currently selected radio button.
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -57,6 +57,14 @@ sap.ui.define([
 			],
 			properties: {
 
+				/**
+				 * Defines the accessible ARIA name of the component.
+				 */
+				accessibleName: {
+					type: "string",
+					defaultValue: ""
+				},
+
 				/**
 				 * Defines whether the component is checked or not. <br>
 				 * <br>
@@ -111,6 +119,14 @@ sap.ui.define([
 					defaultValue: false
 				},
 
+				/**
+				 * Defines whether the component is required.
+				 */
+				required: {
+					type: "boolean",
+					defaultValue: false
+				},
+
 				/**
 				 * Defines the text of the component.
 				 */

package/src/sap/ui/webc/main/RangeSlider.js

@@ -43,6 +43,16 @@ sap.ui.define([
 	 *
 	 * <h3>Responsive Behavior</h3> You can move the currently selected range by clicking on it and dragging it along the interval.
 	 *
+	 * <h3>CSS Shadow Parts</h3>
+	 *
+	 * {@link https://developer.mozilla.org/en-US/docs/Web/CSS/::part CSS Shadow Parts} allow developers to style elements inside the Shadow DOM. <br>
+	 * The <code>sap.ui.webc.main.RangeSlider</code> exposes the following CSS Shadow Parts:
+	 * <ul>
+	 *     <li>progress-container - Used to style the progress container(the horizontal bar which visually represents the range between the minimum and maximum value) of the <code>sap.ui.webc.main.RangeSlider</code>.</li>
+	 *     <li>progress-bar - Used to style the progress bar, which shows the progress of the <code>sap.ui.webc.main.RangeSlider</code>.</li>
+	 *     <li>handle - Used to style the handles of the <code>sap.ui.webc.main.RangeSlider</code>.</li>
+	 * </ul>
+	 *
 	 * <h3>Keyboard Handling</h3>
 	 *
 	 *
@@ -61,7 +71,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -76,7 +86,7 @@ sap.ui.define([
 			properties: {
 
 				/**
-				 * Defines the accessible aria name of the component.
+				 * Defines the accessible ARIA name of the component.
 				 */
 				accessibleName: {
 					type: "string"

package/src/sap/ui/webc/main/RatingIndicator.js

@@ -43,7 +43,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -62,7 +62,7 @@ sap.ui.define([
 			properties: {
 
 				/**
-				 * Defines the accessible aria name of the component.
+				 * Defines the accessible ARIA name of the component.
 				 */
 				accessibleName: {
 					type: "string"

package/src/sap/ui/webc/main/ResponsivePopover.js

@@ -15,6 +15,7 @@ sap.ui.define([
 	var PopoverHorizontalAlign = library.PopoverHorizontalAlign;
 	var PopoverPlacementType = library.PopoverPlacementType;
 	var PopoverVerticalAlign = library.PopoverVerticalAlign;
+	var PopupAccessibleRole = library.PopupAccessibleRole;
 
 	/**
 	 * Constructor for a new <code>ResponsivePopover</code>.
@@ -40,7 +41,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -59,7 +60,20 @@ sap.ui.define([
 				 */
 				accessibleName: {
 					type: "string",
-					defaultValue: ""
+					defaultValue: undefined
+				},
+
+				/**
+				 * Allows setting a custom role. Available options are:
+				 * <ul>
+				 *     <li><code>Dialog</code></li>
+				 *     <li><code>None</code></li>
+				 *     <li><code>AlertDialog</code></li>
+				 * </ul>
+				 */
+				accessibleRole: {
+					type: "sap.ui.webc.main.PopupAccessibleRole",
+					defaultValue: PopupAccessibleRole.Dialog
 				},
 
 				/**
@@ -200,7 +214,7 @@ sap.ui.define([
 			associations: {
 
 				/**
-				 * Defines the opener id of the element that the popover is shown at
+				 * Defines the ID or DOM Reference of the element that the popover is shown at
 				 */
 				opener: {
 					type: "sap.ui.core.Control",
@@ -295,7 +309,7 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Tells if the responsive popover is open
+	 * Tells if the responsive popover is open.
 	 * @public
 	 * @name sap.ui.webc.main.ResponsivePopover#isOpen
 	 * @function

package/src/sap/ui/webc/main/SegmentedButton.js

@@ -12,6 +12,8 @@ sap.ui.define([
 ], function(WebComponent, library) {
 	"use strict";
 
+	var SegmentedButtonMode = library.SegmentedButtonMode;
+
 	/**
 	 * Constructor for a new <code>SegmentedButton</code>.
 	 *
@@ -28,7 +30,7 @@ sap.ui.define([
 	 * <b>Note:</b> There can be just one selected <code>item</code> at a time.
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -47,10 +49,29 @@ sap.ui.define([
 			properties: {
 
 				/**
-				 * Defines the accessible aria name of the component.
+				 * Defines the accessible ARIA name of the component.
 				 */
 				accessibleName: {
-					type: "string"
+					type: "string",
+					defaultValue: undefined
+				},
+
+				/**
+				 * Defines the component selection mode.
+				 *
+				 * <br>
+				 * <br>
+				 * <b>The available values are:</b>
+				 *
+				 *
+				 * <ul>
+				 *     <li><code>SingleSelect</code></li>
+				 *     <li><code>MultiSelect</code></li>
+				 * </ul>
+				 */
+				mode: {
+					type: "sap.ui.webc.main.SegmentedButtonMode",
+					defaultValue: SegmentedButtonMode.SingleSelect
 				},
 
 				/**
@@ -84,15 +105,22 @@ sap.ui.define([
 				selectionChange: {
 					parameters: {
 						/**
-						 * the pressed item.
+						 * the pressed item. Note: deprecated since 1.14.0 and will be removed in the next major release, use the <code>selectedItems</code> parameter instead.
 						 */
 						selectedItem: {
 							type: "HTMLElement"
+						},
+
+						/**
+						 * an array of selected items. Note: available since 1.14.0.
+						 */
+						selectedItems: {
+							type: "HTMLElement[]"
 						}
 					}
 				}
 			},
-			getters: ["selectedItem"]
+			getters: ["selectedItem", "selectedItems"]
 		}
 	});
 
@@ -103,6 +131,13 @@ sap.ui.define([
 	 * @function
 	 */
 
+	/**
+	 * Returns an array of the currently selected items.
+	 * @public
+	 * @name sap.ui.webc.main.SegmentedButton#getSelectedItems
+	 * @function
+	 */
+
 	/* CUSTOM CODE START */
 
 	// eslint-disable-next-line no-warning-comments

package/src/sap/ui/webc/main/SegmentedButtonItem.js

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * Clicking or tapping on a <code>sap.ui.webc.main.SegmentedButtonItem</code> changes its state to <code>pressed</code>. The item returns to its initial state when the user clicks or taps on it again. By applying additional custom CSS-styling classes, apps can give a different style to any <code>sap.ui.webc.main.SegmentedButtonItem</code>.
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -80,10 +80,11 @@ sap.ui.define([
 				},
 
 				/**
-				 * Defines the accessible aria name of the component.
+				 * Defines the accessible ARIA name of the component.
 				 */
 				accessibleName: {
-					type: "string"
+					type: "string",
+					defaultValue: undefined
 				},
 
 				/**

package/src/sap/ui/webc/main/Select.js

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * </ul> <br>
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -59,10 +59,11 @@ sap.ui.define([
 			properties: {
 
 				/**
-				 * Defines the accessible aria name of the component.
+				 * Defines the accessible ARIA name of the component.
 				 */
 				accessibleName: {
-					type: "string"
+					type: "string",
+					defaultValue: ""
 				},
 
 				/**
@@ -181,6 +182,7 @@ sap.ui.define([
 				 * Fired when the selected option changes.
 				 */
 				change: {
+					allowPreventDefault: true,
 					parameters: {
 						/**
 						 * the selected option.
@@ -189,6 +191,20 @@ sap.ui.define([
 							type: "HTMLElement"
 						}
 					}
+				},
+
+				/**
+				 * Fired after the component's dropdown menu closes.
+				 */
+				close: {
+					parameters: {}
+				},
+
+				/**
+				 * Fired after the component's dropdown menu opens.
+				 */
+				open: {
+					parameters: {}
 				}
 			},
 			getters: ["selectedOption"]
@@ -196,7 +212,7 @@ sap.ui.define([
 	});
 
 	/**
-	 * Returns the currently selected option.
+	 * Returns the currently selected <code>ui5-option</code> element.
 	 * @public
 	 * @name sap.ui.webc.main.Select#getSelectedOption
 	 * @function

package/src/sap/ui/webc/main/Slider.js

@@ -71,7 +71,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -90,7 +90,7 @@ sap.ui.define([
 			properties: {
 
 				/**
-				 * Defines the accessible aria name of the component.
+				 * Defines the accessible ARIA name of the component.
 				 */
 				accessibleName: {
 					type: "string"

package/src/sap/ui/webc/main/SplitButton.js

@@ -42,15 +42,15 @@ sap.ui.define([
 	 * <ul>
 	 *     <li><code>Space</code> or <code>Enter</code> - triggers the default action</li>
 	 *     <li><code>Shift</code> or <code>Escape</code> - if <code>Space</code> is pressed, releases the default action button without triggering the click event.</li>
-	 *     <li><code>Arrow Down</code>, <code>Arrow Up</code>, <code>Alt</code>+<code>Arrow Down</code>, <code>Alt</code>+<code>Arrow Up</code>, or <code>F4</code> - triggers the arrow action There are separate events that are fired on activating of <code>sap.ui.webc.main.SplitButton</code> parts:
-	 *         <ul>
-	 *             <li><code>click</code> for the first button (default action)</li>
-	 *             <li><code>arrow-click</code> for the second button (arrow action)</li>
-	 *         </ul>
+	 *     <li><code>Arrow Down</code>, <code>Arrow Up</code>, <code>Alt</code>+<code>Arrow Down</code>, <code>Alt</code>+<code>Arrow Up</code>, or <code>F4</code> - triggers the arrow action</li> There are separate events that are fired on activating of <code>sap.ui.webc.main.SplitButton</code> parts:
+	 *     <ul>
+	 *         <li><code>click</code> for the first button (default action)</li>
+	 *         <li><code>arrow-click</code> for the second button (arrow action)</li>
+	 *     </ul>
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -65,7 +65,7 @@ sap.ui.define([
 			properties: {
 
 				/**
-				 * Defines the accessible aria name of the component.
+				 * Defines the accessible ARIA name of the component.
 				 */
 				accessibleName: {
 					type: "string"

package/src/sap/ui/webc/main/StandardListItem.js

@@ -41,7 +41,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -76,7 +76,7 @@ sap.ui.define([
 
 				/**
 				 * Defines the state of the <code>additionalText</code>. <br>
-				 * Available options are: <code>"None"</code> (by default), <code>"Success"</code>, <code>"Warning"</code>, <code>"Information"</code> and <code>"Erorr"</code>.
+				 * Available options are: <code>"None"</code> (by default), <code>"Success"</code>, <code>"Warning"</code>, <code>"Information"</code> and <code>"Error"</code>.
 				 */
 				additionalTextState: {
 					type: "sap.ui.core.ValueState",
@@ -118,6 +118,13 @@ sap.ui.define([
 					type: "string"
 				},
 
+				/**
+				 * The navigated state of the list item. If set to <code>true</code>, a navigation indicator is displayed at the end of the list item.
+				 */
+				navigated: {
+					type: "boolean"
+				},
+
 				/**
 				 * Defines the selected state of the <code>ListItem</code>.
 				 */
@@ -136,15 +143,35 @@ sap.ui.define([
 				},
 
 				/**
-				 * Defines the visual indication and behavior of the list items. Available options are <code>Active</code> (by default), <code>Inactive</code> and <code>Detail</code>. <br>
+				 * Defines the visual indication and behavior of the list items. Available options are <code>Active</code> (by default), <code>Inactive</code>, <code>Detail</code> and <code>Navigation</code>. <br>
 				 * <br>
-				 * <b>Note:</b> When set to <code>Active</code>, the item will provide visual response upon press and hover, while with type <code>Inactive</code> and <code>Detail</code> - will not.
+				 * <b>Note:</b> When set to <code>Active</code> or <code>Navigation</code>, the item will provide visual response upon press and hover, while with type <code>Inactive</code> and <code>Detail</code> - will not.
 				 */
 				type: {
 					type: "sap.ui.webc.main.ListItemType",
 					defaultValue: ListItemType.Active
 				}
 			},
+			aggregations: {
+
+				/**
+				 * Defines the delete button, displayed in "Delete" mode. <b>Note:</b> While the slot allows custom buttons, to match design guidelines, please use the <code>sap.ui.webc.main.Button</code> component. <b>Note:</b> When the slot is not present, a built-in delete button will be displayed.
+				 */
+				deleteButton: {
+					type: "sap.ui.webc.main.IButton",
+					multiple: false,
+					slot: "deleteButton"
+				},
+
+				/**
+				 * <b>Note:</b> While the slot allows option for setting custom avatar, to match the design guidelines, please use the <code>sap.ui.webc.main.Avatar</code> with it`s default size - S. <b>Note:</b> If bigger <code>sap.ui.webc.main.Avatar</code> needs to be used, then the size of the <code>sap.ui.webc.main.StandardListItem</code> should be customized in order to fit.
+				 */
+				imageContent: {
+					type: "sap.ui.core.Control",
+					multiple: true,
+					slot: "imageContent"
+				}
+			},
 			events: {
 
 				/**

package/src/sap/ui/webc/main/StepInput.js

@@ -52,7 +52,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -71,7 +71,7 @@ sap.ui.define([
 			properties: {
 
 				/**
-				 * Defines the accessible aria name of the component.
+				 * Defines the accessible ARIA name of the component.
 				 */
 				accessibleName: {
 					type: "string"

package/src/sap/ui/webc/main/SuggestionGroupItem.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * The <code>sap.ui.webc.main.SuggestionGroupItem</code> is type of suggestion item, that can be used to split the <code>sap.ui.webc.main.Input</code> suggestions into groups.
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/webc/main/SuggestionItem.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * The <code>sap.ui.webc.main.SuggestionItem</code> represents the suggestion item of the <code>sap.ui.webc.main.Input</code>.
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -56,7 +56,7 @@ sap.ui.define([
 				/**
 				 * Defines the state of the <code>additionalText</code>. <br>
 				 * <br>
-				 * Available options are: <code>"None"</code> (by default), <code>"Success"</code>, <code>"Information"</code>, <code>"Warning"</code> and <code>"Erorr"</code>.
+				 * Available options are: <code>"None"</code> (by default), <code>"Success"</code>, <code>"Information"</code>, <code>"Warning"</code> and <code>"Error"</code>.
 				 */
 				additionalTextState: {
 					type: "sap.ui.core.ValueState",

package/src/sap/ui/webc/main/Switch.js

@@ -43,7 +43,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -62,7 +62,7 @@ sap.ui.define([
 			properties: {
 
 				/**
-				 * Sets the accessible aria name of the component.
+				 * Sets the accessible ARIA name of the component.
 				 *
 				 * <b>Note</b>: We recommend that you set an accessibleNameRef pointing to an external label or at least an <code>accessibleName</code>. Providing an <code>ariaLabelledBy</code> or an <code>accessibleName</code> is mandatory in the cases when <code>textOn</code> and <code>textOff</code> properties aren't set.
 				 */

package/src/sap/ui/webc/main/Tab.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * The <code>sap.ui.webc.main.Tab</code> represents a selectable item inside a <code>sap.ui.webc.main.TabContainer</code>. It defines both the item in the tab strip (top part of the <code>sap.ui.webc.main.TabContainer</code>) and the content that is presented to the user once the tab is selected.
 	 *
 	 * @author SAP SE
-	 * @version 1.115.1
+	 * @version 1.116.0
 	 *
 	 * @constructor
 	 * @public
@@ -46,7 +46,7 @@ sap.ui.define([
 			properties: {
 
 				/**
-				 * Represents the "additionalText" text, which is displayed in the tab.
+				 * Represents the "additionalText" text, which is displayed in the tab. In the cases when in the same time there are tabs with icons and tabs without icons, if a tab has no icon the "additionalText" is displayed larger.
 				 */
 				additionalText: {
 					type: "string",
@@ -141,7 +141,7 @@ sap.ui.define([
 	});
 
 	/**
-	 * Returns the DOM reference of the tab that is placed in the header. <b>Note:</b> If you need a DOM ref to the tab content please use the <code>getDomRef</code> method.
+	 * Returns the DOM reference of the tab that is placed in the header. <b>Note:</b> Tabs, placed in the <code>subTabs</code> slot of other tabs are not shown in the header. Calling this method on such tabs will return <code>null</code>. <b>Note:</b> If you need a DOM ref to the tab content please use the <code>getDomRef</code> method.
 	 * @public
 	 * @name sap.ui.webc.main.Tab#getTabInStripDomRef
 	 * @function