@openui5/sap.m 1.109.0 → 1.111.0

package/src/sap/m/table/columnmenu/Entry.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
@@ -11,40 +11,44 @@ sap.ui.define([
 	"use strict";
 
 	/**
-	 * Constructor for a new Entry.
+	 * Constructor for a new <code>Entry</code>.
 	 *
-	 * @param {string} [sId] ID for the new Entry, generated automatically if no ID is given
-	 * @param {object} [mSettings] Initial settings for the new Entry
+	 * @param {string} [sId] ID for the new <code>Entry</code>, generated automatically if no ID is given
+	 * @param {object} [mSettings] Initial settings for the new <code>Entry</code>
 	 *
 	 * @class
-	 * The Entry serves as a base class for elements residing inside the sap.m.table.columnmenu.Menu.
-	 * This base class is faceless and should be inherited to implement Menu items and quick actions.
+	 * The <code>Entry</code> class is used as a base class for elements residing inside the <code>sap.m.table.columnmenu.Menu</code>.
+	 * This faceless class can be used to specify control- and application-specific menu items and quick actions.
 	 *
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.109.0
+	 * @version 1.111.0
 	 *
-	 * @private
-	 * @experimental
+	 * @public
+	 * @since 1.110
 	 *
 	 * @alias sap.m.table.columnmenu.Entry
 	 */
 	var Entry = Element.extend("sap.m.table.columnmenu.Entry", {
+
 		metadata: {
 			"abstract": true,
 			library: "sap.m",
 			properties: {
+				/**
+				 * Determines whether the entry is visible.
+				 */
 				visible: {type: "boolean", defaultValue: true}
 			}
 		}
 	});
 
 	/**
-	 * This method can be used to retrieve the Menu, in which the entry resides in.
+	 * Retrieves the <code>Menu</code> in which the entry resides.
 	 *
-	 * If an entry is internally creating entries that use #getMenu or #getParent,
-	 * and returns them in #getEffectiveItems or #getEffectiveQuickActions, they
+	 * If an entry is internally creating entries that use {@link #getMenu} or {@link #getParent},
+	 * and returns them in {@link #getEffectiveItems} or {@link #getEffectiveQuickActions}, they
 	 * must be its children in the control tree.
 	 *
 	 * @returns {sap.m.table.columnmenu.Menu} The menu of the entry
@@ -62,7 +66,7 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used to retrieve the label of an entry.
+	 * Retrieves the label of an entry.
 	 *
 	 * @returns {string} The label property specified in the control
 	 * @abstract
@@ -75,7 +79,7 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used to retrieve the content of an entry.
+	 * Retrieves the content of an entry.
 	 *
 	 * @returns {sap.ui.core.Control} The control specified in the content aggregation
 	 * @abstract

package/src/sap/m/table/columnmenu/Item.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
@@ -11,71 +11,73 @@ sap.ui.define([
 	"use strict";
 
 	/**
-	 * Constructor for a new Item.
+	 * Constructor for a new <code>Item</code>.
 	 *
-	 * @param {string} [sId] ID for the new Item, generated automatically if no ID is given
-	 * @param {object} [mSettings] Initial settings for the new Item
+	 * @param {string} [sId] ID for the new <code>Item</code>, generated automatically if no ID is given
+	 * @param {object} [mSettings] Initial settings for the new <code>Item</code>
 	 *
 	 * @class
-	 * This Item serves as a menu item for the sap.m.table.columnmenu.Menu.
-	 * It can be used to specify control- and application-specific items.
+	 * The <code>Item</code> class is used for menu items for the <code>sap.m.table.columnmenu.Menu</code>.
+	 * It can be used to specify control- and application-specific menu items.
 	 *
 	 * @extends sap.m.table.columnmenu.ItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.109.0
+	 * @version 1.111.0
 	 *
-	 * @private
-	 * @experimental
+	 * @public
+	 * @since 1.110
 	 *
 	 * @alias sap.m.table.columnmenu.Item
 	 */
 	var Item = ItemBase.extend("sap.m.table.columnmenu.Item", {
+
 		metadata: {
 			library: "sap.m",
 			properties: {
 				/**
-				 * Defines the label, which should be used for the buttons.
+				 * Defines the label that is used for the item.
 				 */
 				label: {type: "string"},
 				/**
-				 * Defines the icon for the menu item.
+				 * Defines the icon for the item.
 				 */
 				icon: {type: "sap.ui.core.URI"},
 				/**
-				 * Defines whether the reset button should be shown, when navigating to the item.
+				 * Defines whether the Reset button is shown when navigating to the item.
 				 */
 				showResetButton: {type: "boolean", defaultValue: true},
 				/**
-				 * Defines whether the reset button should be enabled, when navigating to the item.
+				 * Defines whether the Reset button is enabled when navigating to the item.
 				 */
 				resetButtonEnabled: {type: "boolean", defaultValue: true},
 				/**
-				 * Defines whether the confirm button should be shown, when navigating to the item.
+				 * Defines whether the Confirm button is shown when navigating to the item.
 				 */
 				showConfirmButton: {type: "boolean", defaultValue: true},
 				/**
-				 * Defines whether the cancel button should be shown, when navigating to the item.
+				 * Defines whether the Cancel button is shown when navigating to the item.
 				 */
 				showCancelButton: {type: "boolean", defaultValue: true}
 			},
+			defaultAggregation : "content",
 			aggregations: {
 				/**
-				 * Defines the content, which should be shown when navigating to the item.
+				 * Defines the content that is shown when navigating to the item.
 				 */
 				content: {type: "sap.ui.core.Control", multiple: false}
 			},
 			events: {
 				/**
-				 * This event will be fired, when the reset button was pressed.
+				 * This event is fired when the Reset button is pressed.
 				 */
 				reset: {},
 				/**
-				 * This event will be fired, when the confirm button was pressed.
+				 * This event is fired when the Confirm button is pressed.
 				 */
 				confirm: {},
 				/**
-				 * This event will be fired, when the cancel button was pressed.
+				 * This event is fired when the Cancel button is pressed.
 				 */
 				cancel: {}
 			}

package/src/sap/m/table/columnmenu/ItemBase.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
@@ -11,26 +11,27 @@ sap.ui.define([
 	"use strict";
 
 	/**
-	 * Constructor for a new ItemBase.
+	 * Constructor for a new <code>ItemBase</code>.
 	 *
-	 * @param {string} [sId] ID for the new ItemBase, generated automatically if no ID is given
-	 * @param {object} [mSettings] Initial settings for the new ItemBase
+	 * @param {string} [sId] ID for the new <code>ItemBase</code>, generated automatically if no ID is given
+	 * @param {object} [mSettings] Initial settings for the new <code>ItemBase</code>
 	 *
 	 * @class
-	 * The ItemBase serves as a base class for menu items for the sap.m.table.columnmenu.Menu.
-	 * This base class is faceless and should be inherited by menu items for the sap.m.table.columnmenu.Menu.
+	 * The <code>ItemBase</code> class is used as a base class for menu items for the <code>sap.m.table.columnmenu.Menu</code>.
+	 * This faceless class can be used to specify control- and application-specific menu items.
 	 *
 	 * @extends sap.m.table.columnmenu.Entry
 	 *
 	 * @author SAP SE
-	 * @version 1.109.0
+	 * @version 1.111.0
 	 *
-	 * @private
-	 * @experimental
+	 * @public
+	 * @since 1.110
 	 *
 	 * @alias sap.m.table.columnmenu.ItemBase
 	 */
 	var ItemBase = Entry.extend("sap.m.table.columnmenu.ItemBase", {
+
 		metadata: {
 			"abstract": true,
 			library: "sap.m"
@@ -46,7 +47,7 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used to retrieve the effective items of the item.
+	 * Retrieves the effective items of the item.
 	 *
 	 * This method allows subclasses to return composition of other items, if they contain multiple items or controls.
 	 * @returns {sap.m.table.columnmenu.ItemBase[]} A composition of effective items
@@ -58,7 +59,7 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used to retrieve the set icon for a item.
+	 * Retrieves the icon specified for an item.
 	 *
 	 * @returns {sap.ui.core.URI} The specified icon
 	 *
@@ -72,9 +73,9 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used as an event handler for a press event.
+	 * Event handler for a press event.
 	 *
-	 * @param {jQuery.Event} oEvent The emitted event
+	 * @param {jQuery.Event} oEvent The event
 	 *
 	 * @protected
 	 */
@@ -82,9 +83,9 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used as an event handler for a back event.
+	 * Event handler for a back event.
 	 *
-	 * @param {jQuery.Event} oEvent The emitted event
+	 * @param {jQuery.Event} oEvent The event
 	 *
 	 * @protected
 	 */
@@ -92,9 +93,9 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used as an event handler for a confirm event.
+	 * Event handler for a confirm event.
 	 *
-	 * @param {jQuery.Event} oEvent The emitted event
+	 * @param {jQuery.Event} oEvent The event
 	 *
 	 * @protected
 	 */
@@ -102,9 +103,9 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used as an event handler for a cancel event.
+	 * Event handler for a cancel event.
 	 *
-	 * @param {jQuery.Event} oEvent The emitted event
+	 * @param {jQuery.Event} oEvent The event
 	 *
 	 * @protected
 	 */
@@ -112,9 +113,9 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used as an event handler for a reset event.
+	 * Event handler for a reset event.
 	 *
-	 * @param {jQuery.Event} oEvent The emitted event
+	 * @param {jQuery.Event} oEvent The event
 	 *
 	 * @protected
 	 */
@@ -122,7 +123,9 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used to retrieve the button settings.
+	 * Retrieves the button settings.
+	 *
+	 * @returns {object} The button settings
 	 *
 	 * @protected
 	 */
@@ -131,7 +134,7 @@ sap.ui.define([
 	};
 
 	/**
-	 * This method can be used to change the button settings of an item.
+	 * Changes the button settings of an item.
 	 *
 	 * @param {object} oButtonSettings Object containing button settings
 	 *

package/src/sap/m/table/columnmenu/ItemContainer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([