UNPKG

ag-grid-community

Version:

Advanced Data Grid / Data Table supporting Javascript / React / AngularJS / Web Components

452 lines (451 loc) 22.4 kB
import { ColumnApi } from "./columnController/columnApi"; import { GridBodyComp } from "./gridBodyComp/gridBodyComp"; import { ColDef, ColGroupDef, IAggFunc } from "./entities/colDef"; import { RowNode } from "./entities/rowNode"; import { Column } from "./entities/column"; import { IRowModel } from "./interfaces/iRowModel"; import { CellRange, CellRangeParams } from "./interfaces/iRangeController"; import { CellPosition } from "./entities/cellPosition"; import { IViewportDatasource } from "./interfaces/iViewportDatasource"; import { IFilterComp } from "./interfaces/iFilter"; import { CsvExportParams, ProcessCellForExportParams } from "./interfaces/exportParams"; import { ExcelExportMultipleSheetParams, ExcelExportParams } from "./interfaces/iExcelCreator"; import { IDatasource } from "./interfaces/iDatasource"; import { IServerSideDatasource } from "./interfaces/iServerSideDatasource"; import { AlignedGridsService } from "./alignedGridsService"; import { AgEvent, ColumnEventType } from "./events"; import { ICellRendererComp } from "./rendering/cellRenderers/iCellRenderer"; import { ICellEditorComp } from "./interfaces/iCellEditor"; import { HeaderRootComp } from "./headerRendering/headerRootComp"; import { RefreshStoreParams } from "./interfaces/iServerSideRowModel"; import { IStatusPanelComp } from "./interfaces/iStatusPanel"; import { SideBarDef } from "./entities/sideBar"; import { ChartModel } from "./interfaces/IChartService"; import { ChartRef, GetChartToolbarItems, GetContextMenuItems, GetMainMenuItems, GetRowNodeIdFunc, GetServerSideGroupKey, GetServerSideStoreParamsParams, IsApplyServerSideTransaction, IsRowMaster, IsRowSelectable, IsServerSideGroup, IsServerSideGroupOpenByDefaultParams, NavigateToNextCellParams, NavigateToNextHeaderParams, PaginationNumberFormatterParams, PostProcessPopupParams, ProcessChartOptionsParams, ProcessRowParams, ServerSideStoreParams, TabToNextCellParams, TabToNextHeaderParams } from "./entities/gridOptions"; import { ChartOptions, ChartType } from "./interfaces/iChartOptions"; import { IToolPanel } from "./interfaces/iToolPanel"; import { RowNodeTransaction } from "./interfaces/rowNodeTransaction"; import { RowDataTransaction } from "./interfaces/rowDataTransaction"; import { RowDropZoneEvents, RowDropZoneParams } from "./gridBodyComp/rowDragFeature"; import { AgChartThemeOverrides } from "./interfaces/iAgChartOptions"; import { ServerSideTransaction, ServerSideTransactionResult } from "./interfaces/serverSideTransaction"; import { ServerSideStoreState } from "./interfaces/IServerSideStore"; import { GridCompController } from "./gridComp/gridCompController"; import { ISideBar } from "./interfaces/iSideBar"; import { OverlayWrapperComponent } from "./rendering/overlays/overlayWrapperComponent"; import { HeaderPosition } from "./headerRendering/header/headerPosition"; export interface StartEditingCellParams { rowIndex: number; colKey: string | Column; rowPinned?: string; keyPress?: number; charPress?: string; } export interface GetCellsParams { rowNodes?: RowNode[]; columns?: (string | Column)[]; } export interface RefreshCellsParams extends GetCellsParams { force?: boolean; suppressFlash?: boolean; } export interface FlashCellsParams extends GetCellsParams { flashDelay?: number; fadeDelay?: number; } export interface GetCellRendererInstancesParams extends GetCellsParams { } export interface GetCellEditorInstancesParams extends GetCellsParams { } export interface RedrawRowsParams { rowNodes?: RowNode[]; } export interface CreateRangeChartParams { cellRange: CellRangeParams; chartType: ChartType; chartThemeName?: string; chartContainer?: HTMLElement; suppressChartRanges?: boolean; aggFunc?: string | IAggFunc; chartThemeOverrides?: AgChartThemeOverrides; unlinkChart?: boolean; /** @deprecated since v24.0.0, use `chartThemeOverrides` instead */ processChartOptions?: (params: ProcessChartOptionsParams) => ChartOptions<any>; } export interface CreatePivotChartParams { chartType: ChartType; chartThemeName?: string; chartContainer?: HTMLElement; chartThemeOverrides?: AgChartThemeOverrides; unlinkChart?: boolean; /** @deprecated since v24.0.0, use `chartThemeOverrides` instead */ processChartOptions?: (params: ProcessChartOptionsParams) => ChartOptions<any>; } export interface CreateCrossFilterChartParams { cellRange: CellRangeParams; chartType: ChartType; chartThemeName?: string; chartContainer?: HTMLElement; suppressChartRanges?: boolean; aggFunc?: string | IAggFunc; chartThemeOverrides?: AgChartThemeOverrides; unlinkChart?: boolean; } export interface DetailGridInfo { api?: GridApi; columnApi?: ColumnApi; id: string; } export declare class GridApi { private immutableService; private csvCreator; private excelCreator; private rowRenderer; private filterManager; private columnController; private selectionController; private gridOptionsWrapper; private valueService; private alignedGridsService; private eventService; private pinnedRowModel; private context; private rowModel; private sortController; private paginationProxy; private focusController; private dragAndDropService; private rangeController; private clipboardService; private aggFuncService; private menuFactory; private contextMenuFactory; private valueCache; private animationFrameService; private statusBarService; private chartService; private undoRedoService; private headlessService; private rowNodeBlockLoader; private serverSideTransactionManager; private controllersService; private overlayWrapperComp; private gridBodyComp; private gridBodyCon; private gridCompController; private sideBarComp; private headerRootComp; private clientSideRowModel; private infiniteRowModel; private serverSideRowModel; private detailGridInfoMap; private destroyCalled; registerGridComp(gridBodyComp: GridBodyComp): void; registerOverlayWrapperComp(overlayWrapperComp: OverlayWrapperComponent): void; registerGridCompController(gridCompController: GridCompController): void; registerHeaderRootComp(headerRootComp: HeaderRootComp): void; registerSideBarComp(sideBarComp: ISideBar): void; private init; /** Used internally by grid. Not intended to be used by the client. Interface may change between releases. */ __getAlignedGridService(): AlignedGridsService; addDetailGridInfo(id: string, gridInfo: DetailGridInfo): void; removeDetailGridInfo(id: string): void; getDetailGridInfo(id: string): DetailGridInfo | undefined; forEachDetailGridInfo(callback: (gridInfo: DetailGridInfo, index: number) => void): void; getDataAsCsv(params?: CsvExportParams): string | undefined; exportDataAsCsv(params?: CsvExportParams): void; getDataAsExcel(params?: ExcelExportParams): string | Blob | undefined; exportDataAsExcel(params?: ExcelExportParams): void; getSheetDataForExcel(params?: ExcelExportParams): string | undefined; getMultipleSheetsAsExcel(params: ExcelExportMultipleSheetParams): Blob | undefined; exportMultipleSheetsAsExcel(params: ExcelExportMultipleSheetParams): void; /** @deprecated */ setEnterpriseDatasource(datasource: IServerSideDatasource): void; setGridAriaProperty(property: string, value: string | null): void; setServerSideDatasource(datasource: IServerSideDatasource): void; setDatasource(datasource: IDatasource): void; setViewportDatasource(viewportDatasource: IViewportDatasource): void; setRowData(rowData: any[]): void; /** @deprecated */ setFloatingTopRowData(rows: any[]): void; /** @deprecated */ setFloatingBottomRowData(rows: any[]): void; /** @deprecated */ getFloatingTopRowCount(): number; /** @deprecated */ getFloatingBottomRowCount(): number; /** @deprecated */ getFloatingTopRow(index: number): RowNode; /** @deprecated */ getFloatingBottomRow(index: number): RowNode; setPinnedTopRowData(rows: any[]): void; setPinnedBottomRowData(rows: any[]): void; getPinnedTopRowCount(): number; getPinnedBottomRowCount(): number; getPinnedTopRow(index: number): RowNode; getPinnedBottomRow(index: number): RowNode; setColumnDefs(colDefs: (ColDef | ColGroupDef)[], source?: ColumnEventType): void; setAutoGroupColumnDef(colDef: ColDef, source?: ColumnEventType): void; expireValueCache(): void; getVerticalPixelRange(): { top: number; bottom: number; }; getHorizontalPixelRange(): { left: number; right: number; }; setAlwaysShowHorizontalScroll(show: boolean): void; setAlwaysShowVerticalScroll(show: boolean): void; refreshToolPanel(): void; refreshCells(params?: RefreshCellsParams): void; flashCells(params?: FlashCellsParams): void; redrawRows(params?: RedrawRowsParams): void; /** @deprecated */ refreshView(): void; /** @deprecated */ refreshRows(rowNodes: RowNode[]): void; /** @deprecated */ rowDataChanged(rows: any): void; /** @deprecated */ softRefreshView(): void; /** @deprecated */ refreshGroupRows(): void; setFunctionsReadOnly(readOnly: boolean): void; refreshHeader(): void; isAnyFilterPresent(): boolean; /** @deprecated */ isAdvancedFilterPresent(): boolean; isColumnFilterPresent(): boolean; isQuickFilterPresent(): boolean; getModel(): IRowModel; setRowNodeExpanded(rowNode: RowNode, expanded: boolean): void; onGroupExpandedOrCollapsed(deprecated_refreshFromIndex?: any): void; refreshInMemoryRowModel(step?: string): any; refreshClientSideRowModel(step?: string): any; isAnimationFrameQueueEmpty(): boolean; getRowNode(id: string): RowNode | null; getSizesForCurrentTheme(): { rowHeight: number; headerHeight: number | null | undefined; }; expandAll(): void; collapseAll(): void; getToolPanelInstance(id: string): IToolPanel | undefined; addVirtualRowListener(eventName: string, rowIndex: number, callback: Function): void; addRenderedRowListener(eventName: string, rowIndex: number, callback: Function): void; setQuickFilter(newFilter: any): void; selectIndex(index: any, tryMulti: any, suppressEvents: any): void; deselectIndex(index: number, suppressEvents?: boolean): void; selectNode(node: RowNode, tryMulti?: boolean, suppressEvents?: boolean): void; deselectNode(node: RowNode, suppressEvents?: boolean): void; selectAll(): void; deselectAll(): void; selectAllFiltered(): void; deselectAllFiltered(): void; recomputeAggregates(): void; sizeColumnsToFit(): void; showLoadingOverlay(): void; showNoRowsOverlay(): void; hideOverlay(): void; isNodeSelected(node: any): any; getSelectedNodesById(): { [nodeId: number]: RowNode; } | null; getSelectedNodes(): RowNode[]; getSelectedRows(): any[]; getBestCostNodeSelection(): any; getRenderedNodes(): RowNode[]; ensureColIndexVisible(index: any): void; ensureColumnVisible(key: string | Column): void; ensureIndexVisible(index: any, position?: string | null): void; ensureNodeVisible(comparator: any, position?: string | null): void; forEachLeafNode(callback: (rowNode: RowNode) => void): void; forEachNode(callback: (rowNode: RowNode, index: number) => void): void; forEachNodeAfterFilter(callback: (rowNode: RowNode, index: number) => void): void; forEachNodeAfterFilterAndSort(callback: (rowNode: RowNode, index: number) => void): void; getFilterApiForColDef(colDef: any): any; getFilterInstance(key: string | Column, callback?: (filter: IFilterComp) => void): IFilterComp | null | undefined; getFilterApi(key: string | Column): IFilterComp | null | undefined; destroyFilter(key: string | Column): void; getStatusPanel(key: string): IStatusPanelComp | undefined; getColumnDef(key: string | Column): ColDef | null; getColumnDefs(): (ColDef | ColGroupDef)[]; onFilterChanged(): void; onSortChanged(): void; setSortModel(sortModel: any, source?: ColumnEventType): void; getSortModel(): { colId: string | undefined; sort: string | null | undefined; }[]; setFilterModel(model: any): void; getFilterModel(): { [key: string]: any; }; getFocusedCell(): CellPosition | null; clearFocusedCell(): void; setFocusedCell(rowIndex: number, colKey: string | Column, floating?: string): void; setSuppressRowDrag(value: boolean): void; setSuppressMoveWhenRowDragging(value: boolean): void; setSuppressRowClickSelection(value: boolean): void; addRowDropZone(params: RowDropZoneParams): void; removeRowDropZone(params: RowDropZoneParams): void; getRowDropZoneParams(events: RowDropZoneEvents): RowDropZoneParams; setHeaderHeight(headerHeight?: number): void; setDomLayout(domLayout: string): void; setEnableCellTextSelection(selectable: boolean): void; setFillHandleDirection(direction: 'x' | 'y' | 'xy'): void; setGroupHeaderHeight(headerHeight: number): void; setFloatingFiltersHeight(headerHeight: number): void; setPivotGroupHeaderHeight(headerHeight: number): void; setIsExternalFilterPresent(isExternalFilterPresentFunc: () => boolean): void; setDoesExternalFilterPass(doesExternalFilterPassFunc: (node: RowNode) => boolean): void; setNavigateToNextCell(navigateToNextCellFunc: (params: NavigateToNextCellParams) => CellPosition): void; setTabToNextCell(tabToNextCellFunc: (params: TabToNextCellParams) => CellPosition): void; setTabToNextHeader(tabToNextHeaderFunc: (params: TabToNextHeaderParams) => HeaderPosition): void; setNavigateToNextHeader(navigateToNextHeaderFunc: (params: NavigateToNextHeaderParams) => HeaderPosition): void; setGroupRowAggNodes(groupRowAggNodesFunc: (nodes: RowNode[]) => any): void; setGetBusinessKeyForNode(getBusinessKeyForNodeFunc: (nodes: RowNode) => string): void; setGetChildCount(getChildCountFunc: (dataItem: any) => number): void; setProcessRowPostCreate(processRowPostCreateFunc: (params: ProcessRowParams) => void): void; setGetRowNodeId(getRowNodeIdFunc: GetRowNodeIdFunc): void; setGetRowClass(rowClassFunc: (params: any) => string | string[]): void; setIsFullWidthCell(isFullWidthCellFunc: (rowNode: RowNode) => boolean): void; setIsRowSelectable(isRowSelectableFunc: IsRowSelectable): void; setIsRowMaster(isRowMasterFunc: IsRowMaster): void; setPostSort(postSortFunc: (nodes: RowNode[]) => void): void; setGetDocument(getDocumentFunc: () => Document): void; setGetContextMenuItems(getContextMenuItemsFunc: GetContextMenuItems): void; setGetMainMenuItems(getMainMenuItemsFunc: GetMainMenuItems): void; setProcessCellForClipboard(processCellForClipboardFunc: (params: ProcessCellForExportParams) => any): void; setSendToClipboard(sendToClipboardFunc: (params: any) => void): void; setProcessCellFromClipboard(processCellFromClipboardFunc: (params: ProcessCellForExportParams) => any): void; setProcessSecondaryColDef(processSecondaryColDefFunc: (colDef: ColDef) => void): void; setProcessSecondaryColGroupDef(processSecondaryColGroupDefFunc: (colDef: ColDef) => void): void; setPostProcessPopup(postProcessPopupFunc: (params: PostProcessPopupParams) => void): void; setDefaultGroupSortComparator(defaultGroupSortComparatorFunc: (nodeA: RowNode, nodeB: RowNode) => number): void; setProcessChartOptions(processChartOptionsFunc: (params: ProcessChartOptionsParams) => ChartOptions<any>): void; setGetChartToolbarItems(getChartToolbarItemsFunc: GetChartToolbarItems): void; setPaginationNumberFormatter(paginationNumberFormatterFunc: (params: PaginationNumberFormatterParams) => string): void; setGetServerSideStoreParams(getServerSideStoreParamsFunc: (params: GetServerSideStoreParamsParams) => ServerSideStoreParams): void; setIsServerSideGroupOpenByDefault(isServerSideGroupOpenByDefaultFunc: (params: IsServerSideGroupOpenByDefaultParams) => boolean): void; setIsApplyServerSideTransaction(isApplyServerSideTransactionFunc: IsApplyServerSideTransaction): void; setIsServerSideGroup(isServerSideGroupFunc: IsServerSideGroup): void; setGetServerSideGroupKey(getServerSideGroupKeyFunc: GetServerSideGroupKey): void; setGetRowStyle(rowStyleFunc: (params: any) => {}): void; setGetRowHeight(rowHeightFunc: (params: any) => number): void; setPivotHeaderHeight(headerHeight: number): void; isSideBarVisible(): boolean; setSideBarVisible(show: boolean): void; setSideBarPosition(position: 'left' | 'right'): void; openToolPanel(key: string): void; closeToolPanel(): void; getOpenedToolPanel(): string | null; getSideBar(): SideBarDef; setSideBar(def: SideBarDef): void; setSuppressClipboardPaste(value: boolean): void; isToolPanelShowing(): boolean; doLayout(): void; resetRowHeights(): void; setGroupRemoveSingleChildren(value: boolean): void; setGroupRemoveLowestSingleChildren(value: boolean): void; onRowHeightChanged(): void; getValue(colKey: string | Column, rowNode: RowNode): any; addEventListener(eventType: string, listener: Function): void; addGlobalListener(listener: Function): void; removeEventListener(eventType: string, listener: Function): void; removeGlobalListener(listener: Function): void; dispatchEvent(event: AgEvent): void; destroy(): void; private cleanDownReferencesToAvoidMemoryLeakInCaseApplicationIsKeepingReferenceToDestroyedGrid; private warnIfDestroyed; resetQuickFilter(): void; getRangeSelections(): any; getCellRanges(): CellRange[] | null; camelCaseToHumanReadable(camelCase: string): string | null; addRangeSelection(deprecatedNoLongerUsed: any): void; addCellRange(params: CellRangeParams): void; clearRangeSelection(): void; undoCellEditing(): void; redoCellEditing(): void; getCurrentUndoSize(): number; getCurrentRedoSize(): number; getChartModels(): ChartModel[] | undefined; createRangeChart(params: CreateRangeChartParams): ChartRef | undefined; createCrossFilterChart(params: CreateRangeChartParams): ChartRef | undefined; restoreChart(chartModel: ChartModel, chartContainer?: HTMLElement): ChartRef | undefined; createPivotChart(params: CreatePivotChartParams): ChartRef | undefined; copySelectedRowsToClipboard(includeHeader: boolean, columnKeys?: (string | Column)[]): void; copySelectedRangeToClipboard(includeHeader: boolean): void; copySelectedRangeDown(): void; showColumnMenuAfterButtonClick(colKey: string | Column, buttonElement: HTMLElement): void; showColumnMenuAfterMouseClick(colKey: string | Column, mouseEvent: MouseEvent | Touch): void; hidePopupMenu(): void; setPopupParent(ePopupParent: HTMLElement): void; tabToNextCell(): boolean; tabToPreviousCell(): boolean; getCellRendererInstances(params?: GetCellRendererInstancesParams): ICellRendererComp[]; getCellEditorInstances(params?: GetCellEditorInstancesParams): ICellEditorComp[]; getEditingCells(): CellPosition[]; stopEditing(cancel?: boolean): void; startEditingCell(params: StartEditingCellParams): void; addAggFunc(key: string, aggFunc: IAggFunc): void; addAggFuncs(aggFuncs: { [key: string]: IAggFunc; }): void; clearAggFuncs(): void; applyServerSideTransaction(transaction: ServerSideTransaction): ServerSideTransactionResult | undefined; applyServerSideTransactionAsync(transaction: ServerSideTransaction, callback?: (res: ServerSideTransactionResult) => void): void; retryServerSideLoads(): void; flushServerSideAsyncTransactions(): void; applyTransaction(rowDataTransaction: RowDataTransaction): RowNodeTransaction | null | undefined; /** @deprecated */ updateRowData(rowDataTransaction: RowDataTransaction): RowNodeTransaction | null | undefined; applyTransactionAsync(rowDataTransaction: RowDataTransaction, callback?: (res: RowNodeTransaction) => void): void; flushAsyncTransactions(): void; /** @deprecated */ batchUpdateRowData(rowDataTransaction: RowDataTransaction, callback?: (res: RowNodeTransaction) => void): void; insertItemsAtIndex(index: number, items: any[], skipRefresh?: boolean): void; removeItems(rowNodes: RowNode[], skipRefresh?: boolean): void; addItems(items: any[], skipRefresh?: boolean): void; refreshVirtualPageCache(): void; refreshInfinitePageCache(): void; refreshInfiniteCache(): void; purgeVirtualPageCache(): void; purgeInfinitePageCache(): void; purgeInfiniteCache(): void; /** @deprecated */ purgeEnterpriseCache(route?: string[]): void; /** @deprecated */ purgeServerSideCache(route?: string[]): void; refreshServerSideStore(params: RefreshStoreParams): void; getServerSideStoreState(): ServerSideStoreState[]; getVirtualRowCount(): number | null | undefined; getInfiniteRowCount(): number | undefined; isMaxRowFound(): boolean | undefined; isLastRowIndexKnown(): boolean | undefined; setVirtualRowCount(rowCount: number, maxRowFound?: boolean): void; setInfiniteRowCount(rowCount: number, maxRowFound?: boolean): void; setRowCount(rowCount: number, maxRowFound?: boolean): void; getVirtualPageState(): any; getInfinitePageState(): any; getCacheBlockState(): any; checkGridSize(): void; getFirstRenderedRow(): number; getFirstDisplayedRow(): number; getLastRenderedRow(): number; getLastDisplayedRow(): number; getDisplayedRowAtIndex(index: number): RowNode | null; getDisplayedRowCount(): number; paginationIsLastPageFound(): boolean; paginationGetPageSize(): number; paginationSetPageSize(size?: number): void; paginationGetCurrentPage(): number; paginationGetTotalPages(): number; paginationGetRowCount(): number; paginationGoToNextPage(): void; paginationGoToPreviousPage(): void; paginationGoToFirstPage(): void; paginationGoToLastPage(): void; paginationGoToPage(page: number): void; }