@openui5/sap.m 1.109.0 → 1.111.0

package/src/sap/m/plugins/CellSelector.js

@@ -1,15 +1,15 @@
 /*!
  * 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([
 	"./PluginBase",
 	"sap/ui/events/KeyCodes",
 	"sap/ui/core/Core",
-	"sap/ui/thirdparty/jquery",
+	"sap/ui/core/Element",
 	"sap/base/Log"
-], function (PluginBase, KeyCodes, Core, jQuery, Log) {
+], function (PluginBase, KeyCodes, Core, Element, Log) {
 	"use strict";
 
 	var SELECTION_DIRECTION = {
@@ -53,7 +53,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.m.plugins.PluginBase
 	 * @class
-	 * @version 1.109.0
+	 * @version 1.111.0
 	 * @author SAP SE
 	 *
 	 * @private
@@ -62,7 +62,22 @@ sap.ui.define([
 	var CellSelector = PluginBase.extend("sap.m.plugins.CellSelector", {
 		metadata: {
 			library: "sap.m",
-			properties: {},
+			properties: {
+				/**
+				 * For the {@link sap.ui.table.Table} control, defines the number of row contexts that needs to be retrived from the binding
+				 * when the range selection (e.g. enhancing the cell selection block to cover all rows of a column) is triggered by the user.
+				 * This helps to make the contexts already available for the user actions after the cell selection (e.g. copy to clipboard).
+				 * This property accepts positive integer values.
+				 * <b>Note:</b> To avoid performance problems, the <code>rangeLimit</code> should only be set higher than the default value of 200 in the following cases:
+				 * <ul>
+				 *     <li>With client-side models</li>
+				 *     <li>With server-side models if they are used in client mode</li>
+				 *     <li>If the entity set is small</li>
+				 * </ul>
+				 * In other cases, it is recommended to set the <code>rangeLimit</code> to at least double the value of the {@link sap.ui.table.Table#getThreshold threshold} property.
+				 */
+				rangeLimit: {type: "int", group: "Behavior", defaultValue: 200}
+			},
 			events: {}
 		}
 	});
@@ -114,34 +129,48 @@ sap.ui.define([
 	};
 
 	/**
-	 * Retrieve the cells for the current selection.
+	 * Returns the cell selection range.
+	 * The value <code>Infinity</code> in <code>rowIndex</code> meant for until the limit is reached.
 	 *
 	 * Note: This method is subject to change.
-	 * @returns {Object} contains the selected cells in each selected row
+	 * @returns {{from: {rowIndex: int, colIndex: int}, to: {rowIndex: int, colIndex: int}}  The range of the selection
 	 * @private
-	 * @experimental Since 1.104
+	 * @experimental Since 1.110
+	 * @ui5-restricted sap.m.plugins.CopyProvider
 	 */
-	CellSelector.prototype.getSelectedCells = function () {
+	CellSelector.prototype.getSelectionRange = function () {
 		if (!this._bSelecting) {
-			return {};
+			return null;
 		}
-		var oNormalizedBounds = getNormalizedBounds(this._oSession.mSource, this._oSession.mTarget);
-
-		var oSelection = {};
-		for (var iRow = oNormalizedBounds.from.rowIndex; iRow < oNormalizedBounds.to.rowIndex; iRow++) {
-			var oRowContext = this.getConfig("contextByIndex", this.getControl(), iRow), aColumns = [];
-			for (var iCol = oNormalizedBounds.from.colIndex; iCol < oNormalizedBounds.to.colIndex; iCol++) {
-				var oColumn = this.getConfig("columnByIndex", this.getControl(), iCol);
-				if (oColumn) {
-					aColumns.push(iCol);
-				}
-			}
-			oSelection[iRow] = {
-				rowContext: oRowContext,
-				columnIndices: aColumns
-			};
+
+		var mSelectionRange = getNormalizedBounds(this._oSession.mSource, this._oSession.mTarget);
+		if (isNaN(mSelectionRange.from.rowIndex) || isNaN(mSelectionRange.to.rowIndex)) {
+			return null;
+		}
+
+		var iMaxColumnIndex = this.getConfig("getVisibleColumns", this.getControl()).length - 1;
+		mSelectionRange.from.colIndex = Math.max(mSelectionRange.from.colIndex, 0);
+		mSelectionRange.to.colIndex = Math.min(mSelectionRange.to.colIndex, iMaxColumnIndex);
+		mSelectionRange.from.rowIndex = Math.max(mSelectionRange.from.rowIndex, 0);
+		return mSelectionRange;
+	};
+
+	/**
+	 * Returns the row binding context of the current selection.
+	 *
+	 * Note: This method is subject to change.
+	 * @returns {sap.ui.model.Context[]} The binding context of selected rows
+	 * @private
+	 * @experimental Since 1.110
+	 * @ui5-restricted sap.m.plugins.CopyProvider
+	 */
+	CellSelector.prototype.getSelectedRowContexts = function () {
+		var mSelectionRange = this.getSelectionRange();
+		if (!mSelectionRange) {
+			return [];
 		}
-		return oSelection;
+
+		return this.getConfig("rowContexts", this.getControl(), mSelectionRange.from.rowIndex, mSelectionRange.to.rowIndex, this.getRangeLimit());
 	};
 
 	CellSelector.prototype.onsapspace = function (oEvent) {
@@ -264,19 +293,12 @@ sap.ui.define([
 			// CTRL+SHIFT+A: Clear Selection
 			if (isKeyCombination(oEvent, KeyCodes.A, true, true)) {
 				this.clearSelection();
+				oEvent.preventDefault();
+				oEvent.setMarked();
 			}
-			oEvent.preventDefault();
-			oEvent.setMarked();
 		}
 	};
 
-	CellSelector.prototype.onkeyup = function (oEvent) {
-		if (!this._bSelecting) {
-			return;
-		}
-		oEvent.setMarked();
-	};
-
 	// Mouse Navigation
 
 	CellSelector.prototype.ontouchstart = function (oEvent) {
@@ -552,6 +574,10 @@ sap.ui.define([
 			return;
 		}
 
+		if (mBounds.to.rowIndex == Infinity) {
+			this.getConfig("loadContexts", this.getControl(), mBounds.from.rowIndex, this.getRangeLimit());
+		}
+
 		var oBorderOptions = this._getBorderOptions(mBounds, mDrawableBounds);
 		this._oSession.aCells = oSelection.cells;
 		this._drawSelection(mDrawableBounds, oBorderOptions);
@@ -894,6 +920,16 @@ sap.ui.define([
 				});
 				oSelectionPlugin.detachEvent(sEvent, oPlugin.clearSelection, oPlugin);
 			},
+			/**
+			 * Get visible columns of the table.
+			 * @param {sap.ui.table.Table} oTable table instance
+			 * @returns {sap.ui.table.Column[]} array of visible columns
+			 */
+			getVisibleColumns: function (oTable) {
+				return oTable.getColumns().filter(function (oColumn) {
+					return oColumn.getDomRef();
+				});
+			},
 			/**
 			 * Checks if the selection is enabled for the control.
 			 * @param {sap.ui.core.Control} oControl control instance
@@ -913,7 +949,7 @@ sap.ui.define([
 			getCellRef: function (oTable, mPosition) {
 				var oRow = this._getRowByIndex(oTable, mPosition.rowIndex);
 				if (oRow) {
-					var oColumn = this._getColumns(oTable)[mPosition.colIndex];
+					var oColumn = this.getVisibleColumns(oTable)[mPosition.colIndex];
 					var oCell = oColumn && oRow.getCells()[mPosition.colIndex];
 					if (oCell) {
 						return oCell.$().closest(this.selectableCells)[0];
@@ -941,7 +977,7 @@ sap.ui.define([
 				var aRows = oTable.getRows();
 				return {
 					from: {rowIndex: aRows[0].getIndex(), colIndex: 0},
-					to: {rowIndex: aRows[aRows.length - 1].getIndex(), colIndex: this._getColumns(oTable).length - 1}
+					to: {rowIndex: aRows[aRows.length - 1].getIndex(), colIndex: this.getVisibleColumns(oTable).length - 1}
 				};
 			},
 			/**
@@ -989,19 +1025,19 @@ sap.ui.define([
 				mBounds.from.colIndex = Math.max(mBounds.from.colIndex, 0);
 
 				mBounds.to.rowIndex = Math.min(mBounds.to.rowIndex, iBindingLength);
-				mBounds.to.colIndex = Math.min(mBounds.to.colIndex, this._getColumns(oTable).length - 1);
+				mBounds.to.colIndex = Math.min(mBounds.to.colIndex, this.getVisibleColumns(oTable).length - 1);
 
 				var aCells = [];
 
 				// Replace MIN/MAX with according number for focus object
 				if (oOptions && oOptions.info) {
 					oOptions.info.focus.rowIndex = Math.min(Math.max(oOptions.info.focus.rowIndex, 0), iBindingLength);
-					oOptions.info.focus.colIndex = Math.min(Math.max(oOptions.info.focus.colIndex, 0), this._getColumns(oTable).length - 1);
+					oOptions.info.focus.colIndex = Math.min(Math.max(oOptions.info.focus.colIndex, 0), this.getVisibleColumns(oTable).length - 1);
 					this._focusCell(oTable, oOptions.info.focus, oOptions.info.direction);
 				}
 
 				// If table is in Single Selection Mode, only select the row with focus in it
-				if (mBounds.from.colIndex === 0 && mBounds.to.colIndex === (this._getColumns(oTable).length - 1) && oTable.getSelectionMode() == "Single") {
+				if (mBounds.from.colIndex === 0 && mBounds.to.colIndex === (this.getVisibleColumns(oTable).length - 1) && oTable.getSelectionMode() == "Single") {
 					mBounds.from.rowIndex = mSelectionBounds.from.rowIndex = oOptions.info.focus.rowIndex;
 					mBounds.to.rowIndex = mSelectionBounds.to.rowIndex = oOptions.info.focus.rowIndex;
 				}
@@ -1024,7 +1060,7 @@ sap.ui.define([
 			 * @returns {int} row index
 			 */
 			rowIndex: function (oTable, oCellDomRef) {
-				return jQuery(oCellDomRef).control(0, true).getIndex();
+				return Element.closestTo(oCellDomRef, true).getIndex();
 			},
 			/**
 			 * Retrieves the column index for the given cell's DOM reference.
@@ -1033,13 +1069,45 @@ sap.ui.define([
 			 * @returns {int} column index
 			 */
 			colIndex: function (oTable, oCellDomRef) {
-				return this._getColumns(oTable).indexOf(Core.byId(oCellDomRef.getAttribute("data-sap-ui-colid")));
+				return this.getVisibleColumns(oTable).indexOf(Core.byId(oCellDomRef.getAttribute("data-sap-ui-colid")));
 			},
-			contextByIndex: function(oTable, iRowIndex) {
-				return oTable.getContextByIndex(iRowIndex);
+			/**
+			 * Loads contexts according to the provided parameters without changing the binding's state.
+			 *
+			 * @param {sap.ui.table.Table} oTable The Table instance
+			 * @param {int} iStartIndex The index where to start the retrieval of contexts
+			 * @param {int} iLength The number of contexts to retrieve beginning from the start index.
+			 */
+			loadContexts: function(oTable, iStartIndex, iLength) {
+				var oBinding = oTable.getBinding("rows");
+				if (!oBinding || oBinding.isA("sap.ui.model.ClientListBinding")) {
+					return;
+				}
+
+				oBinding.getContexts(Math.max(0, iStartIndex), Math.max(1, iLength), 0, true);
+			},
+			/**
+			 * Retrieves the row contexts of the table according to the specified parameters.
+			 * @param {sap.ui.table.Table} oTable The table instance
+			 * @param {int} iFromIndex The start index
+			 * @param {int} iToIndex The end index
+			 * @param {int} iLimit The range limit
+			 * @returns {sap.ui.model.Context[]} A portion of the row binding contexts
+			 */
+			rowContexts: function(oTable, iFromIndex, iToIndex, iLimit) {
+				if (iToIndex == Infinity) {
+					var iMaxIndex = oTable.getBinding("rows").getAllCurrentContexts().length - 1;
+					iToIndex = Math.min(iToIndex, iFromIndex + iLimit - 1, iMaxIndex);
+				}
+
+				var aContexts = [];
+				for (var i = iFromIndex; i <= iToIndex; i++) {
+					aContexts.push(oTable.getContextByIndex(i));
+				}
+				return aContexts;
 			},
 			columnByIndex: function(oTable, iColIndex) {
-				var oColumn = this._getColumns(oTable)[iColIndex];
+				var oColumn = this.getVisibleColumns(oTable)[iColIndex];
 				if (!oColumn.getVisible()) {
 					return;
 				}
@@ -1047,7 +1115,7 @@ sap.ui.define([
 			},
 			isNavigatableCell: function (oTable, mPosition) {
 				if ((mPosition.rowIndex < 0 || mPosition.rowIndex >= oTable.getBinding("rows").getLength()
-					|| mPosition.colIndex < 0 || mPosition.colIndex >= this._getColumns(oTable).length)
+					|| mPosition.colIndex < 0 || mPosition.colIndex >= this.getVisibleColumns(oTable).length)
 					&& !(mPosition.rowIndex == -Infinity || mPosition.rowIndex == Infinity
 					|| mPosition.colIndex == -Infinity || mPosition.colIndex == Infinity)) {
 					return false;
@@ -1093,16 +1161,6 @@ sap.ui.define([
 				}
 				oCellRef &&	oCellRef.focus();
 			},
-			/**
-			 * Get visible columns of the table.
-			 * @param {sap.ui.table.Table} oTable table instance
-			 * @returns {sap.ui.table.Column[]} array of visible columns
-			 */
-			_getColumns: function (oTable) {
-				return oTable.getColumns().filter(function (oColumn) {
-					return oColumn.getDomRef();
-				});
-			},
 			/**
 			 * Retrieve a row by its index.
 			 * @param {sap.ui.table.Table} oTable table instance

package/src/sap/m/plugins/ColumnResizer.js

@@ -1,22 +1,23 @@
 /*!
  * 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([
 	"./PluginBase",
 	"sap/ui/core/Core",
+	"sap/ui/core/Element",
 	"sap/ui/core/InvisibleText",
 	"sap/ui/Device",
 	"sap/m/ColumnPopoverActionItem",
 	"sap/m/table/columnmenu/QuickAction",
 	"sap/m/Button",
 	"sap/ui/thirdparty/jquery",
-	"sap/ui/dom/jquery/control", // jQuery Plugin "control"
 	"sap/ui/dom/jquery/Aria" // jQuery Plugin "aria"
 ], function(PluginBase,
 	Core,
+	Element,
 	InvisibleText,
 	Device,
 	ColumnPopoverActionItem,
@@ -39,7 +40,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Element
 	 * @author SAP SE
-	 * @version 1.109.0
+	 * @version 1.111.0
 	 *
 	 * @public
 	 * @since 1.91
@@ -124,7 +125,7 @@ sap.ui.define([
 	 */
 	ColumnResizer.prototype._updateAriaDescribedBy = function(sAction) {
 		this._aResizables.forEach(function(oResizable) {
-			var oResizableControl = jQuery(oResizable).control(0, true);
+			var oResizableControl = Element.closestTo(oResizable, true);
 			var oFocusDomRef = oResizableControl && oResizableControl.getFocusDomRef();
 			jQuery(oFocusDomRef)[sAction + "AriaDescribedBy"](InvisibleText.getStaticId("sap.m", "COLUMNRESIZER_RESIZABLE"));
 		});
@@ -346,14 +347,14 @@ sap.ui.define([
 	 */
 	ColumnResizer.prototype._startResizeSession = function(iIndex) {
 		oSession.$CurrentColumn = jQuery(this._aResizables[iIndex]);
-		oSession.oCurrentColumn = oSession.$CurrentColumn.control(0, true);
+		oSession.oCurrentColumn = Element.closestTo(oSession.$CurrentColumn[0], true);
 		oSession.fCurrentColumnWidth = oSession.$CurrentColumn.width();
 		oSession.iMaxDecrease = this._getColumnMinWidth(oSession.oCurrentColumn) - oSession.fCurrentColumnWidth;
 		oSession.iEmptySpace = this.getConfig("emptySpace", this.getControl());
 
 		if (oSession.iEmptySpace != -1) {
 			oSession.$NextColumn = jQuery(this._aResizables[iIndex + 1]);
-			oSession.oNextColumn = oSession.$NextColumn.control(0, true);
+			oSession.oNextColumn = Element.closestTo(oSession.$NextColumn[0], true);
 			oSession.fNextColumnWidth = oSession.$NextColumn.width() || 0;
 			oSession.iMaxIncrease = oSession.iEmptySpace + oSession.fNextColumnWidth - this._getColumnMinWidth(oSession.oNextColumn);
 		} else {
@@ -396,7 +397,7 @@ sap.ui.define([
 		// when any column is resized, then make all visible columns have fixed width
 		this.getConfig("fixAutoWidthColumns") && this._aResizables.forEach(function(oResizable) {
 			var $Resizable = jQuery(oResizable),
-				oColumn = $Resizable.control(0, true),
+				oColumn = Element.closestTo(oResizable, true),
 				sWidth = oColumn.getWidth();
 
 			if (sWidth && sWidth.toLowerCase() != "auto") {
@@ -506,9 +507,8 @@ sap.ui.define([
 		}
 
 		return new QuickAction({
-			label: Core.getLibraryResourceBundle("sap.m").getText("table.COLUMN_MENU_RESIZE"),
 			content: new Button({
-				icon: "sap-icon://resize-horizontal",
+				text: Core.getLibraryResourceBundle("sap.m").getText("table.COLUMNMENU_RESIZE"),
 				press: function() {
 					oColumnMenu.close();
 					this.startResizing(oColumn.getDomRef());

package/src/sap/m/plugins/CopyProvider.js

@@ -0,0 +1,302 @@
+/* eslint-disable no-loop-func */
+/*!
+ * OpenUI5
+ * (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(["./PluginBase", "sap/ui/core/Core"], function(PluginBase, Core) {
+	"use strict";
+
+	/**
+	 * Constructor for a new CopyProvider plugin that can be used to copy table rows to the clipboard.
+	 *
+	 * @param {string} [sId] ID for the new <code>CopyProvider</code>, generated automatically if no ID is given
+	 * @param {object} [mSettings] Initial settings for the <code>CopyProvider</code>
+	 *
+	 * @class
+	 * Provides copy to clipboard capabilities for the selected rows of the table.
+	 * This plugin can copy individual cells if the {@link sap.m.plugins.CellSelector CellSelector} plugin is also enabled for that table.<br>
+	 *
+	 * <b>Note:</b> If a <code>sap.ui.table.Table</code> control is used together with server-side models, the {@link sap.ui.table.plugins.MultiSelectionPlugin MultiSelectionPlugin}
+	 * must be set for that table to make this plugin work property with range selections. See also the {@link sap.ui.table.plugins.MultiSelectionPlugin#getLimit limit} property of
+	 * the <code>MultiSelectionPlugin</code>.<br>
+	 * <b>Note:</b> This plugin requires a secure origin, either HTTPS or localhost, in order to access the browser's clipboard API.
+	 * For more information, see {@link https://w3c.github.io/webappsec-secure-contexts/}.
+	 *
+	 * @extends sap.ui.core.Element
+	 * @author SAP SE
+	 * @version 1.111.0
+	 *
+	 * @public
+	 * @since 1.110
+	 * @alias sap.m.plugins.CopyProvider
+	 */
+	var CopyProvider = PluginBase.extend("sap.m.plugins.CopyProvider", /** @lends sap.m.plugins.CopyProvider.prototype */ { metadata: {
+		library: "sap.m",
+		properties: {
+			/**
+			 * Callback function to extract the cell data that is copied to the clipboard.
+			 *
+			 * @callback sap.m.plugins.CopyProvider.extractDataHandler
+			 * @param {sap.ui.model.Context|sap.m.ColumnListItem} oContextOrRow The binding context of the selected row or the row instance if there is no binding
+			 * @param {sap.m.Column|sap.ui.table.Column|sap.ui.mdc.table.Column} oColumn The related column instance of selected cells
+			 * @returns {*|Array.<*>|undefined|null} The cell data to be copied or array of cell data to be split into different cells in the clipboard. <code>undefined</code> or <code>null</code> to exclude the cell from copying.
+			 * @public
+			 */
+			/**
+			 * Defines a {@link sap.m.plugins.CopyProvider.extractDataHandler callback function} that gets called for each selected cell to extract the cell data that is copied to the clipboard.
+			 *
+			 * The callback function gets called with the binding context of the selected row and the column instance parameters.<br>
+			 * For the <code>sap.ui.table.Table</code> control, the row context parameter can also be the context of an unselectable row in case of a range selection, for example the context of grouping or sub-total row.<br>
+			 * For the <code>sap.m.Table</code> control, if the <code>items</code> aggregation of the table is not bound then the callback function gets called with the row instance instead of the binding context.<br>
+			 * The callback function must return the cell data that is then stringified and copied to the clipboard.<br>
+			 * If an array is returned from the callback function, then each array values will be copied as a separate cell into the clipboard.<br>
+			 * If a column should not be copied to the clipboard, then the callback function must return <code>undefined</code> or <code>null</code> for each cell of the same column.<br>
+			 * <br>
+			 * <b>Note:</b> This property is mandatory to make the <code>CopyProvider</code> plugin work, and it must be set in the constructor.
+			 */
+			extractData: { type: "function", invalidate: false },
+
+			/**
+			 * Determines whether unselected rows that are located between the selected rows are copied to the clipboard as an empty row.
+			 *
+			 * This can be useful for maintaining the original structure of the data when it is pasted into a new location (e.g. spreadsheets).
+			 */
+			copySparse: { type: "boolean", defaultValue: false, invalidate: false },
+
+			/**
+			 * Callback function to exclude certain contexts from being copied to the clipboard.
+			 *
+			 * @callback sap.m.plugins.CopyProvider.excludeContextHandler
+			 * @param {sap.ui.model.Context|sap.m.ColumnListItem} oContextOrRow The binding context of the selected row or the row instance if there is no binding
+			 * @returns {boolean} <code>true</code> to exclude the context, <code>false</code> otherwise
+			 * @public
+			 */
+			/**
+			 * Defines a {@link sap.m.plugins.CopyProvider.excludeContextHandler callback function} which gets called to exclude certain contexts from being copied to the clipboard.
+			 *
+			 * This callback function gets called with the binding context or the row instance if there is no binding.
+			 * Return <code>true</code> to exclude the context, <code>false</code> otherwise.
+			 */
+			excludeContext: { type: "function", invalidate: false }
+		},
+		events: {
+			/**
+			 * This event is fired if there is a selection, and the user triggers the copy action.
+			 *
+			 * This can be done with the standard paste keyboard shortcut when the focus is on a selected row or cell. Also the {@link #copySelectionData} API can be called,
+			 * for example, from the press handler of a copy button in a table toolbar to start the copy action synthetically, which might cause this event to be fired.
+			 * To avoid writing the selection to the clipboard, call <code>preventDefault</code> on the event instance.
+			 */
+			copy: {
+				allowPreventDefault: true,
+				parameters: {
+					/**
+					 * Two-dimensional mutable array of selection data to be copied to the clipboard.
+					 * The first dimension represents the selected rows, and the second dimension represents the cells of the selected rows.
+					 */
+					data: { type: "any[][]" }
+				}
+			}
+		}
+	}});
+
+	function isCellValueCopyable(vCellValue) {
+		return vCellValue != null;
+	}
+
+	function stringifyForSpreadSheet(vCellValue) {
+		if (isCellValueCopyable(vCellValue)) {
+			var sCellValue = String(vCellValue);
+			return /\n|\r|\t/.test(sCellValue) ? '"' + sCellValue.replaceAll('"', '""') + '"' : sCellValue;
+		} else {
+			return "";
+		}
+	}
+
+	function copyMatrixForSpreadSheet(aMatrix) {
+		var sClipboardText = aMatrix.map(function(aRows) {
+			return aRows.map(stringifyForSpreadSheet).join("\t");
+		}).join("\n");
+
+		return navigator.clipboard.writeText(sClipboardText);
+	}
+
+	CopyProvider.prototype.isApplicable = function() {
+		if (!navigator.clipboard) {
+			throw new Error(this + " requires a secure context in order to access the clipboard API.");
+		} else if (!this.getExtractData()) {
+			throw new Error("extractData property must be defined for " + this);
+		} else {
+			return true;
+		}
+	};
+
+	CopyProvider.prototype.onActivate = function(oControl) {
+		this._oDelegate = { onkeydown: this.onkeydown };
+		oControl.addEventDelegate(this._oDelegate, this);
+	};
+
+	CopyProvider.prototype.onDeactivate = function(oControl) {
+		oControl.removeEventDelegate(this._oDelegate, this);
+		this._oDelegate = null;
+	};
+
+	/**
+	 * Returns the extracted selection data as a two-dimensional array. This includes individual cell selections
+	 * if the {@link sap.m.plugins.CellSelector CellSelector} plugin is also enabled for the table.
+	 * <b>Note: </b> The returned array might be a sparse array if the {@link #getCopySparse copySparse} property is <code>true</code>.
+	 *
+	 * @returns {Array.<Array.<*>>} Two-dimensional extracted data from the selection.
+	 * @public
+	 */
+	CopyProvider.prototype.getSelectionData = function() {
+		var oControl = this.getControl();
+		var fnExtractData = this.getExtractData();
+		if (!oControl || !fnExtractData || !navigator.clipboard) {
+			return [];
+		}
+
+		var aSelectableColumns = this.getConfig("selectableColumns", oControl);
+		if (!aSelectableColumns.length) {
+			return [];
+		}
+
+		if (oControl.getParent().isA("sap.ui.mdc.Table")) {
+			aSelectableColumns = aSelectableColumns.map(function(oSelectableColumn) {
+				return Core.byId(oSelectableColumn.getId().replace(/\-innerColumn$/, ""));
+			});
+		}
+
+		var aSelectionData = [];
+		var aAllSelectedRowContexts = [];
+		var bCopySparse = this.getCopySparse();
+		var fnExludeContext = this.getExcludeContext();
+		var oCellSelectorPlugin = PluginBase.getPlugin(oControl, "sap.m.plugins.CellSelector");
+		var mCellSelectionRange = oCellSelectorPlugin && oCellSelectorPlugin.getSelectionRange();
+		var aCellSelectorRowContexts = mCellSelectionRange ? oCellSelectorPlugin.getSelectedRowContexts() : [];
+		var bCellSelectorRowContextsMustBeMerged = Boolean(aCellSelectorRowContexts.length);
+		var bSelectedRowContextsMustBeSparse = bCellSelectorRowContextsMustBeMerged || bCopySparse;
+		var aSelectedRowContexts = this.getConfig("selectedContexts", oControl, bSelectedRowContextsMustBeSparse);
+
+		if (bCellSelectorRowContextsMustBeMerged) {
+			aCellSelectorRowContexts = Array(mCellSelectionRange.from.rowIndex).concat(aCellSelectorRowContexts);
+			Object.assign(aAllSelectedRowContexts, aSelectedRowContexts, aCellSelectorRowContexts);
+		} else {
+			aAllSelectedRowContexts = aSelectedRowContexts;
+		}
+
+		for (var iContextIndex = 0; iContextIndex < aAllSelectedRowContexts.length; iContextIndex++) {
+			var oRowContext = aAllSelectedRowContexts[iContextIndex];
+			if (!oRowContext) {
+				if (bCopySparse && aSelectionData.length) {
+					aSelectionData.push(Array(aSelectionData[0].length));
+				}
+			} else if (fnExludeContext && fnExludeContext(oRowContext)) {
+				continue;
+			} else {
+				var aRowData = [];
+				var bContextFromSelectedRows = (oRowContext == aSelectedRowContexts[iContextIndex]);
+				aSelectableColumns.forEach(function(oColumn, iColumnIndex) {
+					if (bContextFromSelectedRows || (iColumnIndex >= mCellSelectionRange.from.colIndex && iColumnIndex <= mCellSelectionRange.to.colIndex)) {
+						var vCellData = fnExtractData(oRowContext, oColumn);
+						if (isCellValueCopyable(vCellData)) {
+							aRowData.push[Array.isArray(vCellData) ? "apply" : "call"](aRowData, vCellData);
+						}
+					} else if (aSelectedRowContexts.length) {
+						aRowData.push(undefined);
+					}
+				});
+				if (bCopySparse || aRowData.some(isCellValueCopyable)) {
+					aSelectionData.push(aRowData);
+				}
+			}
+		}
+
+		return aSelectionData;
+	};
+
+	/**
+	 * Writes the selection data to the system clipboard and returns a <code>Promise</code> which resolves once the clipboard's content has been updated.
+	 *
+	 * <b>Note: </b> The user has to interact with the page or a UI element when this API gets called.
+	 *
+	 * @param {boolean} [bFireCopyEvent=false] Whether the <code>copy</code> event should be triggered or not
+	 * @returns {Promise} A <code>Promise</code> that is resolved after the selection data has been written to the clipboard
+	 * @public
+	 */
+	CopyProvider.prototype.copySelectionData = function(bFireCopyEvent) {
+		var aSelectionData = this.getSelectionData();
+		if (!aSelectionData.length || bFireCopyEvent && !this.fireCopy({ data: aSelectionData }, true)) {
+			return Promise.resolve();
+		}
+
+		return copyMatrixForSpreadSheet(aSelectionData);
+	};
+
+	CopyProvider.prototype.onkeydown = function(oEvent) {
+		if (oEvent.isMarked() ||
+			oEvent.code != "KeyC" ||
+			!(oEvent.ctrlKey || oEvent.metaKey) ||
+			!oEvent.target.matches(this.getConfig("allowForCopySelector"))) {
+			return;
+		}
+
+		oEvent.setMarked();
+		oEvent.preventDefault();
+		this.copySelectionData(true);
+	};
+
+
+	/**
+	 * Plugin-specific control configurations.
+	 */
+	PluginBase.setConfigs({
+		"sap.m.Table": {
+			allowForCopySelector: ".sapMLIBFocusable,.sapMLIBSelectM,.sapMLIBSelectS",
+			selectedContexts: function(oTable, bSparse) {
+				var aSelectedContexts = [];
+				var oBindingInfo = oTable.getBindingInfo("items");
+				oTable.getItems(true).forEach(function(oItem, iIndex) {
+					if (oItem.isSelectable() && oItem.getVisible()) {
+						if (oItem.getSelected()) {
+							var oContextOrItem = oBindingInfo ? oItem.getBindingContext(oBindingInfo.model) : oItem;
+							var iSparseOrDenseIndex = bSparse ? iIndex : aSelectedContexts.length;
+							aSelectedContexts[iSparseOrDenseIndex] = oContextOrItem;
+						}
+					}
+				});
+				return aSelectedContexts;
+			},
+			selectableColumns: function(oTable) {
+				return oTable.getColumns(true).filter(function(oColumn) {
+					return oColumn.getVisible() && (oColumn.isPopin() || (!oColumn.isPopin() && !oColumn.isHidden()));
+				});
+			}
+		},
+		"sap.ui.table.Table": {
+			allowForCopySelector: ".sapUiTableCell",
+			selectedContexts: function(oTable, bSparse) {
+				var aSelectedContexts = [];
+				var oSelectionOwner = PluginBase.getPlugin(oTable, "sap.ui.table.plugins.SelectionPlugin") || oTable;
+				oSelectionOwner.getSelectedIndices().forEach(function(iSelectedIndex) {
+					var oContext = oTable.getContextByIndex(iSelectedIndex);
+					if (oContext) {
+						var iSparseOrDenseIndex = bSparse ? iSelectedIndex : aSelectedContexts.length;
+						aSelectedContexts[iSparseOrDenseIndex] = oContext;
+					}
+				});
+				return aSelectedContexts;
+			},
+			selectableColumns: function(oTable) {
+				return oTable.getColumns().filter(function(oColumn) {
+					return oColumn.getDomRef();
+				});
+			}
+		}
+	}, CopyProvider);
+
+	return CopyProvider;
+
+});