@openui5/sap.ui.table 1.139.0 → 1.140.0

package/src/sap/ui/table/plugins/ODataV4SingleSelection.js

@@ -0,0 +1,120 @@
+/*
+ * OpenUI5
+ * (c) Copyright 2025 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([
+	"./ODataV4Selection",
+	"./PluginBase",
+	"../utils/TableUtils",
+	"../library"
+], function(
+	ODataV4Selection,
+	PluginBase,
+	TableUtils,
+	library
+) {
+	"use strict";
+
+	/**
+	 * @class
+	 * Integrates the selection of the {@link sap.ui.model.odata.v4.ODataListBinding} and the table. Works only in combination with a
+	 * {@link sap.ui.model.odata.v4.ODataModel}.
+	 * The selection of multiple contexts is not allowed. Only one context can be selected at a time.
+	 *
+	 * The selection of a context that is not selectable is not allowed.
+	 * The following contexts are not selectable:
+	 * <ul>
+	 *   <li>Header context</li>
+	 *   <li>Contexts that represent group headers</li>
+	 *   <li>Contexts that contain totals</li>
+	 * </ul>
+	 *
+	 * All binding-related limitations also apply in the context of this plugin. For details, see {@link sap.ui.model.odata.v4.Context#setSelected}
+	 * and {@link sap.ui.model.odata.v4.ODataModel#bindList}.
+	 *
+	 * @extends sap.ui.table.plugins.SelectionPlugin
+	 *
+	 * @author SAP SE
+	 * @version 1.140.0
+	 *
+	 * @public
+	 * @since 1.140
+	 * @alias sap.ui.table.plugins.ODataV4SingleSelection
+	 * @see {@link topic:ec55312f796f45e8883810af3b68b46c OData V4: Selection}
+	 *
+	 * @borrows sap.ui.table.plugins.PluginBase.findOn as findOn
+	 */
+	const ODataV4SingleSelection = ODataV4Selection.extend("sap.ui.table.plugins.ODataV4SingleSelection", {
+		metadata: {
+			library: "sap.ui.table"
+		}
+	});
+
+	ODataV4SingleSelection.findOn = PluginBase.findOn;
+
+	/**
+	 * @inheritDoc
+	 */
+	ODataV4SingleSelection.prototype.onActivate = function(oTable) {
+		ODataV4Selection.prototype.onActivate.apply(this, arguments);
+		oTable.setProperty("selectionMode", library.SelectionMode.Single);
+	};
+
+	/**
+	 * @inheritDoc
+	 */
+	ODataV4SingleSelection.prototype.onDeactivate = function(oTable) {
+		ODataV4Selection.prototype.onDeactivate.apply(this, arguments);
+		oTable.setProperty("selectionMode", library.SelectionMode.None);
+	};
+
+	/**
+	 * @inheritDoc
+	 */
+	ODataV4SingleSelection.prototype.setSelected = function(oRow, bSelected, mConfig) {
+		const oContext = TableUtils.getBindingContextOfRow(oRow);
+
+		if (!this.isActive() || !oContext || !this.isContextSelectable(oContext) || this.isSelected(oRow) === bSelected) {
+			return;
+		}
+
+		if (bSelected) {
+			this.clearSelection();
+		}
+
+		oContext.setSelected(bSelected);
+	};
+
+	/**
+	 * @inheritDoc
+	 */
+	ODataV4SingleSelection.prototype.validateSelection = function(aContextsToValidate) {
+		ODataV4Selection.prototype.validateSelection.apply(this, arguments);
+
+		if (this.getSelectedCount() > 1) {
+			throw new Error("Multiple contexts selected");
+		}
+	};
+
+	/**
+	 * Returns the selected context.
+	 *
+	 * @returns {sap.ui.model.odata.v4.Context} The selected context
+	 * @public
+	 */
+	ODataV4SingleSelection.prototype.getSelectedContext = function() {
+		return this.getSelectedContexts()[0];
+	};
+
+	/**
+	 * Clears the selection.
+	 *
+	 * @public
+	 * @name sap.ui.table.plugins.ODataV4SingleSelection#clearSelection
+	 * @function
+	 */
+	// Inherited from ODataV4Selection
+
+	return ODataV4SingleSelection;
+});

package/src/sap/ui/table/plugins/PluginBase.js

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 *
 	 * @private
 	 * @experimental Since 1.75

package/src/sap/ui/table/plugins/SelectionModelSelection.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @extends sap.ui.table.plugins.SelectionPlugin
 	 *
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 *
 	 * @private
 	 * @alias sap.ui.table.plugins.SelectionModelSelection

package/src/sap/ui/table/plugins/SelectionPlugin.js

@@ -21,7 +21,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 *
 	 * @public
 	 * @since 1.64
@@ -29,22 +29,24 @@ sap.ui.define([
 	 *
 	 * @borrows sap.ui.table.plugins.PluginBase.findOn as findOn
 	 */
-	const SelectionPlugin = PluginBase.extend("sap.ui.table.plugins.SelectionPlugin", {metadata: {
-		"abstract": true,
-		library: "sap.ui.table",
-		properties: {
-			/**
-			 * Indicates whether this plugin is enabled.
-			 */
-			enabled: {type: "boolean", defaultValue: true} // TODO: Inherited from private PluginBase. Remove once PluginBase is public.
-		},
-		events: {
-			/**
-			 * This event is fired when the selection is changed.
-			 */
-			selectionChange: {}
+	const SelectionPlugin = PluginBase.extend("sap.ui.table.plugins.SelectionPlugin", {
+		metadata: {
+			"abstract": true,
+			library: "sap.ui.table",
+			properties: {
+				/**
+				 * Indicates whether this plugin is enabled.
+				 */
+				enabled: {type: "boolean", defaultValue: true} // TODO: Inherited from private PluginBase. Remove once PluginBase is public.
+			},
+			events: {
+				/**
+				 * This event is fired when the selection is changed.
+				 */
+				selectionChange: {}
+			}
 		}
-    }});
+	});
 
 	SelectionPlugin.findOn = PluginBase.findOn;
 

package/src/sap/ui/table/rowmodes/Auto.js

@@ -38,7 +38,7 @@ sap.ui.define([
 	 * @public
 	 *
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 */
 	const AutoRowMode = RowMode.extend("sap.ui.table.rowmodes.Auto", /** @lends sap.ui.table.rowmodes.Auto.prototype */ {
 		metadata: {

package/src/sap/ui/table/rowmodes/Fixed.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @public
 	 *
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 */
 	const FixedRowMode = RowMode.extend("sap.ui.table.rowmodes.Fixed", /** @lends sap.ui.table.rowmodes.Fixed.prototype */ {
 		metadata: {

package/src/sap/ui/table/rowmodes/Interactive.js

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * @public
 	 *
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 */
 	const InteractiveRowMode = RowMode.extend("sap.ui.table.rowmodes.Interactive", /** @lends sap.ui.table.rowmodes.Interactive.prototype */ {
 		metadata: {

package/src/sap/ui/table/rowmodes/RowMode.js

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * @public
 	 *
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 */
 	const RowMode = Element.extend("sap.ui.table.rowmodes.RowMode", /** @lends sap.ui.table.rowmodes.RowMode.prototype */ {
 		metadata: {

package/src/sap/ui/table/rowmodes/Variable.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @extends sap.ui.table.rowmodes.RowMode
 	 *
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/table/utils/TableUtils.js

@@ -208,7 +208,7 @@ sap.ui.define([
 	 * Static collection of utility functions related to the sap.ui.table.Table, ...
 	 *
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @namespace
 	 * @alias sap.ui.table.utils.TableUtils
 	 * @private

package/src/sap/ui/table/utils/_ColumnUtils.js

@@ -18,7 +18,7 @@ sap.ui.define([
 	 * Note: Do not access the functions of this helper directly, but via <code>sap.ui.table.utils.TableUtils.Column...</code>
 	 *
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @namespace
 	 * @alias sap.ui.table.utils._ColumnUtils
 	 * @private

package/src/sap/ui/table/utils/_GroupingUtils.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * Note: Do not access the functions of this helper directly, but via <code>sap.ui.table.utils.TableUtils.Grouping...</code>
 	 *
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @namespace
 	 * @alias sap.ui.table.utils._GroupingUtils
 	 * @private

package/src/sap/ui/table/utils/_HookUtils.js

@@ -21,7 +21,7 @@ sap.ui.define(["sap/ui/base/DataType", "sap/ui/model/ChangeReason"], function(Da
 	 * - There is no concept for public or protected hooks. Never expose a hook directly, only indirectly as can be seen in the examples.
 	 *
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @namespace
 	 * @alias sap.ui.table.utils._HookUtils
 	 *

package/src/sap/ui/table/utils/_MenuUtils.js

@@ -14,7 +14,7 @@ sap.ui.define([], function() {
 	 * Note: Do not access the functions of this helper directly, but via <code>sap.ui.table.utils.TableUtils.Menu...</code>
 	 *
 	 * @author SAP SE
-	 * @version 1.139.0
+	 * @version 1.140.0
 	 * @namespace
 	 * @alias sap.ui.table.utils._MenuUtils
 	 * @private

package/src/sap/ui/table/plugins/SelectionMode.js

@@ -1,35 +0,0 @@
-/*!
- * OpenUI5
- * (c) Copyright 2025 SAP SE or an SAP affiliate company.
- * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
- */
-sap.ui.define(["sap/ui/base/DataType"], (DataType) => {
-	"use strict";
-
-	/**
-	 * Mode of a selection plugin.
-	 *
-	 * @enum {string}
-	 * @alias sap.ui.table.plugins.SelectionMode
-	 * @private
-	 */
-	const SelectionMode = {
-		/**
-		 * Only one row can be selected at a time.
-		 *
-		 * @public
-		 */
-		Single: "Single",
-
-		/**
-		 * Multiple rows can be selected.
-		 *
-		 * @public
-		 */
-		MultiToggle: "MultiToggle"
-	};
-
-	DataType.registerEnum("sap.ui.table.plugins.SelectionMode", SelectionMode);
-
-	return SelectionMode;
-});