@openui5/sap.ui.webc.main 1.93.3 → 1.96.2

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

@@ -13,6 +13,7 @@ sap.ui.define([
 ], function(WebComponent, library, coreLibrary) {
 	"use strict";
 
+	var CalendarType = coreLibrary.CalendarType;
 	var ValueState = coreLibrary.ValueState;
 
 	/**
@@ -73,7 +74,7 @@ sap.ui.define([
 	 * </script>
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public
@@ -88,6 +89,21 @@ sap.ui.define([
 			tag: "ui5-date-picker-ui5",
 			properties: {
 
+				/**
+				 * Defines the aria-label attribute for the component.
+				 */
+				accessibleName: {
+					type: "string"
+				},
+
+				/**
+				 * Receives id(or many ids) of the elements that label the component.
+				 */
+				accessibleNameRef: {
+					type: "string",
+					defaultValue: ""
+				},
+
 				/**
 				 * Determines whether the component is displayed as disabled.
 				 */
@@ -180,6 +196,14 @@ sap.ui.define([
 					defaultValue: false
 				},
 
+				/**
+				 * Defines the secondary calendar type. If not set, the calendar will only show the primary calendar type.
+				 */
+				secondaryCalendarType: {
+					type: "sap.ui.core.CalendarType",
+					defaultValue: CalendarType.undefined
+				},
+
 				/**
 				 * Defines a formatted date value.
 				 */
@@ -236,12 +260,46 @@ sap.ui.define([
 				/**
 				 * Fired when the input operation has finished by pressing Enter or on focusout.
 				 */
-				change: {},
+				change: {
+					allowPreventDefault: true,
+					parameters: {
+						/**
+						 * The submitted value.
+						 */
+						value: {
+							type: "string"
+						},
+
+						/**
+						 * Indicator if the value is in correct format pattern and in valid range.
+						 */
+						valid: {
+							type: "boolean"
+						}
+					}
+				},
 
 				/**
 				 * Fired when the value of the component is changed at each key stroke.
 				 */
-				input: {}
+				input: {
+					allowPreventDefault: true,
+					parameters: {
+						/**
+						 * The submitted value.
+						 */
+						value: {
+							type: "string"
+						},
+
+						/**
+						 * Indicator if the value is in correct format pattern and in valid range.
+						 */
+						valid: {
+							type: "boolean"
+						}
+					}
+				}
 			},
 			methods: ["closePicker", "formatValue", "isInValidRange", "isOpen", "isValid", "openPicker"],
 			getters: ["dateValue"]

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

@@ -13,6 +13,7 @@ sap.ui.define([
 ], function(WebComponent, library, coreLibrary) {
 	"use strict";
 
+	var CalendarType = coreLibrary.CalendarType;
 	var ValueState = coreLibrary.ValueState;
 
 	/**
@@ -43,7 +44,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public
@@ -58,6 +59,21 @@ sap.ui.define([
 			tag: "ui5-daterange-picker-ui5",
 			properties: {
 
+				/**
+				 * Defines the aria-label attribute for the component.
+				 */
+				accessibleName: {
+					type: "string"
+				},
+
+				/**
+				 * Receives id(or many ids) of the elements that label the component.
+				 */
+				accessibleNameRef: {
+					type: "string",
+					defaultValue: ""
+				},
+
 				/**
 				 * Determines the symbol which separates the dates. If not supplied, the default time interval delimiter for the current locale will be used.
 				 */
@@ -157,6 +173,14 @@ sap.ui.define([
 					defaultValue: false
 				},
 
+				/**
+				 * Defines the secondary calendar type. If not set, the calendar will only show the primary calendar type.
+				 */
+				secondaryCalendarType: {
+					type: "sap.ui.core.CalendarType",
+					defaultValue: CalendarType.undefined
+				},
+
 				/**
 				 * Defines a formatted date value.
 				 */
@@ -213,15 +237,49 @@ sap.ui.define([
 				/**
 				 * Fired when the input operation has finished by pressing Enter or on focusout.
 				 */
-				change: {},
+				change: {
+					allowPreventDefault: true,
+					parameters: {
+						/**
+						 * The submitted value.
+						 */
+						value: {
+							type: "string"
+						},
+
+						/**
+						 * Indicator if the value is in correct format pattern and in valid range.
+						 */
+						valid: {
+							type: "boolean"
+						}
+					}
+				},
 
 				/**
 				 * Fired when the value of the component is changed at each key stroke.
 				 */
-				input: {}
+				input: {
+					allowPreventDefault: true,
+					parameters: {
+						/**
+						 * The submitted value.
+						 */
+						value: {
+							type: "string"
+						},
+
+						/**
+						 * Indicator if the value is in correct format pattern and in valid range.
+						 */
+						valid: {
+							type: "boolean"
+						}
+					}
+				}
 			},
 			methods: ["closePicker", "formatValue", "isInValidRange", "isOpen", "isValid", "openPicker"],
-			getters: ["dateValue", "firstDateValue", "lastDateValue"]
+			getters: ["dateValue", "endDateValue", "startDateValue"]
 		}
 	});
 
@@ -278,16 +336,16 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Returns the currently selected first date represented as JavaScript Date instance.
+	 * Returns the end date of the currently selected range as JavaScript Date instance.
 	 * @public
-	 * @name sap.ui.webc.main.DateRangePicker#getFirstDateValue
+	 * @name sap.ui.webc.main.DateRangePicker#getEndDateValue
 	 * @function
 	 */
 
 	/**
-	 * Returns the currently selected last date represented as JavaScript Date instance.
+	 * Returns the start date of the currently selected range as JavaScript Date instance.
 	 * @public
-	 * @name sap.ui.webc.main.DateRangePicker#getLastDateValue
+	 * @name sap.ui.webc.main.DateRangePicker#getStartDateValue
 	 * @function
 	 */
 

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

@@ -13,6 +13,7 @@ sap.ui.define([
 ], function(WebComponent, library, coreLibrary) {
 	"use strict";
 
+	var CalendarType = coreLibrary.CalendarType;
 	var ValueState = coreLibrary.ValueState;
 
 	/**
@@ -71,7 +72,7 @@ sap.ui.define([
 	 * The <code>DateTimePicker</code> is responsive and fully adapts to all devices. For larger screens, such as tablet or desktop, it is displayed as a popover, while on phone devices, it is displayed full screen.
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public
@@ -86,6 +87,21 @@ sap.ui.define([
 			tag: "ui5-datetime-picker-ui5",
 			properties: {
 
+				/**
+				 * Defines the aria-label attribute for the component.
+				 */
+				accessibleName: {
+					type: "string"
+				},
+
+				/**
+				 * Receives id(or many ids) of the elements that label the component.
+				 */
+				accessibleNameRef: {
+					type: "string",
+					defaultValue: ""
+				},
+
 				/**
 				 * Determines whether the component is displayed as disabled.
 				 */
@@ -178,6 +194,14 @@ sap.ui.define([
 					defaultValue: false
 				},
 
+				/**
+				 * Defines the secondary calendar type. If not set, the calendar will only show the primary calendar type.
+				 */
+				secondaryCalendarType: {
+					type: "sap.ui.core.CalendarType",
+					defaultValue: CalendarType.undefined
+				},
+
 				/**
 				 * Defines a formatted date value.
 				 */
@@ -234,12 +258,46 @@ sap.ui.define([
 				/**
 				 * Fired when the input operation has finished by pressing Enter or on focusout.
 				 */
-				change: {},
+				change: {
+					allowPreventDefault: true,
+					parameters: {
+						/**
+						 * The submitted value.
+						 */
+						value: {
+							type: "string"
+						},
+
+						/**
+						 * Indicator if the value is in correct format pattern and in valid range.
+						 */
+						valid: {
+							type: "boolean"
+						}
+					}
+				},
 
 				/**
 				 * Fired when the value of the component is changed at each key stroke.
 				 */
-				input: {}
+				input: {
+					allowPreventDefault: true,
+					parameters: {
+						/**
+						 * The submitted value.
+						 */
+						value: {
+							type: "string"
+						},
+
+						/**
+						 * Indicator if the value is in correct format pattern and in valid range.
+						 */
+						valid: {
+							type: "boolean"
+						}
+					}
+				}
 			},
 			methods: ["closePicker", "formatValue", "isInValidRange", "isOpen", "isValid", "openPicker"],
 			getters: ["dateValue"]

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

@@ -33,8 +33,10 @@ sap.ui.define([
 	 *
 	 * <b>Note:</b> We don't recommend nesting popup-like components (<code>sap.ui.webc.main.Dialog</code>, <code>sap.ui.webc.main.Popover</code>) inside <code>sap.ui.webc.main.Dialog</code>. Ideally you should create all popups on the same level inside your HTML page and just open them from one another, rather than nesting them.
 	 *
+	 * <b>Note:</b> We don't recommend nesting popup-like components (<code>sap.ui.webc.main.Dialog</code>, <code>sap.ui.webc.main.Popover</code>) inside other components containing z-index. This might break z-index management.
+	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public
@@ -50,11 +52,7 @@ sap.ui.define([
 			properties: {
 
 				/**
-				 * Defines the accessible name of the dialog when <code>header</code> slot is provided. <br>
-				 * <br>
-				 *
-				 *
-				 * <b>Note:</b> If <code>aria-label</code> is provided, <code>accessibleName</code> will be ignored.
+				 * Sets the accessible aria name of the component.
 				 */
 				accessibleName: {
 					type: "string",
@@ -172,12 +170,16 @@ sap.ui.define([
 				/**
 				 * Fired after the component is closed. <b>This event does not bubble.</b>
 				 */
-				afterClose: {},
+				afterClose: {
+					parameters: {}
+				},
 
 				/**
 				 * Fired after the component is opened. <b>This event does not bubble.</b>
 				 */
-				afterOpen: {},
+				afterOpen: {
+					parameters: {}
+				},
 
 				/**
 				 * Fired before the component is closed. This event can be cancelled, which will prevent the popup from closing. <b>This event does not bubble.</b>
@@ -198,10 +200,11 @@ sap.ui.define([
 				 * Fired before the component is opened. This event can be cancelled, which will prevent the popup from opening. <b>This event does not bubble.</b>
 				 */
 				beforeOpen: {
-					allowPreventDefault: true
+					allowPreventDefault: true,
+					parameters: {}
 				}
 			},
-			methods: ["applyFocus", "close", "isOpen", "open"]
+			methods: ["applyFocus", "close", "isOpen", "show"]
 		}
 	});
 
@@ -227,10 +230,10 @@ sap.ui.define([
 	 */
 
 	/**
-	 * Opens the dialog
+	 * Shows the dialog.
 	 * @param {boolean} preventInitialFocus Prevents applying the focus inside the popup
 	 * @public
-	 * @name sap.ui.webc.main.Dialog#open
+	 * @name sap.ui.webc.main.Dialog#show
 	 * @function
 	 */
 

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

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * And, similar to all input based components, the FileUploader supports "valueState", "placeholder", "name", and "disabled" properties.
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public

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

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * The <code>sap.ui.webc.main.GroupHeaderListItem</code> is a special list item, used only to separate other list items into logical groups.
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public

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

@@ -42,7 +42,7 @@ sap.ui.define([
 	 * <br>
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public

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

@@ -35,7 +35,7 @@ sap.ui.define([
 	 * <b>Note:</b> If you are using the <code>sap.ui.webc.main.Input</code> as a single npm module, don't forget to import the <code>InputSuggestions</code> module from "@ui5/webcomponents/dist/features/InputSuggestions.js" to enable the suggestions functionality.
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public
@@ -54,6 +54,21 @@ sap.ui.define([
 			],
 			properties: {
 
+				/**
+				 * Sets the accessible aria name of the component.
+				 */
+				accessibleName: {
+					type: "string"
+				},
+
+				/**
+				 * Receives id(or many ids) of the elements that label the input
+				 */
+				accessibleNameRef: {
+					type: "string",
+					defaultValue: ""
+				},
+
 				/**
 				 * Defines whether the component is in disabled state. <br>
 				 * <br>
@@ -113,7 +128,7 @@ sap.ui.define([
 				/**
 				 * Defines whether the component should show suggestions, if such are present. <br>
 				 * <br>
-				 * <b>Note:</b> Don`t forget to import the <code>InputSuggestions</code> module from <code>"@ui5/webcomponents/dist/features/InputSuggestions.js"</code> to enable this functionality.
+				 * <b>Note:</b> You need to import the <code>InputSuggestions</code> module from <code>"@ui5/webcomponents/dist/features/InputSuggestions.js"</code> to enable this functionality.
 				 */
 				showSuggestions: {
 					type: "boolean",
@@ -203,12 +218,16 @@ sap.ui.define([
 				/**
 				 * Fired when the input operation has finished by pressing Enter or on focusout.
 				 */
-				change: {},
+				change: {
+					parameters: {}
+				},
 
 				/**
 				 * Fired when the value of the component changes at each keystroke, and when a suggestion item has been selected.
 				 */
-				input: {},
+				input: {
+					parameters: {}
+				},
 
 				/**
 				 * Fired when the user navigates to a suggestion item via the ARROW keys, as a preview, before the final selection.

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

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * The <code>sap.ui.webc.main.Label</code> appearance can be influenced by properties, such as <code>required</code> and <code>wrappingType</code>. The appearance of the Label can be configured in a limited way by using the design property. For a broader choice of designs, you can use custom styles.
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public

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

@@ -39,7 +39,7 @@ sap.ui.define([
 	 * If there is not enough space, the text of the <code>sap.ui.webc.main.Link</code> becomes truncated. If the <code>wrappingType</code> property is set to <code>"Normal"</code>, the text is displayed on several lines instead of being truncated.
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public
@@ -54,6 +54,14 @@ sap.ui.define([
 			tag: "ui5-link-ui5",
 			properties: {
 
+				/**
+				 * Receives id(or many ids) of the elements that label the input
+				 */
+				accessibleNameRef: {
+					type: "string",
+					defaultValue: ""
+				},
+
 				/**
 				 * Defines the component design. <br>
 				 * <br>
@@ -131,7 +139,9 @@ sap.ui.define([
 				/**
 				 * Fired when the component is triggered either with a mouse/tap or by using the Enter key.
 				 */
-				click: {}
+				click: {
+					parameters: {}
+				}
 			}
 		}
 	});

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

@@ -60,7 +60,7 @@ sap.ui.define([
 	 * <br>
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public
@@ -75,6 +75,32 @@ sap.ui.define([
 			tag: "ui5-list-ui5",
 			properties: {
 
+				/**
+				 * Sets the accessible aria name of the component.
+				 */
+				accessibleName: {
+					type: "string",
+					defaultValue: ""
+				},
+
+				/**
+				 * Receives id(or many ids) of the elements that label the input
+				 */
+				accessibleNameRef: {
+					type: "string",
+					defaultValue: ""
+				},
+
+				/**
+				 * Defines the accessible role of the component. <br>
+				 * <br>
+				 * <b>Note:</b> If you use notification list items, it's recommended to set <code>accessible-role="list"</code> for better accessibility.
+				 */
+				accessibleRole: {
+					type: "string",
+					defaultValue: "listbox"
+				},
+
 				/**
 				 * Defines if the component would display a loading indicator over the list.
 				 */
@@ -83,6 +109,14 @@ sap.ui.define([
 					defaultValue: false
 				},
 
+				/**
+				 * Defines the delay in milliseconds, after which the busy indicator will show up for this component.
+				 */
+				busyDelay: {
+					type: "int",
+					defaultValue: 1000
+				},
+
 				/**
 				 * Defines the footer text.
 				 */
@@ -273,7 +307,9 @@ sap.ui.define([
 				 * <br>
 				 * <b>Note:</b> The event is fired when the <code>growing='Scroll'</code> property is enabled.
 				 */
-				loadMore: {},
+				loadMore: {
+					parameters: {}
+				},
 
 				/**
 				 * Fired when selection is changed by user interaction in <code>SingleSelect</code>, <code>SingleSelectBegin</code>, <code>SingleSelectEnd</code> and <code>MultiSelect</code> modes.

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

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * For the <code>sap.ui.webc.main.MessageStrip</code> component, you can define whether it displays an icon in the beginning and a close button. Moreover, its size and background can be controlled with CSS.
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public
@@ -122,7 +122,9 @@ sap.ui.define([
 				/**
 				 * Fired when the close button is pressed either with a click/tap or by using the Enter or Space key.
 				 */
-				close: {}
+				close: {
+					parameters: {}
+				}
 			}
 		}
 	});

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

@@ -65,7 +65,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public
@@ -201,17 +201,23 @@ sap.ui.define([
 				/**
 				 * Fired when the input operation has finished by pressing Enter or on focusout.
 				 */
-				change: {},
+				change: {
+					parameters: {}
+				},
 
 				/**
 				 * Fired when the value of the component changes at each keystroke.
 				 */
-				input: {},
+				input: {
+					parameters: {}
+				},
 
 				/**
 				 * Fired when the dropdown is opened or closed.
 				 */
-				openChange: {},
+				openChange: {
+					parameters: {}
+				},
 
 				/**
 				 * Fired when selection is changed by user interaction in <code>SingleSelect</code> and <code>MultiSelect</code> modes.

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.93.3
+	 * @version 1.96.2
 	 *
 	 * @constructor
 	 * @public