@progress/kendo-angular-pivotgrid 16.6.0-develop.1 → 16.6.0-develop.11

package/models/virtualization-settings.d.ts

@@ -0,0 +1,34 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2024 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+/**
+ * The supported values of the [`VirtualizationSettings`]({% slug api_pivotgrid_virtualizationsettings %}) `type` property - `row`, `column` or `both`.
+ */
+export declare type PivotGridVirtualizationSettingsType = 'row | column | both';
+export interface VirtualizationSettings {
+    /**
+     * Enables the virtualization of the PivotGrid data table. By default both rows and columns are virtualized when the virtualization is enabled.
+     * @default `both`
+     */
+    type?: PivotGridVirtualizationSettingsType;
+    /**
+     * Represents the actual height of each data row in the DOM in pixels.
+     * @default 37
+     */
+    rowHeight?: number;
+    /**
+     * Sets the maximum number of value table rows that will be rendered in the DOM.
+     * @default 50
+     */
+    rows?: number;
+    /**
+     * Sets the maximum number of value table columns that will be rendered in the DOM.
+     * @default 10
+     */
+    columns?: number;
+}
+/**
+ * @hidden
+ */
+export declare const normalizeVirtualSettings: (settings: boolean | VirtualizationSettings) => VirtualizationSettings;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-pivotgrid",
-  "version": "16.6.0-develop.1",
+  "version": "16.6.0-develop.11",
   "description": "PivotGrid package for Angular",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -25,21 +25,21 @@
     "@progress/kendo-data-query": "^1.5.5",
     "@progress/kendo-drawing": "^1.19.0",
     "@progress/kendo-licensing": "^1.0.2",
-    "@progress/kendo-angular-buttons": "16.6.0-develop.1",
-    "@progress/kendo-angular-common": "16.6.0-develop.1",
-    "@progress/kendo-angular-dropdowns": "16.6.0-develop.1",
-    "@progress/kendo-angular-indicators": "16.6.0-develop.1",
-    "@progress/kendo-angular-inputs": "16.6.0-develop.1",
-    "@progress/kendo-angular-intl": "16.6.0-develop.1",
-    "@progress/kendo-angular-l10n": "16.6.0-develop.1",
-    "@progress/kendo-angular-popup": "16.6.0-develop.1",
-    "@progress/kendo-angular-icons": "16.6.0-develop.1",
-    "@progress/kendo-angular-treeview": "16.6.0-develop.1",
+    "@progress/kendo-angular-buttons": "16.6.0-develop.11",
+    "@progress/kendo-angular-common": "16.6.0-develop.11",
+    "@progress/kendo-angular-dropdowns": "16.6.0-develop.11",
+    "@progress/kendo-angular-indicators": "16.6.0-develop.11",
+    "@progress/kendo-angular-inputs": "16.6.0-develop.11",
+    "@progress/kendo-angular-intl": "16.6.0-develop.11",
+    "@progress/kendo-angular-l10n": "16.6.0-develop.11",
+    "@progress/kendo-angular-popup": "16.6.0-develop.11",
+    "@progress/kendo-angular-icons": "16.6.0-develop.11",
+    "@progress/kendo-angular-treeview": "16.6.0-develop.11",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "16.6.0-develop.1",
+    "@progress/kendo-angular-schematics": "16.6.0-develop.11",
     "@progress/kendo-pivotgrid-common": "0.6.0"
   },
   "schematics": "./schematics/collection.json",

package/pivotgrid.component.d.ts

@@ -8,13 +8,15 @@ import { PivotGridDataService } from './data-binding/pivotgrid-data.service';
 import { LoaderSettings } from './models/loader-settings';
 import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { ConfiguratorSettings } from './models/configurator-settings';
-import { ConfiguratorNavigation } from '@progress/kendo-pivotgrid-common';
+import { ConfiguratorNavigation, PivotGridNavigation } from '@progress/kendo-pivotgrid-common';
 import { PivotDataRowItem } from './models/data-row-item';
 import { SVGIcon } from '@progress/kendo-svg-icons';
 import { CellTemplateDirective } from './rendering/templates/pivotgrid-cell-template.directive';
 import { ValueCellTemplateDirective } from './rendering/templates/pivotgrid-value-cell-template.directive';
 import { RowHeaderCellTemplateDirective } from './rendering/templates/pivotgrid-row-header-cell-template.directive';
 import { ColumnHeaderCellTemplateDirective } from './rendering/templates/pivotgrid-column-header-cell-template.directive';
+import { VirtualizationSettings } from './models/virtualization-settings';
+import { PivotGridScrollService } from './virtual/scroll.service';
 import * as i0 from "@angular/core";
 /**
  * Represents the Kendo UI PivotGrid component for Angular.
@@ -25,6 +27,7 @@ export declare class PivotGridComponent implements AfterViewInit, AfterContentIn
     dataService: PivotGridDataService;
     private localization;
     private renderer;
+    private scrollService;
     hostClass: boolean;
     get rightPositionClass(): boolean;
     get leftPositionClass(): boolean;
@@ -58,6 +61,13 @@ export declare class PivotGridComponent implements AfterViewInit, AfterContentIn
      * Specifies whether the axes configurator should be displayed.
      */
     configurator: boolean | ConfiguratorSettings;
+    /**
+     * Sets the virtualization options of the component. By default the virtual scrolling functionality is disabled.
+     *
+     * @default false
+     */
+    set virtualScrolling(value: boolean | VirtualizationSettings);
+    get virtualScrolling(): VirtualizationSettings;
     get configuratorSettings(): ConfiguratorSettings;
     /**
      * Specify the width of the column header and data cells. Value is treated as pixels [(see example)]({% slug appearance_pivotgrid %}#toc-column-headers-width).
@@ -84,12 +94,13 @@ export declare class PivotGridComponent implements AfterViewInit, AfterContentIn
     configuratorNavigation: ConfiguratorNavigation;
     private resizeObservers;
     private _loaderSettings;
+    private _virtualScrolling;
     private subs;
     private rtl;
     private direction;
-    private navigation;
+    navigation: PivotGridNavigation;
     private navigationSubs;
-    constructor(hostEl: ElementRef, zone: NgZone, dataService: PivotGridDataService, localization: LocalizationService, renderer: Renderer2, _scrollbarWidthService: ScrollbarWidthService);
+    constructor(hostEl: ElementRef, zone: NgZone, dataService: PivotGridDataService, localization: LocalizationService, renderer: Renderer2, _scrollbarWidthService: ScrollbarWidthService, scrollService: PivotGridScrollService);
     ngAfterViewInit(): void;
     ngAfterContentInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
@@ -104,10 +115,13 @@ export declare class PivotGridComponent implements AfterViewInit, AfterContentIn
     toggleConfigurator(): void;
     private resizeContainer;
     private handleScroll;
-    private initNavigation;
+    /**
+     * @hidden
+     */
+    initNavigation(): void;
     private stopNavigation;
     private initConfiguratorNavigation;
     private stopConfiguratorNavigation;
     static ɵfac: i0.ɵɵFactoryDeclaration<PivotGridComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PivotGridComponent, "kendo-pivotgrid", never, { "loaderSettings": "loaderSettings"; "configurator": "configurator"; "columnHeadersWidth": "columnHeadersWidth"; "navigable": "navigable"; }, {}, ["customCellTemplate", "valueCellTemplate", "rowHeaderCellTemplate", "columnHeaderCellTemplate"], never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PivotGridComponent, "kendo-pivotgrid", never, { "loaderSettings": "loaderSettings"; "configurator": "configurator"; "virtualScrolling": "virtualScrolling"; "columnHeadersWidth": "columnHeadersWidth"; "navigable": "navigable"; }, {}, ["customCellTemplate", "valueCellTemplate", "rowHeaderCellTemplate", "columnHeaderCellTemplate"], never, true, never>;
 }

package/rendering/pivotgrid-table.component.d.ts

@@ -2,31 +2,52 @@
 * Copyright © 2024 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
-import { OnDestroy, OnInit } from '@angular/core';
+import { ElementRef, NgZone, OnDestroy, OnInit } from '@angular/core';
 import { PivotGridDataService } from '../data-binding/pivotgrid-data.service';
 import { CellTemplateDirective } from './templates/pivotgrid-cell-template.directive';
 import { ValueCellTemplateDirective } from './templates/pivotgrid-value-cell-template.directive';
 import { ColumnHeaderCellTemplateDirective } from './templates/pivotgrid-column-header-cell-template.directive';
 import { RowHeaderCellTemplateDirective } from './templates/pivotgrid-row-header-cell-template.directive';
+import { VirtualizationSettings } from '../models/virtualization-settings';
+import { LocalizationService } from '@progress/kendo-angular-l10n';
+import { PivotGridScrollService } from '../virtual/scroll.service';
 import * as i0 from "@angular/core";
 /**
  * @hidden
  */
 export declare class PivotGridTableComponent implements OnInit, OnDestroy {
+    private host;
     private dataService;
+    private localization;
+    private zone;
+    private scrollService;
     headerItems: any;
     rows: any;
+    renderedRows: any;
+    renderedCols: any;
+    totalRows: any;
+    startRowIndex: number;
+    startColIndex: number;
+    rtl: boolean;
     tableType: string;
     colWidth: number;
     customCellTemplate: CellTemplateDirective;
     valueCellTemplate: ValueCellTemplateDirective;
     rowHeaderCellTemplate: RowHeaderCellTemplateDirective;
     columnHeaderCellTemplate: ColumnHeaderCellTemplateDirective;
+    scrollableSettings: VirtualizationSettings;
     get pivotGridId(): string;
-    private dataChangeSubs;
-    constructor(dataService: PivotGridDataService);
+    get columnVirtualization(): boolean;
+    get rowVirtualization(): boolean;
+    private subs;
+    private scrollable;
+    constructor(host: ElementRef, dataService: PivotGridDataService, localization: LocalizationService, zone: NgZone, scrollService: PivotGridScrollService);
     ngOnInit(): void;
+    ngAfterViewInit(): void;
     ngOnDestroy(): void;
+    private colsUpdateCallback;
+    private initScrollable;
+    private initScrollableKeyboardNavigation;
     static ɵfac: i0.ɵɵFactoryDeclaration<PivotGridTableComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PivotGridTableComponent, "kendo-pivotgrid-table", never, { "tableType": "tableType"; "colWidth": "colWidth"; "customCellTemplate": "customCellTemplate"; "valueCellTemplate": "valueCellTemplate"; "rowHeaderCellTemplate": "rowHeaderCellTemplate"; "columnHeaderCellTemplate": "columnHeaderCellTemplate"; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PivotGridTableComponent, "kendo-pivotgrid-table", never, { "tableType": "tableType"; "colWidth": "colWidth"; "customCellTemplate": "customCellTemplate"; "valueCellTemplate": "valueCellTemplate"; "rowHeaderCellTemplate": "rowHeaderCellTemplate"; "columnHeaderCellTemplate": "columnHeaderCellTemplate"; "scrollableSettings": "scrollableSettings"; }, {}, never, never, true, never>;
 }

package/schematics/ngAdd/index.js

@@ -6,11 +6,11 @@ function default_1(options) {
         // Additional dependencies to install.
         // See https://github.com/telerik/kendo-schematics/issues/28
         peerDependencies: {
-            '@progress/kendo-angular-dialog': '16.6.0-develop.1',
+            '@progress/kendo-angular-dialog': '16.6.0-develop.11',
             // peer dep of the icons
             '@progress/kendo-svg-icons': '^3.0.0',
             // peer dep of the dropdowns
-            '@progress/kendo-angular-navigation': '16.6.0-develop.1'
+            '@progress/kendo-angular-navigation': '16.6.0-develop.11'
         } });
     return (0, schematics_1.externalSchematic)('@progress/kendo-angular-schematics', 'ng-add', finalOptions);
 }

package/util.d.ts

@@ -82,3 +82,10 @@ export declare function cloneArray(array: any[]): any;
  * @hidden
  */
 export declare const swapItems: (arr: any, i1: any, i2: any) => void;
+/**
+ * @hidden
+ */
+export declare const isVisible: (el: any, container: any, offsetY: any, rtl: any) => {
+    visibleX: boolean;
+    visibleY: boolean;
+};

package/virtual/scroll.service.d.ts

@@ -0,0 +1,15 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2024 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import type { PivotGridComponent } from '../pivotgrid.component';
+import * as i0 from "@angular/core";
+/**
+ * @hidden
+ */
+export declare class PivotGridScrollService {
+    virtualScrolling: boolean;
+    pivotGrid: PivotGridComponent;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PivotGridScrollService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PivotGridScrollService>;
+}

package/virtual/scrollable-container.d.ts

@@ -0,0 +1,35 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2024 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+/**
+ * @hidden
+ */
+export declare class ScrollableTable {
+    private element;
+    private handlers;
+    private options;
+    startRow: number;
+    endRow: number;
+    startCol: number;
+    endCol: number;
+    renderedRows: number;
+    renderedCols: number;
+    total: number;
+    totalCols: number;
+    rtl: boolean;
+    private visibleRows;
+    private visibleCols;
+    private lastKnownScrollPosition;
+    private offsetFirst;
+    private stretcher;
+    private rect;
+    constructor(element: HTMLElement, handlers: any, options: any);
+    onNewData(recalculateSize?: boolean): void;
+    destroy(): void;
+    private initialize;
+    private scrollHandler;
+    private scrollEndHandler;
+    recalculateSize(): void;
+    private rowVirtualizationUpdate;
+}