@openui5/sap.ui.webc.main 1.101.0 → 1.103.0

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

@@ -0,0 +1,112 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides control sap.ui.webc.main.MenuItem.
+sap.ui.define([
+	"sap/ui/webc/common/WebComponent",
+	"./library",
+	"sap/ui/core/EnabledPropagator",
+	"./thirdparty/MenuItem"
+], function(WebComponent, library, EnabledPropagator) {
+	"use strict";
+
+	/**
+	 * Constructor for a new <code>MenuItem</code>.
+	 *
+	 * @param {string} [sId] ID for the new control, generated automatically if no ID is given
+	 * @param {object} [mSettings] Initial settings for the new control
+	 *
+	 * @extends sap.ui.webc.common.WebComponent
+	 * @class
+	 *
+	 * <h3>Overview</h3>
+	 *
+	 * <code>sap.ui.webc.main.MenuItem</code> is the item to use inside a <code>sap.ui.webc.main.Menu</code>. An arbitrary hierarchy structure can be represented by recursively nesting menu items.
+	 *
+	 * <h3>Usage</h3>
+	 *
+	 * <code>sap.ui.webc.main.MenuItem</code> is an abstract element, representing a node in a <code>sap.ui.webc.main.Menu</code>. The menu itself is rendered as a list, and each <code>sap.ui.webc.main.MenuItem</code> is represented by a list item (<code>sap.ui.webc.main.StandardListItem</code>) in that list. Therefore, you should only use <code>sap.ui.webc.main.MenuItem</code> directly in your apps. The <code>sap.ui.webc.main.StandardListItem</code> list item is internal for the list, and not intended for public use.
+	 *
+	 * @author SAP SE
+	 * @version 1.103.0
+	 *
+	 * @constructor
+	 * @public
+	 * @since 1.102.0
+	 * @experimental Since 1.102.0 This control is experimental and its API might change significantly.
+	 * @alias sap.ui.webc.main.MenuItem
+	 * @implements sap.ui.webc.main.IMenuItem
+	 * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
+	 */
+	var MenuItem = WebComponent.extend("sap.ui.webc.main.MenuItem", {
+		metadata: {
+			library: "sap.ui.webc.main",
+			tag: "ui5-menu-item-ui5",
+			interfaces: [
+				"sap.ui.webc.main.IMenuItem"
+			],
+			properties: {
+
+				/**
+				 * Defines whether the control is enabled. A disabled control can't be interacted with, and it is not in the tab chain.
+				 */
+				enabled: {
+					type: "boolean",
+					defaultValue: true,
+					mapping: {
+						type: "attribute",
+						to: "disabled",
+						formatter: "_mapEnabled"
+					}
+				},
+
+				/**
+				 * Defines the icon to be displayed as graphical element within the component. The SAP-icons font provides numerous options. <br>
+				 * <br>
+				 * <b>* Example:</b> See all the available icons in the <ui5-link target="_blank" href="https://openui5.hana.ondemand.com/test-resources/sap/m/demokit/iconExplorer/webapp/index.html" class="api-table-content-cell-link">Icon Explorer</ui5-link>.
+				 */
+				icon: {
+					type: "string",
+					defaultValue: ""
+				},
+
+				/**
+				 * Defines whether a visual separator should be rendered before the item.
+				 */
+				startsSection: {
+					type: "boolean",
+					defaultValue: false
+				},
+
+				/**
+				 * Defines the text of the tree item.
+				 */
+				text: {
+					type: "string",
+					defaultValue: ""
+				}
+			},
+			defaultAggregation: "items",
+			aggregations: {
+
+				/**
+				 * Defines the items of this component.
+				 */
+				items: {
+					type: "sap.ui.webc.main.IMenuItem",
+					multiple: true
+				}
+			}
+		}
+	});
+
+	EnabledPropagator.call(MenuItem.prototype);
+
+	/* CUSTOM CODE START */
+	/* CUSTOM CODE END */
+
+	return MenuItem;
+});

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

@@ -34,7 +34,7 @@ sap.ui.define([
 	 * <h3>Keyboard Handling</h3>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -59,7 +59,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -38,7 +38,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public
@@ -342,11 +342,19 @@ sap.ui.define([
 					parameters: {}
 				}
 			},
+			methods: ["openPicker"],
 			getters: ["previewItem"],
 			designtime: "sap/ui/webc/main/designtime/MultiInput.designtime"
 		}
 	});
 
+	/**
+	 * Manually opens the suggestions popover, assuming suggestions are enabled. Items must be preloaded for it to open.
+	 * @public
+	 * @name sap.ui.webc.main.MultiInput#openPicker
+	 * @function
+	 */
+
 	/**
 	 * Returns the the suggestion item on preview.
 	 * @public

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.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public
@@ -46,6 +46,13 @@ sap.ui.define([
 			],
 			properties: {
 
+				/**
+				 * Defines the additional text displayed at the end of the option element.
+				 */
+				additionalText: {
+					type: "string"
+				},
+
 				/**
 				 * Defines whether the control is enabled. A disabled control can't be interacted with, and it is not in the tab chain.
 				 */

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

@@ -60,7 +60,7 @@ sap.ui.define([
 	 * <h3>Keyboard Handling</h3>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -51,7 +51,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public
@@ -303,7 +303,8 @@ sap.ui.define([
 					parameters: {}
 				}
 			},
-			methods: ["applyFocus", "close", "isOpen", "showAt"]
+			methods: ["applyFocus", "close", "isOpen", "showAt"],
+			designtime: "sap/ui/webc/main/designtime/Popover.designtime"
 		}
 	});
 

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.101.0
+	 * @version 1.103.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.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public
@@ -190,7 +190,8 @@ sap.ui.define([
 				change: {
 					parameters: {}
 				}
-			}
+			},
+			designtime: "sap/ui/webc/main/designtime/RadioButton.designtime"
 		}
 	});
 

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

@@ -61,7 +61,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -43,7 +43,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public
@@ -276,7 +276,8 @@ sap.ui.define([
 					parameters: {}
 				}
 			},
-			methods: ["applyFocus", "close", "isOpen", "showAt"]
+			methods: ["applyFocus", "close", "isOpen", "showAt"],
+			designtime: "sap/ui/webc/main/designtime/ResponsivePopover.designtime"
 		}
 	});
 

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

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * <b>Note:</b> There can be just one selected <code>item</code> at a time.
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * </ul> <br>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -71,7 +71,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -50,7 +50,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -41,7 +41,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public
@@ -154,7 +154,8 @@ sap.ui.define([
 				detailClick: {
 					parameters: {}
 				}
-			}
+			},
+			designtime: "sap/ui/webc/main/designtime/StandardListItem.designtime"
 		}
 	});
 

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

@@ -52,7 +52,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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.101.0
+	 * @version 1.103.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.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -43,7 +43,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public
@@ -64,6 +64,8 @@ sap.ui.define([
 
 				/**
 				 * 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.
 				 */
 				accessibleName: {
 					type: "string"

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.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public
@@ -136,7 +136,8 @@ sap.ui.define([
 					slot: "subTabs"
 				}
 			},
-			methods: ["getTabInStripDomRef"]
+			methods: ["getTabInStripDomRef"],
+			designtime: "sap/ui/webc/main/designtime/Tab.designtime"
 		}
 	});
 

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

@@ -49,7 +49,7 @@ sap.ui.define([
 	 * <h3>Keyboard Handling</h3>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public
@@ -199,7 +199,8 @@ sap.ui.define([
 						}
 					}
 				}
-			}
+			},
+			designtime: "sap/ui/webc/main/designtime/TabContainer.designtime"
 		}
 	});
 

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

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * The <code>sap.ui.webc.main.TabSeparator</code> represents a vertical line to separate tabs inside a <code>sap.ui.webc.main.TabContainer</code>.
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -52,11 +52,11 @@ sap.ui.define([
 	 *     <li>[ALT]+[DOWN]/[UP] - Switches focus between header, last focused item, and More button (if applies) in either direction.</li>
 	 *     <li>[SHIFT]+[DOWN]/[UP] - Selects the next/previous item in a MultiSelect table, if the current item is selected (Range selection). Otherwise, deselects them (Range deselection).</li>
 	 *     <li>[SHIFT]+[HOME]/[END] - Range selection to the first/last item of the List.</li>
-	 *     <li>[CTRL]+[HOME]/[END] - Same behavior as HOME & END.</li> *
+	 *     <li>[CTRL]+[HOME]/[END] - Same behavior as HOME & END.</li>
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public
@@ -71,6 +71,13 @@ sap.ui.define([
 			tag: "ui5-table-ui5",
 			properties: {
 
+				/**
+				 * Defines the accessible aria name of the component.
+				 */
+				accessibleName: {
+					type: "string"
+				},
+
 				/**
 				 * Defines if the table is in busy state. <b>
 				 *
@@ -229,6 +236,21 @@ sap.ui.define([
 					multiple: true
 				}
 			},
+			associations: {
+
+				/**
+				 * Receives id(or many ids) of the controls that label this control.
+				 */
+				ariaLabelledBy: {
+					type: "sap.ui.core.Control",
+					multiple: true,
+					mapping: {
+						type: "property",
+						to: "accessibleNameRef",
+						formatter: "_getAriaLabelledByForRendering"
+					}
+				}
+			},
 			events: {
 
 				/**

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

@@ -34,7 +34,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -34,7 +34,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -34,7 +34,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -41,7 +41,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -63,7 +63,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * The <code>sap.ui.webc.main.Title</code> component is used to display titles inside a page. It is a simple, large-sized text with explicit header/title semantics.
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public
@@ -80,7 +80,8 @@ sap.ui.define([
 					type: "sap.ui.webc.main.WrappingType",
 					defaultValue: WrappingType.None
 				}
-			}
+			},
+			designtime: "sap/ui/webc/main/designtime/Title.designtime"
 		}
 	});
 

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

@@ -44,7 +44,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * Clicking or tapping on a <code>sap.ui.webc.main.ToggleButton</code> changes its state to <code>pressed</code>. The button 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.ToggleButton</code>.
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * Tokens are small items of information (similar to tags) that mainly serve to visualize previously selected items.
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -57,7 +57,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

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

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * <h3>Usage</h3> <code>sap.ui.webc.main.TreeItem</code> is an abstract element, representing a node in a <code>sap.ui.webc.main.Tree</code>. The tree itself is rendered as a list, and each <code>sap.ui.webc.main.TreeItem</code> is represented by a list item(<code>sap.ui.webc.main.TreeListItem</code>) in that list. Therefore, you should only use <code>sap.ui.webc.main.TreeItem</code> directly in your apps. The <code>sap.ui.webc.main.TreeListItem</code> list item is internal for the list, and not intended for public use.
 	 *
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/webc/main/changeHandler/ChangeLinkTarget.js

@@ -12,7 +12,7 @@ sap.ui.define(function () {
 	 *
 	 * @alias sap.ui.webc.main.changeHandler.ChangeLinkTarget
 	 * @author SAP SE
-	 * @version 1.101.0
+	 * @version 1.103.0
 	 */
 	var ChangeLinkTarget = {};