@refinitiv-ui/efx-grid 6.0.0-next.0

package/lib/statistics-row/es6/index.d.ts

@@ -0,0 +1 @@
+export * from "./StatisticsRow";

package/lib/statistics-row/es6/index.js

@@ -0,0 +1 @@
+export * from "./StatisticsRow";

package/lib/tr-grid-auto-tooltip/es6/AutoTooltip.d.ts

@@ -0,0 +1,45 @@
+import { Ext } from "../../tr-grid-util/es6/Ext.js";
+import { GridPlugin } from "../../tr-grid-util/es6/GridPlugin.js";
+
+declare namespace AutoTooltipPlugin {
+
+    type Options = {
+        header?: boolean,
+        title?: boolean,
+        footer?: boolean,
+        content?: boolean,
+        quickMode?: boolean
+    };
+
+    type ColumnOptions = {
+        autoTooltip?: boolean
+    };
+
+}
+
+declare class AutoTooltipPlugin extends GridPlugin {
+
+    constructor(options?: AutoTooltipPlugin.Options);
+
+    public getName(): string;
+
+    public initialize(host: any, options?: any): void;
+
+    public unload(host: any): void;
+
+    public config(options?: any): void;
+
+    public getConfigObject(gridOptions?: any): any;
+
+    public applyTooltip(colIndex: number, fromR?: number, toR?: number): void;
+
+    public applyTooltipToColumns(colIndices?: (number)[]): void;
+
+    public applyTooltipToAllColumns(): void;
+
+    public requestTooltipUpdate(): void;
+
+}
+
+export default AutoTooltipPlugin;
+export { AutoTooltipPlugin, AutoTooltipPlugin as AutoTooltip, AutoTooltipPlugin as AutoTooltipExtension };

package/lib/tr-grid-auto-tooltip/es6/AutoTooltip.js

@@ -0,0 +1,431 @@
+import { Ext } from "../../tr-grid-util/es6/Ext.js";
+import { GridPlugin } from "../../tr-grid-util/es6/GridPlugin.js";
+
+var isSafari = navigator.vendor &&
+	navigator.vendor.indexOf('Apple') > -1 &&
+	navigator.userAgent &&
+	navigator.userAgent.indexOf('CriOS') == -1 &&
+	navigator.userAgent.indexOf('FxiOS') == -1;
+
+/** @typedef {Object} AutoTooltipPlugin~Options
+* @description Available options describing `autoTooltip` object specified in grid's option
+* @property {boolean=} header=false If true, text in the header sections (top section) will be qualified for showing tooltip.
+* @property {boolean=} title=false Alias to `header`
+* @property {boolean=} footer=false If true, text in the footer sections will be qualified for showing tooltip.
+* @property {boolean=} content=true If true, text in the content section will be qualified for showing tooltip. Use autoTooltip flag in column configuration to turn on auto-tooltip for individual column
+* @property {boolean=} quickMode=false Deprecated
+*/
+
+/** @typedef {Object} AutoTooltipPlugin~ColumnOptions
+* @description Available column options specified in grid's column configuration
+* @property {boolean=} autoTooltip=false If enabled, the column is qualified for showing tooltip
+*/
+
+/** @constructor
+* @param {AutoTooltipPlugin~Options=} options
+* @extends {GridPlugin}
+*/
+var AutoTooltipPlugin = function (options) {
+	this.requestTooltipUpdate = this.requestTooltipUpdate.bind(this);
+	this.applyTooltipToAllColumns = this.applyTooltipToAllColumns.bind(this);
+	this._onPreSectionDataBinding = this._onPreSectionDataBinding.bind(this);
+	this._onColumnAdded = this._onColumnAdded.bind(this);
+
+	this._hosts = [];
+
+	if (options) {
+		this.config({ autoTooltip: options });
+	}
+};
+Ext.inherits(AutoTooltipPlugin, GridPlugin);
+
+/** If true, include title sections into the calculation
+* @type {boolean}
+* @private
+*/
+AutoTooltipPlugin.prototype._title = false;
+/** If true, include footer sections into the calculation
+* @type {boolean}
+* @private
+*/
+AutoTooltipPlugin.prototype._footer = false;
+/** If true, include content section into the calculation
+* @type {boolean}
+* @private
+*/
+AutoTooltipPlugin.prototype._contentTooltip = true;
+/** @type {number}
+* @private
+*/
+AutoTooltipPlugin.prototype._applyTimer = 0;
+/** @type {number}
+* @private
+*/
+AutoTooltipPlugin.prototype._calcDelay = 300;
+
+/** @public
+* @return {string}
+*/
+AutoTooltipPlugin.prototype.getName = function () {
+	return "AutoTooltipPlugin"; // Read Only
+};
+
+/** @public
+* @param {Object} host core grid
+* @param {Object=} options
+*/
+AutoTooltipPlugin.prototype.initialize = function (host, options) {
+	if (this._hosts.indexOf(host) >= 0) { return; }
+
+	this._hosts.push(host);
+
+	this.config(options);
+
+	if (isSafari) {
+		// ignore safari browser.
+		// casue safari will automatically show tooltip when text is ellipsis.
+		return;
+	}
+	host.listen("preSectionDataBinding", this._onPreSectionDataBinding);
+	host.listen("postSectionDataBinding", this.requestTooltipUpdate);
+	host.listen("widthChanged", this.requestTooltipUpdate);
+	host.listen("columnAdded", this._onColumnAdded);
+
+	// In case of lazy loading
+	this.requestTooltipUpdate();
+};
+
+/** @public
+* @param {Object} host core grid
+*/
+AutoTooltipPlugin.prototype.unload = function (host) {
+	var at = this._hosts.indexOf(host);
+	if (at < 0) { return; }
+	this._hosts.splice(at, 1);
+
+	host.unlisten("preSectionDataBinding", this._onPreSectionDataBinding);
+	host.unlisten("postSectionDataBinding", this.requestTooltipUpdate);
+	host.unlisten("widthChanged", this.requestTooltipUpdate);
+	host.unlisten("columnAdded", this._onColumnAdded);
+
+	if (!this._hosts.length) {
+		if (this._applyTimer) {
+			clearTimeout(this._applyTimer);
+			this._applyTimer = 0;
+		}
+	}
+
+	this._dispose();
+};
+
+/** @public
+* @param {Object=} options Grid configuration object
+*/
+AutoTooltipPlugin.prototype.config = function (options) {
+	if (!options) { return; }
+
+	var extOptions = options.autoTooltip;
+	if(extOptions) {
+		// header is alias of title
+		var val = extOptions["title"] || extOptions["header"];
+		if (val != null) {
+			this._title = val ? true : false;
+		}
+		var footerVal = extOptions["footer"];
+		if (footerVal != null) {
+			this._footer = footerVal ? true : false;
+		}
+		// Enable auto tooltip to all column by default
+		val = extOptions["content"];
+		if (val != null) {
+			this._contentTooltip = val ? true : false;
+		}
+	}
+
+	// Retrive auto tooltip data from comlum
+	var columns = options["columns"];
+	if (columns) {
+		var len = columns.length;
+		for (var c = 0; c < len; ++c) {
+			this._configColumn(c, columns[c]);
+		}
+	}
+};
+
+/** @public
+* @param {Object=} gridOptions
+* @return {!Object}
+*/
+AutoTooltipPlugin.prototype.getConfigObject = function (gridOptions) {
+	var obj = gridOptions || {};
+
+	var columns = obj.columns;
+	if(!columns) {
+		columns = obj.columns = [];
+	}
+
+	var len = this.getColumnCount();
+	for(var i = 0; i < len; ++i) {
+		var column = columns[i];
+		if(!column) {
+			column = columns[i] = {};
+		}
+
+		var colOptions = this._getColumnOption(i, "autoTooltip");
+		if(colOptions === true) {
+			column.autoTooltip = true;
+		}
+	}
+
+	var extOptions = obj.autoTooltip;
+	if(!extOptions) {
+		extOptions = obj.autoTooltip = {};
+	}
+
+	if(this._title === true) {
+		extOptions.title = true;
+	}
+
+	if(this._contentTooltip === true) {
+		extOptions.content = true;
+	}
+
+	if(this._footer === true) {
+		extOptions.footer = true;
+	}
+
+	return obj;
+};
+
+/** @private
+* @param {number} colIndex
+* @param {number} columnConfig
+*/
+AutoTooltipPlugin.prototype._configColumn = function(colIndex, columnConfig) {
+	if(columnConfig) {
+		var val = columnConfig["autoTooltip"];
+		if (val != null) {
+			this._newColumnData(colIndex)["autoTooltip"] = val ? true : false;
+		}
+	}
+};
+
+/** Force update and calculation on a single column. It is not recommended to be used multiple time successively
+* @public
+* @param {number} colIndex Column index
+* @param {number=} fromR Start row index
+* @param {number=} toR End row index
+*/
+AutoTooltipPlugin.prototype.applyTooltip = function (colIndex, fromR, toR) {
+	var len = this._hosts.length;
+	if (len <= 0 || isSafari) {
+		return;
+	}
+
+	for (var i = 0; i < len; ++i) {
+		var host = this._hosts[i];
+		if (this._title) {
+			var titles = host.getAllSections("title");
+			for (var t = titles.length; --t >= 0;) {
+				this._applyTooltipToSection(titles[t], colIndex);
+			}
+		}
+		if (this._footer) {
+			var footers = host.getAllSections("footer");
+			for (var j = footers.length; --j >= 0;) {
+				this._applyTooltipToSection(footers[j], colIndex);
+			}
+		}
+
+		if(this._isTooltipCandidate(colIndex)) {
+			this._applyTooltipToSection(host.getSection("content"), colIndex, fromR, toR);
+		}
+	}
+};
+
+/** Force update and calculation on specific columns
+* @public
+* @param {Array.<number>=} colIndices Column indices
+*/
+AutoTooltipPlugin.prototype.applyTooltipToColumns = function (colIndices) {
+	var host = this._hosts ? this._hosts[0] : null;
+	if (host && host.getElement()) {
+		var len = colIndices ? colIndices.length : 0;
+		for (var i = 0; i < len; ++i) {
+			this.applyTooltip(colIndices[i]);
+		}
+	}
+};
+
+/** Force update and calculation on all columns
+* @public
+*/
+AutoTooltipPlugin.prototype.applyTooltipToAllColumns = function () {
+	this._applyTimer = 0;
+	var colCount = this.getColumnCount();
+	for (var c = 0; c < colCount; ++c) {
+		this.applyTooltip(c);
+	}
+};
+
+/**
+* @private
+* @param {Object} section ILayoutGrid
+* @param {number} colIndex Column index
+* @param {number=} fromR Start row index
+* @param {number=} toR End row index
+* @return {boolean} True if there is any change, otherwise false
+*/
+AutoTooltipPlugin.prototype._applyTooltipToSection = function (section, colIndex, fromR, toR) {
+	if (!section) { return false; }
+
+	if (!fromR) {
+		fromR = 0;
+	}
+
+	if (toR == null) {
+		toR = section.getRowCount();
+	}
+
+	if (fromR >= toR) {
+		return false;
+	}
+
+	var columnObj = section.getColumn(colIndex);
+	if (!columnObj) {
+		return false;
+	}
+
+	var colElem = columnObj.getElement();
+	if (!colElem) {
+		return false;
+	}
+
+	for (var r = fromR; r < toR; ++r) {
+		var cell = section.getCell(colIndex, r, false); // Ignore cell span
+		if (cell && cell.isVisible()) {
+
+			if (cell._userDefinedTooltip == null) {
+				var tooltipProp = cell.getTooltip() || cell.getAttribute('ef-title');
+				cell._userDefinedTooltip = tooltipProp || '';
+			}
+
+			var elem = cell.getContent();
+			var tooltip = "";
+			if (elem) {
+				var sw = elem.scrollWidth;
+
+				// Set tooltip only if text's length is longer than column width.
+				if (sw && sw > elem.offsetWidth) {
+					tooltip = cell.getTextContent(); // TODO: Allow custom tooltip text
+				} else if (cell._userDefinedTooltip) {
+					tooltip = cell._userDefinedTooltip;
+				}
+			}
+
+			// for check when row is changed we will clear cache in _onPreSectionDataBinding event
+			cell._previousPos = r + '-' + colIndex;
+
+			// TODO: Avoiding using getter and setter in the same loop
+			cell.setTooltip(tooltip);
+
+			// to make sure ef-title value will actually change
+			cell.setAttribute('ef-title', tooltip);
+		}
+	}
+	return true;
+};
+
+/** Use for clear tooltip cache in cell when data change (from setData method) or row data change (from user scroll grid)
+* @private
+* @param {Object} section ILayoutGrid
+* @param {number} colIndex Column index
+* @param {number=} fromRowIndex Start row index
+* @param {number=} toRowIndex End row index
+* @param {boolean=} isDataChange=false Case data is actually changed
+*/
+AutoTooltipPlugin.prototype._clearTooltipCache = function (section, colIndex, fromRowIndex, toRowIndex, isDataChange) {
+	if(!this._isTooltipCandidate(colIndex)) {
+		return;
+	}
+
+	for (var rowIndex = fromRowIndex; rowIndex < toRowIndex; rowIndex++) {
+		var cell = section.getCell(colIndex, rowIndex);
+		// if isDataChange = true
+		if (isDataChange || (cell && cell._userDefinedTooltip != null)) {
+			cell._userDefinedTooltip = null;
+
+			// Need to check cell._previousPos
+			// because sometime _onPreSectionDataBinding will be call twice
+			// so if we carelessly clear all tooltip then the tooltip that user assign by himself will be accidentally delete
+			// Therefore, in this case we will try to move change ef-title attribute into title instead
+			// to avoid conflict about ef-title and title
+			// and if user have intention to change tooltip by himself (in case data update)
+			// it gonna overwrite title attribute alone
+			if (cell._previousPos === rowIndex + '-' + colIndex
+				&& !isDataChange // in case isDataChange be true then we need to clear all tooltip cache in else block
+			) {
+				var tooltip = cell.getTooltip() || cell.getAttribute('ef-title');
+				if (tooltip) {
+					cell.removeAttribute('ef-title');
+					cell.setTooltip(tooltip);
+				}
+			}
+			// in case row change, data change by sorting or filter or data update we can freely clear previous tooltip
+			else {
+				cell.removeAttribute('ef-title');
+				cell.setTooltip('');
+			}
+		}
+	}
+};
+
+/** @private
+* @param {Event} e event from preSectionDataBinding
+*/
+AutoTooltipPlugin.prototype._onPreSectionDataBinding = function (e) {
+	if (e && 'content' === e.sectionType) {
+		var colCount = this.getColumnCount();
+		var isDataChange = e.actualUpdate === true;
+		for (var c = 0; c < colCount; ++c) {
+			this._clearTooltipCache(e.section, c, e.fromRowIndex, e.toRowIndex, isDataChange);
+		}
+	}
+};
+
+/** This is similar applyTooltipToColumns() method, but it consolidate multiple requests into one for better performance
+* @public
+*/
+AutoTooltipPlugin.prototype.requestTooltipUpdate = function () {
+	if (!this._applyTimer) {
+		this._applyTimer = setTimeout(this.applyTooltipToAllColumns, this._calcDelay);
+	}
+};
+
+/** @private
+* @param {Event|Element} e
+*/
+AutoTooltipPlugin.prototype._onColumnAdded = function(e) {
+	if(e.context && e.colIndex != null) {
+		this._configColumn(e.colIndex, e.context);
+	}
+};
+
+
+/** Check if the content section of the given column is eligible for tooltip processing
+* @private
+* @param {number} colIndex
+* @return {boolean}
+*/
+AutoTooltipPlugin.prototype._isTooltipCandidate = function (colIndex) {
+	var bool = this._getColumnOption(colIndex, "autoTooltip");
+	if(bool != null) {
+		return bool ? true : false;
+	}
+	return this._contentTooltip;
+};
+
+
+
+export default AutoTooltipPlugin;
+export { AutoTooltipPlugin, AutoTooltipPlugin as AutoTooltip, AutoTooltipPlugin as AutoTooltipExtension };

package/lib/tr-grid-auto-tooltip/es6/index.d.ts

@@ -0,0 +1 @@
+export * from "./AutoTooltip";

package/lib/tr-grid-auto-tooltip/es6/index.js

@@ -0,0 +1 @@
+export * from "./AutoTooltip";

package/lib/tr-grid-cell-selection/es6/CellSelection.d.ts

@@ -0,0 +1,67 @@
+import { Ext } from "../../tr-grid-util/es6/Ext.js";
+import { GridPlugin } from "../../tr-grid-util/es6/GridPlugin.js";
+import { MouseDownTrait } from "../../tr-grid-util/es6/MouseDownTrait.js";
+import { EventDispatcher } from "../../tr-grid-util/es6/EventDispatcher.js";
+import { isIE, cloneObject, prepareTSVContent } from "../../tr-grid-util/es6/Util.js";
+
+declare namespace CellSelectionPlugin {
+
+    type Options = {
+        mode?: string,
+        multipleSelection?: boolean,
+        autoDeselecting?: boolean,
+        tabToSelect?: boolean,
+        selectionChanged?: ((...params: any[]) => any),
+        copy?: ((...params: any[]) => any),
+        beforeMouseDown?: ((...params: any[]) => any),
+        selectableSections?: any[]
+    };
+
+}
+
+declare class CellSelectionPlugin extends GridPlugin {
+
+    constructor(options?: any);
+
+    public hasMultiTableSupport(): boolean;
+
+    public config(options?: any): void;
+
+    public getConfigObject(gridOptions?: any): any;
+
+    public getSelectedText(): string;
+
+    public selectAll(): void;
+
+    public deselectAll(): boolean;
+
+    public getSelectionCount(): number;
+
+    public getSelectionBounds(opt_ret?: any): any;
+
+    public getLastSelectionBounds(opt_ret?: any): any;
+
+    public setSelectableSections(types?: (string|(string)[]|null)): void;
+
+    public selectSingleCell(anchor: any): void;
+
+    public selectCells(rect: any): void;
+
+    public selectNextCell(): boolean;
+
+    public selectPrevCell(): boolean;
+
+    public getAnchorInfo(): any;
+
+    public getSelectedCells(): (any)[];
+
+    public disableSelection(opt_disable?: boolean): void;
+
+    public setAutoDeselectingOnBlur(bool: boolean): void;
+
+    public getAutoDeselectingOnBlur(): boolean;
+
+}
+
+export default CellSelectionPlugin;
+export { CellSelectionPlugin, CellSelectionPlugin as CellSelection, CellSelectionPlugin as CellSelectionExtension };