@openui5/sap.ui.webc.fiori 1.94.0 → 1.97.0

package/src/sap/ui/webc/fiori/NotificationListGroupItem.js

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * <ul>
 	 *     <li><code>Toggle</code> button to expand and collapse the group</li>
 	 *     <li><code>Priority</code> icon to display the priority of the group</li>
-	 *     <li><code>Heading</code> to entitle the group</li>
+	 *     <li><code>TitleText</code> to entitle the group</li>
 	 *     <li>Custom actions - with the use of <code>sap.ui.webc.fiori.NotificationAction</code></li>
 	 *     <li>Items of the group</li>
 	 * </ul>
@@ -43,11 +43,11 @@ sap.ui.define([
 	 * <ui5-link target="_blank" href="https://developer.mozilla.org/en-US/docs/Web/CSS/::part">CSS Shadow Parts</ui5-link> allow developers to style elements inside the Shadow DOM. <br>
 	 * The <code>sap.ui.webc.fiori.NotificationListGroupItem</code> exposes the following CSS Shadow Parts:
 	 * <ul>
-	 *     <li>heading - Used to style the heading of the notification list group item</li>
+	 *     <li>title-text - Used to style the titleText of the notification list group item</li>
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public
@@ -75,19 +75,19 @@ sap.ui.define([
 				},
 
 				/**
-				 * Defines if the group is collapsed or expanded.
+				 * Defines the delay in milliseconds, after which the busy indicator will show up for this component.
 				 */
-				collapsed: {
-					type: "boolean",
-					defaultValue: false
+				busyDelay: {
+					type: "int",
+					defaultValue: 1000
 				},
 
 				/**
-				 * Defines the <code>heading</code> of the item.
+				 * Defines if the group is collapsed or expanded.
 				 */
-				heading: {
-					type: "string",
-					defaultValue: ""
+				collapsed: {
+					type: "boolean",
+					defaultValue: false
 				},
 
 				/**
@@ -107,7 +107,7 @@ sap.ui.define([
 				/**
 				 * Defines if the <code>notification</code> is new or has been already read. <br>
 				 * <br>
-				 * <b>Note:</b> if set to <code>false</code> the <code>heading</code> has bold font, if set to true - it has a normal font.
+				 * <b>Note:</b> if set to <code>false</code> the <code>titleText</code> has bold font, if set to true - it has a normal font.
 				 */
 				read: {
 					type: "boolean",
@@ -128,6 +128,14 @@ sap.ui.define([
 				showCounter: {
 					type: "boolean",
 					defaultValue: false
+				},
+
+				/**
+				 * Defines the <code>titleText</code> of the item.
+				 */
+				titleText: {
+					type: "string",
+					defaultValue: ""
 				}
 			},
 			defaultAggregation: "items",
@@ -157,12 +165,16 @@ sap.ui.define([
 				/**
 				 * Fired when the <code>Close</code> button is pressed.
 				 */
-				close: {},
+				close: {
+					parameters: {}
+				},
 
 				/**
 				 * Fired when the <code>sap.ui.webc.fiori.NotificationListGroupItem</code> is expanded/collapsed by user interaction.
 				 */
-				toggle: {}
+				toggle: {
+					parameters: {}
+				}
 			}
 		}
 	});

package/src/sap/ui/webc/fiori/NotificationListItem.js

@@ -14,6 +14,7 @@ sap.ui.define([
 	"use strict";
 
 	var Priority = mainLibrary.Priority;
+	var WrappingType = mainLibrary.WrappingType;
 
 	/**
 	 * Constructor for a new <code>NotificationListItem</code>.
@@ -27,13 +28,13 @@ sap.ui.define([
 	 * <h3>Overview</h3> The <code>sap.ui.webc.fiori.NotificationListItem</code> is a type of list item, meant to display notifications. <br>
 	 *
 	 *
-	 * The component has a rich set of various properties that allows the user to set <code>avatar</code>, <code>heading</code>, descriptive <code>content</code> and <code>footnotes</code> to fully describe a notification. <br>
+	 * The component has a rich set of various properties that allows the user to set <code>avatar</code>, <code>titleText</code>, descriptive <code>content</code> and <code>footnotes</code> to fully describe a notification. <br>
 	 *
 	 *
 	 * The user can:
 	 * <ul>
 	 *     <li>display a <code>Close</code> button</li>
-	 *     <li>can control whether the <code>heading</code> and <code>description</code> should wrap or truncate and display a <code>ShowMore</code> button to switch between less and more information</li>
+	 *     <li>can control whether the <code>titleText</code> and <code>description</code> should wrap or truncate and display a <code>ShowMore</code> button to switch between less and more information</li>
 	 *     <li>add custom actions by using the <code>sap.ui.webc.fiori.NotificationAction</code> component</li>
 	 * </ul>
 	 *
@@ -44,11 +45,11 @@ sap.ui.define([
 	 * <ui5-link target="_blank" href="https://developer.mozilla.org/en-US/docs/Web/CSS/::part">CSS Shadow Parts</ui5-link> allow developers to style elements inside the Shadow DOM. <br>
 	 * The <code>sap.ui.webc.fiori.NotificationListItem</code> exposes the following CSS Shadow Parts:
 	 * <ul>
-	 *     <li>heading - Used to style the heading of the notification list item</li>
+	 *     <li>title-text - Used to style the titleText of the notification list item</li>
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public
@@ -77,20 +78,20 @@ sap.ui.define([
 				},
 
 				/**
-				 * Defines the content of the control
+				 * Defines the delay in milliseconds, after which the busy indicator will show up for this component.
 				 */
-				description: {
-					type: "string",
-					defaultValue: "",
-					mapping: "textContent"
+				busyDelay: {
+					type: "int",
+					defaultValue: 1000
 				},
 
 				/**
-				 * Defines the <code>heading</code> of the item.
+				 * Defines the content of the control
 				 */
-				heading: {
+				description: {
 					type: "string",
-					defaultValue: ""
+					defaultValue: "",
+					mapping: "textContent"
 				},
 
 				/**
@@ -110,7 +111,7 @@ sap.ui.define([
 				/**
 				 * Defines if the <code>notification</code> is new or has been already read. <br>
 				 * <br>
-				 * <b>Note:</b> if set to <code>false</code> the <code>heading</code> has bold font, if set to true - it has a normal font.
+				 * <b>Note:</b> if set to <code>false</code> the <code>titleText</code> has bold font, if set to true - it has a normal font.
 				 */
 				read: {
 					type: "boolean",
@@ -126,15 +127,23 @@ sap.ui.define([
 				},
 
 				/**
-				 * Defines if the <code>heading</code> and <code>description</code> should wrap, they truncate by default.
+				 * Defines the <code>titleText</code> of the item.
+				 */
+				titleText: {
+					type: "string",
+					defaultValue: ""
+				},
+
+				/**
+				 * Defines if the <code>titleText</code> and <code>description</code> should wrap, they truncate by default.
 				 *
 				 * <br>
 				 * <br>
-				 * <b>Note:</b> by default the <code>heading</code> and <code>decription</code>, and a <code>ShowMore/Less</code> button would be displayed.
+				 * <b>Note:</b> by default the <code>titleText</code> and <code>decription</code>, and a <code>ShowMore/Less</code> button would be displayed.
 				 */
-				wrap: {
-					type: "boolean",
-					defaultValue: false
+				wrappingType: {
+					type: "sap.ui.webc.main.WrappingType",
+					defaultValue: WrappingType.None
 				}
 			},
 			aggregations: {
@@ -165,7 +174,7 @@ sap.ui.define([
 				},
 
 				/**
-				 * Defines the elements, dipalyed in the footer of the of the <code>sap.ui.webc.fiori.NotificationListItem</code>.
+				 * Defines the elements, displayed in the footer of the of the component.
 				 */
 				footnotes: {
 					type: "sap.ui.core.Control",
@@ -178,7 +187,9 @@ sap.ui.define([
 				/**
 				 * Fired when the <code>Close</code> button is pressed.
 				 */
-				close: {}
+				close: {
+					parameters: {}
+				}
 			}
 		}
 	});

package/src/sap/ui/webc/fiori/Page.js

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * <b>Note:</b> <code>sap.ui.webc.fiori.Page</code> occipues the whole available space of its parent. In order to achieve the intended design you have to make sure that there is enough space for the <code>sap.ui.webc.fiori.Page</code> to be rendered.
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/webc/fiori/ProductSwitch.js

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * <br>
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/webc/fiori/ProductSwitchItem.js

@@ -34,7 +34,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public
@@ -112,7 +112,9 @@ sap.ui.define([
 				/**
 				 * Fired when the <code>sap.ui.webc.fiori.ProductSwitchItem</code> is activated either with a click/tap or by using the Enter or Space key.
 				 */
-				click: {}
+				click: {
+					parameters: {}
+				}
 			}
 		}
 	});

package/src/sap/ui/webc/fiori/ShellBar.js

@@ -55,7 +55,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/webc/fiori/ShellBarItem.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 *
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/webc/fiori/SideNavigation.js

@@ -35,7 +35,7 @@ sap.ui.define([
 	 * Use the available <code>sap.ui.webc.fiori.SideNavigationItem</code> and <code>sap.ui.webc.fiori.SideNavigationSubItem</code> components to build your menu. The items can consist of text only or an icon with text. The use or non-use of icons must be consistent for all items on one level. You must not combine entries with and without icons on the same level. We strongly recommend that you do not use icons on the second level.
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/webc/fiori/SideNavigationItem.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * The <code>sap.ui.webc.fiori.SideNavigationItem</code> is used within <code>sap.ui.webc.fiori.SideNavigation</code> only. Via the <code>sap.ui.webc.fiori.SideNavigationItem</code> you control the content of the <code>SideNavigation</code>.
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/webc/fiori/SideNavigationSubItem.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * The <code>sap.ui.webc.fiori.SideNavigationSubItem</code> is intended to be used inside a <code>sap.ui.webc.fiori.SideNavigationItem</code> only.
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/webc/fiori/SortItem.js

@@ -0,0 +1,68 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides control sap.ui.webc.fiori.SortItem.
+sap.ui.define([
+	"sap/ui/webc/common/WebComponent",
+	"./library",
+	"./thirdparty/SortItem"
+], function(WebComponent, library) {
+	"use strict";
+
+	/**
+	 * Constructor for a new <code>SortItem</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>
+	 *
+	 * <h3>Usage</h3>
+	 *
+	 * @author SAP SE
+	 * @version 1.97.0
+	 *
+	 * @constructor
+	 * @public
+	 * @since 1.97.0
+	 * @experimental Since 1.97.0 This control is experimental and its API might change significantly.
+	 * @alias sap.ui.webc.fiori.SortItem
+	 * @implements sap.ui.webc.fiori.ISortItem
+	 * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
+	 */
+	var SortItem = WebComponent.extend("sap.ui.webc.fiori.SortItem", {
+		metadata: {
+			library: "sap.ui.webc.fiori",
+			tag: "ui5-sort-item-ui5",
+			interfaces: [
+				"sap.ui.webc.fiori.ISortItem"
+			],
+			properties: {
+
+				/**
+				 * Defines if the component is selected.
+				 */
+				selected: {
+					type: "boolean",
+					defaultValue: false
+				},
+
+				/**
+				 * Defines the text of the component.
+				 */
+				text: {
+					type: "string",
+					defaultValue: ""
+				}
+			}
+		}
+	});
+
+	return SortItem;
+});

package/src/sap/ui/webc/fiori/Timeline.js

@@ -12,6 +12,8 @@ sap.ui.define([
 ], function(WebComponent, library) {
 	"use strict";
 
+	var TimelineLayout = library.TimelineLayout;
+
 	/**
 	 * Constructor for a new <code>Timeline</code>.
 	 *
@@ -26,7 +28,7 @@ sap.ui.define([
 	 * The <code>sap.ui.webc.fiori.Timeline</code> component shows entries (such as objects, events, or posts) in chronological order. A common use case is to provide information about changes to an object, or events related to an object. These entries can be generated by the system (for example, value XY changed from A to B), or added manually. There are two distinct variants of the timeline: basic and social. The basic timeline is read-only, while the social timeline offers a high level of interaction and collaboration, and is integrated within SAP Jam.
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public
@@ -50,6 +52,22 @@ sap.ui.define([
 					mapping: "style"
 				},
 
+				/**
+				 * Defines the items orientation.
+				 *
+				 * <br>
+				 * <br>
+				 * <b>Note:</b> Available options are:
+				 * <ul>
+				 *     <li><code>Vertical</code></li>
+				 *     <li><code>Horizontal</code></li>
+				 * </ul>
+				 */
+				layout: {
+					type: "sap.ui.webc.fiori.TimelineLayout",
+					defaultValue: TimelineLayout.Vertical
+				},
+
 				/**
 				 * Defines the width of the control
 				 */

package/src/sap/ui/webc/fiori/TimelineItem.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * An entry posted on the timeline.
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public
@@ -58,17 +58,17 @@ sap.ui.define([
 				},
 
 				/**
-				 * Defines the name of the item.
+				 * Defines the name of the item, displayed before the <code>title-text</code>.
 				 */
-				itemName: {
+				name: {
 					type: "string",
 					defaultValue: ""
 				},
 
 				/**
-				 * Defines whether the <code>itemName</code> is clickable.
+				 * Defines if the <code>name</code> is clickable.
 				 */
-				itemNameClickable: {
+				nameClickable: {
 					type: "boolean",
 					defaultValue: false
 				},
@@ -105,9 +105,11 @@ sap.ui.define([
 				/**
 				 * Fired when the item name is pressed either with a click/tap or by using the Enter or Space key. <br>
 				 * <br>
-				 * <b>Note:</b> The event will not be fired if the <code>item-name-clickable</code> attribute is not set.
+				 * <b>Note:</b> The event will not be fired if the <code>name-clickable</code> attribute is not set.
 				 */
-				itemNameClick: {}
+				nameClick: {
+					parameters: {}
+				}
 			}
 		}
 	});

package/src/sap/ui/webc/fiori/UploadCollection.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * <h3>Overview</h3> This component allows you to represent files before uploading them to a server, with the help of <code>sap.ui.webc.fiori.UploadCollectionItem</code>. It also allows you to show already uploaded files.
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public
@@ -42,6 +42,14 @@ sap.ui.define([
 			tag: "ui5-upload-collection-ui5",
 			properties: {
 
+				/**
+				 * Sets the accessible aria name of the component.
+				 */
+				accessibleName: {
+					type: "string",
+					defaultValue: ""
+				},
+
 				/**
 				 * Defines the height of the control
 				 */
@@ -108,7 +116,9 @@ sap.ui.define([
 			aggregations: {
 
 				/**
-				 * Defines the <code>sap.ui.webc.fiori.UploadCollection</code> header.
+				 * Defines the <code>sap.ui.webc.fiori.UploadCollection</code> header. <br>
+				 * <br>
+				 * <b>Note:</b> If <code>header</code> slot is provided, the labelling of the <code>UploadCollection</code> is a responsibility of the application developer. <code>accessibleName</code> should be used.
 				 */
 				header: {
 					type: "sap.ui.core.Control",
@@ -148,7 +158,7 @@ sap.ui.define([
 				 * <br>
 				 * <b>Note:</b> A Delete button is displayed on each item, when the <code>sap.ui.webc.fiori.UploadCollection</code> <code>mode</code> property is set to <code>Delete</code>.
 				 */
-				fileDeleted: {
+				itemDelete: {
 					parameters: {
 						/**
 						 * The <code>sap.ui.webc.fiori.UploadCollectionItem</code> which was renamed.

package/src/sap/ui/webc/fiori/UploadCollectionItem.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * <h3>Overview</h3> A component to be used within the <code>sap.ui.webc.fiori.UploadCollection</code>.
 	 *
 	 * @author SAP SE
-	 * @version 1.94.0
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @public
@@ -46,7 +46,15 @@ sap.ui.define([
 			properties: {
 
 				/**
-				 * Holds <code>File</code>, associated with this item.
+				 * Disables the delete button.
+				 */
+				disableDeleteButton: {
+					type: "boolean",
+					defaultValue: false
+				},
+
+				/**
+				 * Holds an instance of <code>File</code> associated with this item.
 				 */
 				file: {
 					type: "object",
@@ -69,18 +77,10 @@ sap.ui.define([
 					defaultValue: false
 				},
 
-				/**
-				 * Removes delete option from <code>sap.ui.webc.fiori.UploadCollection</code> with <code>mode</code> <code>Delete</code> for this item.
-				 */
-				noDelete: {
-					type: "boolean",
-					defaultValue: false
-				},
-
 				/**
 				 * Hides the retry button when <code>uploadState</code> property is <code>Error</code>.
 				 */
-				noRetry: {
+				hideRetryButton: {
 					type: "boolean",
 					defaultValue: false
 				},
@@ -88,7 +88,7 @@ sap.ui.define([
 				/**
 				 * Hides the terminate button when <code>uploadState</code> property is <code>Uploading</code>.
 				 */
-				noTerminate: {
+				hideTerminateButton: {
 					type: "boolean",
 					defaultValue: false
 				},
@@ -140,28 +140,36 @@ sap.ui.define([
 				 * <br>
 				 * <b>Note:</b> This event is only available when <code>fileNameClickable</code> property is <code>true</code>.
 				 */
-				fileNameClick: {},
+				fileNameClick: {
+					parameters: {}
+				},
 
 				/**
 				 * Fired when the <code>fileName</code> property gets changed. <br>
 				 * <br>
 				 * <b>Note:</b> An edit button is displayed on each item, when the <code>sap.ui.webc.fiori.UploadCollectionItem</code> <code>type</code> property is set to <code>Detail</code>.
 				 */
-				rename: {},
+				rename: {
+					parameters: {}
+				},
 
 				/**
 				 * Fired when the retry button is pressed. <br>
 				 * <br>
 				 * <b>Note:</b> Retry button is displayed when <code>uploadState</code> property is set to <code>Error</code>.
 				 */
-				retry: {},
+				retry: {
+					parameters: {}
+				},
 
 				/**
 				 * Fired when the terminate button is pressed. <br>
 				 * <br>
 				 * <b>Note:</b> Terminate button is displayed when <code>uploadState</code> property is set to <code>Uploading</code>.
 				 */
-				terminate: {}
+				terminate: {
+					parameters: {}
+				}
 			}
 		}
 	});