ag-grid-community 33.2.4 → 33.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.txt +1 -1
- package/dist/ag-grid-community.js +2799 -1373
- package/dist/ag-grid-community.min.js +1 -1
- package/dist/ag-grid-community.min.noStyle.js +1 -1
- package/dist/ag-grid-community.noStyle.js +2775 -1349
- package/dist/package/main.cjs.js +8919 -7704
- package/dist/package/main.cjs.min.js +32 -33
- package/dist/package/main.esm.min.mjs +32 -33
- package/dist/package/main.esm.mjs +8919 -7704
- package/dist/package/package.json +34 -3
- package/dist/types/package.json +34 -3
- package/dist/types/src/api/coreApi.d.ts +2 -0
- package/dist/types/src/api/gridApi.d.ts +663 -147
- package/dist/types/src/clientSideRowModel/clientSideRowModel.d.ts +2 -6
- package/dist/types/src/columnMove/columnDrag/moveColumnFeature.d.ts +1 -0
- package/dist/types/src/columns/columnFactoryUtils.d.ts +12 -4
- package/dist/types/src/columns/columnGroups/columnGroupService.d.ts +3 -4
- package/dist/types/src/columns/columnGroups/columnGroupUtils.d.ts +3 -0
- package/dist/types/src/columns/columnKeyCreator.d.ts +4 -1
- package/dist/types/src/columns/columnModel.d.ts +13 -1
- package/dist/types/src/columns/columnViewportService.d.ts +1 -1
- package/dist/types/src/columns/selectionColService.d.ts +13 -2
- package/dist/types/src/components/framework/userCompUtils.d.ts +1 -1
- package/dist/types/src/context/context.d.ts +6 -4
- package/dist/types/src/dragAndDrop/rowDragFeature.d.ts +19 -3
- package/dist/types/src/edit/cell-editing.css-GENERATED.d.ts +1 -1
- package/dist/types/src/entities/agProvidedColumnGroup.d.ts +1 -0
- package/dist/types/src/entities/colDef.d.ts +79 -13
- package/dist/types/src/entities/gridOptions.d.ts +250 -16
- package/dist/types/src/entities/rowNode.d.ts +6 -0
- package/dist/types/src/entities/rowNodeUtils.d.ts +3 -1
- package/dist/types/src/environment.d.ts +3 -5
- package/dist/types/src/eventService.d.ts +1 -1
- package/dist/types/src/eventTypes.d.ts +2 -2
- package/dist/types/src/events.d.ts +14 -0
- package/dist/types/src/export/baseGridSerializingSession.d.ts +2 -6
- package/dist/types/src/filter/column-filters.css-GENERATED.d.ts +1 -1
- package/dist/types/src/filter/filterManager.d.ts +2 -1
- package/dist/types/src/filter/filterMenuFactory.d.ts +3 -2
- package/dist/types/src/filter/provided/iSimpleFilter.d.ts +1 -1
- package/dist/types/src/filter/provided/number/iNumberFilter.d.ts +1 -1
- package/dist/types/src/gridBodyComp/gridBodyCtrl.d.ts +1 -0
- package/dist/types/src/gridBodyComp/gridBodyScrollFeature.d.ts +3 -1
- package/dist/types/src/gridOptionsService.d.ts +7 -0
- package/dist/types/src/gridOptionsUtils.d.ts +2 -1
- package/dist/types/src/headerRendering/cells/abstractCell/abstractHeaderCellComp.d.ts +1 -1
- package/dist/types/src/headerRendering/cells/abstractCell/abstractHeaderCellCtrl.d.ts +1 -1
- package/dist/types/src/headerRendering/cells/column/headerCellCtrl.d.ts +1 -1
- package/dist/types/src/headerRendering/cells/column/headerComp.d.ts +11 -101
- package/dist/types/src/headerRendering/cells/columnGroup/headerGroupComp.d.ts +24 -1
- package/dist/types/src/headerRendering/gridHeaderCtrl.d.ts +1 -1
- package/dist/types/src/interfaces/agFieldParams.d.ts +1 -1
- package/dist/types/src/interfaces/gridState.d.ts +8 -0
- package/dist/types/src/interfaces/groupCellRenderer.d.ts +1 -1
- package/dist/types/src/interfaces/iClientSideRowModel.d.ts +2 -3
- package/dist/types/src/interfaces/iDragItem.d.ts +3 -1
- package/dist/types/src/interfaces/iFind.d.ts +1 -4
- package/dist/types/src/interfaces/iFooterService.d.ts +4 -0
- package/dist/types/src/interfaces/iFrameworkEventListenerService.d.ts +7 -2
- package/dist/types/src/interfaces/iHeader.d.ts +90 -0
- package/dist/types/src/interfaces/iMenuFactory.d.ts +2 -2
- package/dist/types/src/interfaces/iModule.d.ts +3 -0
- package/dist/types/src/interfaces/iPinnedRowModel.d.ts +51 -0
- package/dist/types/src/interfaces/iRowNode.d.ts +4 -1
- package/dist/types/src/interfaces/iSetFilter.d.ts +1 -1
- package/dist/types/src/interfaces/iShowRowGroupColsValueService.d.ts +13 -0
- package/dist/types/src/interfaces/masterDetail.d.ts +2 -2
- package/dist/types/src/interfaces/menuItem.d.ts +1 -1
- package/dist/types/src/interfaces/rowNumbers.d.ts +11 -0
- package/dist/types/src/localEventService.d.ts +1 -0
- package/dist/types/src/main-umd-noStyles.d.ts +1 -0
- package/dist/types/src/main.d.ts +20 -15
- package/dist/types/src/misc/state/stateService.d.ts +2 -0
- package/dist/types/src/misc/state/stateUtils.d.ts +22 -0
- package/dist/types/src/misc/touchService.d.ts +2 -1
- package/dist/types/src/modules/moduleRegistry.d.ts +3 -1
- package/dist/types/src/pinnedRowModel/manualPinnedRow.css-GENERATED.d.ts +1 -0
- package/dist/types/src/pinnedRowModel/manualPinnedRowModel.d.ts +43 -0
- package/dist/types/src/pinnedRowModel/manualPinnedRowUtils.d.ts +34 -0
- package/dist/types/src/pinnedRowModel/pinnedRowApi.d.ts +2 -1
- package/dist/types/src/pinnedRowModel/pinnedRowModel.d.ts +17 -19
- package/dist/types/src/pinnedRowModel/pinnedRowModule.d.ts +1 -1
- package/dist/types/src/pinnedRowModel/pinnedRowUtils.d.ts +6 -0
- package/dist/types/src/pinnedRowModel/staticPinnedRowModel.d.ts +39 -0
- package/dist/types/src/propertyKeys.d.ts +1 -1
- package/dist/types/src/rendering/cell/cellComp.d.ts +1 -1
- package/dist/types/src/rendering/cell/cellCtrl.d.ts +9 -3
- package/dist/types/src/rendering/cell/cellFlashService.d.ts +6 -1
- package/dist/types/src/rendering/cssClassManager.d.ts +1 -4
- package/dist/types/src/rendering/row/rowAutoHeightService.d.ts +5 -0
- package/dist/types/src/rendering/row/rowCtrl.d.ts +3 -1
- package/dist/types/src/rendering/rowRenderer.d.ts +2 -1
- package/dist/types/src/selection/baseSelectionService.d.ts +1 -0
- package/dist/types/src/selection/rowRangeSelectionContext.d.ts +9 -5
- package/dist/types/src/selection/selectAllFeature.d.ts +0 -2
- package/dist/types/src/selection/selectionService.d.ts +3 -1
- package/dist/types/src/sort/sortIndicatorComp.d.ts +6 -6
- package/dist/types/src/theming/core/core-css.d.ts +24 -0
- package/dist/types/src/theming/core/core.css-GENERATED.d.ts +1 -1
- package/dist/types/src/theming/parts/icon-set/alpine/icon-set-alpine.css-GENERATED.d.ts +1 -1
- package/dist/types/src/theming/parts/icon-set/balham/icon-set-balham.css-GENERATED.d.ts +1 -1
- package/dist/types/src/theming/parts/icon-set/material/icon-set-material.css-GENERATED.d.ts +1 -1
- package/dist/types/src/theming/parts/input-style/input-style-base.css-GENERATED.d.ts +1 -1
- package/dist/types/src/theming/parts/input-style/input-style-bordered.css-GENERATED.d.ts +1 -1
- package/dist/types/src/theming/parts/input-style/input-style-underlined.css-GENERATED.d.ts +1 -1
- package/dist/types/src/theming/parts/theme/material-adjustments.css-GENERATED.d.ts +1 -1
- package/dist/types/src/utils/dom.d.ts +2 -2
- package/dist/types/src/utils/icon.d.ts +2 -2
- package/dist/types/src/utils/string.d.ts +6 -1
- package/dist/types/src/validation/errorMessages/errorText.d.ts +16 -1
- package/dist/types/src/validation/rules/colDefValidations.d.ts +2 -1
- package/dist/types/src/validation/rules/gridOptionsValidations.d.ts +2 -0
- package/dist/types/src/validation/validationService.d.ts +2 -3
- package/dist/types/src/validation/validationTypes.d.ts +8 -6
- package/dist/types/src/valueService/valueService.d.ts +4 -14
- package/dist/types/src/version.d.ts +1 -1
- package/dist/types/src/widgets/agAbstractField.d.ts +1 -1
- package/dist/types/src/widgets/component.d.ts +4 -5
- package/package.json +34 -3
- package/styles/_css-content.scss +227 -21
- package/styles/_icon-font-codes.scss +4 -0
- package/styles/ag-grid-no-native-widgets.css +109 -6
- package/styles/ag-grid-no-native-widgets.min.css +3 -3
- package/styles/ag-grid.css +109 -6
- package/styles/ag-grid.min.css +3 -3
- package/styles/ag-theme-alpine.css +1 -1
- package/styles/ag-theme-alpine.min.css +1 -1
- package/styles/ag-theme-balham.css +1 -1
- package/styles/ag-theme-balham.min.css +1 -1
- package/styles/ag-theme-material.css +1 -1
- package/styles/ag-theme-material.min.css +1 -1
- package/styles/ag-theme-quartz.css +1 -1
- package/styles/ag-theme-quartz.min.css +1 -1
- package/styles/agGridAlpineFont.css +1 -1
- package/styles/agGridAlpineFont.min.css +1 -1
- package/styles/agGridBalhamFont.css +1 -1
- package/styles/agGridBalhamFont.min.css +1 -1
- package/styles/agGridClassicFont.css +1 -1
- package/styles/agGridClassicFont.min.css +1 -1
- package/styles/agGridMaterialFont.css +1 -1
- package/styles/agGridMaterialFont.min.css +1 -1
- package/styles/agGridQuartzFont.css +1 -1
- package/styles/agGridQuartzFont.min.css +1 -1
- package/dist/types/src/validation/rules/menuItemValidations.d.ts +0 -3
|
@@ -25,6 +25,7 @@ import type { ExcelExportMultipleSheetParams, ExcelExportParams } from '../inter
|
|
|
25
25
|
import type { FilterModel, IFilter } from '../interfaces/iFilter';
|
|
26
26
|
import type { IFiltersToolPanel } from '../interfaces/iFiltersToolPanel';
|
|
27
27
|
import type { FindCellParams, FindCellValueParams, FindMatch, FindPart } from '../interfaces/iFind';
|
|
28
|
+
import type { AgModuleName } from '../interfaces/iModule';
|
|
28
29
|
import type { RedrawRowsParams } from '../interfaces/iRedrawRowsParams';
|
|
29
30
|
import type { IRowNode, RowPinnedType } from '../interfaces/iRowNode';
|
|
30
31
|
import type { LoadSuccessParams, RefreshServerSideParams } from '../interfaces/iServerSideRowModel';
|
|
@@ -83,10 +84,15 @@ export interface _CoreGridApi<TData = any> {
|
|
|
83
84
|
* Updates the provided subset of gridOptions with the provided values. (Cannot be used on `Initial` properties.)
|
|
84
85
|
*/
|
|
85
86
|
updateGridOptions<TDataUpdate extends TData>(options: ManagedGridOptions<TDataUpdate>): void;
|
|
87
|
+
/**
|
|
88
|
+
* Check if a Module is registered with the current grid instance via its equivalent string name.
|
|
89
|
+
*/
|
|
90
|
+
isModuleRegistered(moduleName: AgModuleName): boolean;
|
|
86
91
|
}
|
|
87
92
|
export interface _RowSelectionGridApi<TData = any> {
|
|
88
93
|
/**
|
|
89
94
|
* Set all of the provided nodes selection state to the provided value.
|
|
95
|
+
* @agModule `RowSelectionModule`
|
|
90
96
|
*/
|
|
91
97
|
setNodesSelected(params: {
|
|
92
98
|
nodes: IRowNode<TData>[];
|
|
@@ -99,6 +105,8 @@ export interface _RowSelectionGridApi<TData = any> {
|
|
|
99
105
|
*
|
|
100
106
|
* @param mode SelectAll mode to use. See `SelectAllMode`
|
|
101
107
|
* @param source Source property that will appear in the `selectionChanged` event, defaults to `'apiSelectAll'`
|
|
108
|
+
*
|
|
109
|
+
* @agModule `RowSelectionModule`
|
|
102
110
|
*/
|
|
103
111
|
selectAll(mode?: SelectAllMode, source?: SelectionEventSourceType): void;
|
|
104
112
|
/**
|
|
@@ -107,6 +115,8 @@ export interface _RowSelectionGridApi<TData = any> {
|
|
|
107
115
|
*
|
|
108
116
|
* @param mode SelectAll mode to use. See `SelectAllMode`
|
|
109
117
|
* @param source Source property that will appear in the `selectionChanged` event, defaults to `'apiSelectAll'`
|
|
118
|
+
*
|
|
119
|
+
* @agModule `RowSelectionModule`
|
|
110
120
|
*/
|
|
111
121
|
deselectAll(mode?: SelectAllMode, source?: SelectionEventSourceType): void;
|
|
112
122
|
/**
|
|
@@ -141,9 +151,13 @@ export interface _RowSelectionGridApi<TData = any> {
|
|
|
141
151
|
* Returns an unsorted list of selected nodes.
|
|
142
152
|
* Getting the underlying node (rather than the data) is useful when working with tree / aggregated data,
|
|
143
153
|
* as the node can be traversed.
|
|
154
|
+
* @agModule `RowSelectionModule`
|
|
144
155
|
*/
|
|
145
156
|
getSelectedNodes(): IRowNode<TData>[];
|
|
146
|
-
/**
|
|
157
|
+
/**
|
|
158
|
+
* Returns an unsorted list of selected rows (i.e. row data that you provided).
|
|
159
|
+
* @agModule `RowSelectionModule`
|
|
160
|
+
*/
|
|
147
161
|
getSelectedRows(): TData[];
|
|
148
162
|
}
|
|
149
163
|
export interface _OverlayGridApi {
|
|
@@ -158,11 +172,15 @@ export interface _OverlayGridApi {
|
|
|
158
172
|
hideOverlay(): void;
|
|
159
173
|
}
|
|
160
174
|
export interface _RowGridApi<TData> {
|
|
161
|
-
/**
|
|
175
|
+
/**
|
|
176
|
+
* Remove row(s) from the DOM and recreate them again from scratch.
|
|
177
|
+
* @agModule `RowApiModule`
|
|
178
|
+
*/
|
|
162
179
|
redrawRows(params?: RedrawRowsParams<TData>): void;
|
|
163
180
|
/**
|
|
164
181
|
* Expand or collapse a specific row node, optionally expanding/collapsing all of its parent nodes.
|
|
165
|
-
* By default rows are expanded asynchronously for best performance. Set forceSync:
|
|
182
|
+
* By default rows are expanded asynchronously for best performance. Set `forceSync: true` if you need to interact with the expanded row immediately after this function.
|
|
183
|
+
* @agModule `RowApiModule`
|
|
166
184
|
*/
|
|
167
185
|
setRowNodeExpanded(rowNode: IRowNode<TData>, expanded: boolean, expandParents?: boolean, forceSync?: boolean): void;
|
|
168
186
|
/**
|
|
@@ -170,6 +188,7 @@ export interface _RowGridApi<TData> {
|
|
|
170
188
|
* The row node ID is the one you provide from the callback `getRowId(params)`,
|
|
171
189
|
* otherwise the ID is a number (cast as string) auto-generated by the grid when
|
|
172
190
|
* the row data is set.
|
|
191
|
+
* @agModule `RowApiModule`
|
|
173
192
|
*/
|
|
174
193
|
getRowNode(id: string): IRowNode<TData> | undefined;
|
|
175
194
|
/**
|
|
@@ -178,24 +197,42 @@ export interface _RowGridApi<TData> {
|
|
|
178
197
|
* Unlike normal events, you do not need to unregister rendered row listeners.
|
|
179
198
|
* When the rendered row is removed from the grid, all associated rendered row listeners will also be removed.
|
|
180
199
|
* listen for this event if your `cellRenderer` needs to do cleanup when the row no longer exists.
|
|
200
|
+
* @agModule `RowApiModule`
|
|
181
201
|
*/
|
|
182
202
|
addRenderedRowListener(eventName: RenderedRowEvent, rowIndex: number, callback: (...args: any[]) => any): void;
|
|
183
|
-
/**
|
|
203
|
+
/**
|
|
204
|
+
* Retrieve rendered nodes. Due to virtualisation this will contain only the current visible rows and those in the buffer.
|
|
205
|
+
* @agModule `RowApiModule`
|
|
206
|
+
*/
|
|
184
207
|
getRenderedNodes(): IRowNode<TData>[];
|
|
185
208
|
/**
|
|
186
209
|
* Iterates through each node (row) in the grid and calls the callback for each node.
|
|
187
210
|
* This works similar to the `forEach` method on a JavaScript array.
|
|
188
211
|
* This is called for every node, ignoring any filtering or sorting applied within the grid.
|
|
212
|
+
* It is not called on any pinned row nodes.
|
|
189
213
|
* If using the Infinite Row Model, then this gets called for each page loaded in the page cache.
|
|
214
|
+
* @agModule `RowApiModule`
|
|
190
215
|
*/
|
|
191
216
|
forEachNode(callback: (rowNode: IRowNode<TData>, index: number) => void, includeFooterNodes?: boolean): void;
|
|
192
|
-
/**
|
|
217
|
+
/**
|
|
218
|
+
* Get the index of the first displayed row due to scrolling (includes invisible rendered rows in the buffer).
|
|
219
|
+
* @agModule `RowApiModule`
|
|
220
|
+
*/
|
|
193
221
|
getFirstDisplayedRowIndex(): number;
|
|
194
|
-
/**
|
|
222
|
+
/**
|
|
223
|
+
* Get the index of the last displayed row due to scrolling (includes invisible rendered rows in the buffer).
|
|
224
|
+
* @agModule `RowApiModule`
|
|
225
|
+
*/
|
|
195
226
|
getLastDisplayedRowIndex(): number;
|
|
196
|
-
/**
|
|
227
|
+
/**
|
|
228
|
+
* Returns the displayed `RowNode` at the given `index`.
|
|
229
|
+
* @agModule `RowApiModule`
|
|
230
|
+
*/
|
|
197
231
|
getDisplayedRowAtIndex(index: number): IRowNode<TData> | undefined;
|
|
198
|
-
/**
|
|
232
|
+
/**
|
|
233
|
+
* Returns the total number of displayed rows.
|
|
234
|
+
* @agModule `RowApiModule`
|
|
235
|
+
*/
|
|
199
236
|
getDisplayedRowCount(): number;
|
|
200
237
|
}
|
|
201
238
|
export interface _ScrollGridApi<TData> {
|
|
@@ -203,6 +240,7 @@ export interface _ScrollGridApi<TData> {
|
|
|
203
240
|
* Returns an object with two properties:
|
|
204
241
|
* - `top`: The top pixel position of the current scroll in the grid
|
|
205
242
|
* - `bottom`: The bottom pixel position of the current scroll in the grid
|
|
243
|
+
* @agModule `ScrollApiModule`
|
|
206
244
|
*/
|
|
207
245
|
getVerticalPixelRange(): {
|
|
208
246
|
top: number;
|
|
@@ -212,6 +250,7 @@ export interface _ScrollGridApi<TData> {
|
|
|
212
250
|
* Returns an object with two properties:
|
|
213
251
|
* - `left`: The left pixel position of the current scroll in the grid
|
|
214
252
|
* - `right`: The right pixel position of the current scroll in the grid
|
|
253
|
+
* @agModule `ScrollApiModule`
|
|
215
254
|
*/
|
|
216
255
|
getHorizontalPixelRange(): {
|
|
217
256
|
left: number;
|
|
@@ -228,18 +267,21 @@ export interface _ScrollGridApi<TData> {
|
|
|
228
267
|
* - `start` - Scrolls the column to the start of the viewport.
|
|
229
268
|
* - `middle` - Scrolls the column to the middle of the viewport.
|
|
230
269
|
* - `end` - Scrolls the column to the end of the viewport.
|
|
270
|
+
* @agModule `ScrollApiModule`
|
|
231
271
|
*/
|
|
232
272
|
ensureColumnVisible(key: string | Column, position?: 'auto' | 'start' | 'middle' | 'end'): void;
|
|
233
273
|
/**
|
|
234
274
|
* Vertically scrolls the grid until the provided row index is inside the visible viewport.
|
|
235
275
|
* If a position is provided, the grid will attempt to scroll until the row is at the given position within the viewport.
|
|
236
276
|
* This will have no effect before the firstDataRendered event has fired.
|
|
277
|
+
* @agModule `ScrollApiModule`
|
|
237
278
|
*/
|
|
238
279
|
ensureIndexVisible(index: number, position?: 'top' | 'bottom' | 'middle' | null): void;
|
|
239
280
|
/**
|
|
240
281
|
* Vertically scrolls the grid until the provided row (or a row matching the provided comparator) is inside the visible viewport.
|
|
241
282
|
* If a position is provided, the grid will attempt to scroll until the row is at the given position within the viewport.
|
|
242
283
|
* This will have no effect before the firstDataRendered event has fired.
|
|
284
|
+
* @agModule `ScrollApiModule`
|
|
243
285
|
*/
|
|
244
286
|
ensureNodeVisible(nodeSelector: TData | IRowNode<TData> | ((row: IRowNode<TData>) => boolean), position?: 'top' | 'bottom' | 'middle' | null): void;
|
|
245
287
|
}
|
|
@@ -263,9 +305,13 @@ export interface _EventGridApi<TData> {
|
|
|
263
305
|
* Listener will receive the `event` as a single parameter.
|
|
264
306
|
* Listeners will be automatically removed when the grid is destroyed.
|
|
265
307
|
* @example api.addEventListener('rowClicked', (event) => { console.log('Row clicked', event);});
|
|
308
|
+
* @agModule `EventApiModule`
|
|
266
309
|
*/
|
|
267
310
|
addEventListener<TEventType extends AgPublicEventType>(eventType: TEventType, listener: AgEventListener<TData, any, TEventType>): void;
|
|
268
|
-
/**
|
|
311
|
+
/**
|
|
312
|
+
* Remove an event listener.
|
|
313
|
+
* @agModule `EventApiModule`
|
|
314
|
+
*/
|
|
269
315
|
removeEventListener<TEventType extends AgPublicEventType>(eventType: TEventType, listener: AgEventListener<TData, any, TEventType>): void;
|
|
270
316
|
/**
|
|
271
317
|
* Add an event listener for all event types coming from the grid.
|
|
@@ -273,19 +319,27 @@ export interface _EventGridApi<TData> {
|
|
|
273
319
|
* Listeners will be automatically removed when the grid is destroyed.
|
|
274
320
|
* If handling multiple event types it is recommended to use `event.type` to enable TypeScript to infer the event parameters.
|
|
275
321
|
* @example api.addGlobalListener((eventType, event) => { });
|
|
322
|
+
* @agModule `EventApiModule`
|
|
276
323
|
*/
|
|
277
324
|
addGlobalListener<TEventType extends AgPublicEventType>(listener: AgGlobalEventListener<TData, any, TEventType>): void;
|
|
278
|
-
/**
|
|
325
|
+
/**
|
|
326
|
+
* Remove a global event listener.
|
|
327
|
+
* @agModule `EventApiModule`
|
|
328
|
+
*/
|
|
279
329
|
removeGlobalListener<TEventType extends AgPublicEventType>(listener: AgGlobalEventListener<TData, any, TEventType>): void;
|
|
280
330
|
}
|
|
281
331
|
export interface _ValueCacheApi {
|
|
282
|
-
/**
|
|
332
|
+
/**
|
|
333
|
+
* Expire the value cache.
|
|
334
|
+
* @agModule `ValueCacheModule`
|
|
335
|
+
*/
|
|
283
336
|
expireValueCache(): void;
|
|
284
337
|
}
|
|
285
338
|
export interface _ValueApi<TData> {
|
|
286
339
|
/**
|
|
287
340
|
* Gets the cell value for the given column and `rowNode` (row).
|
|
288
341
|
* Based on params.useFormatter with either return the value as specified by the `field` or `valueGetter` on the column definition or the formatted value.
|
|
342
|
+
* @agModule `CellApiModule`
|
|
289
343
|
*/
|
|
290
344
|
getCellValue<TValue = any>(params: {
|
|
291
345
|
rowNode: IRowNode<TData>;
|
|
@@ -314,11 +368,13 @@ export interface _ClientSideRowModelGridApi<TData> {
|
|
|
314
368
|
* Informs the grid that row group expanded state has changed and it needs to rerender the group nodes.
|
|
315
369
|
* Typically called after updating the row node expanded state explicitly, i.e `rowNode.expanded = false`,
|
|
316
370
|
* across multiple groups and you want to update the grid view in a single rerender instead of on every group change.
|
|
371
|
+
* @agModule `ClientSideRowModelApiModule`
|
|
317
372
|
*/
|
|
318
373
|
onGroupExpandedOrCollapsed(): void;
|
|
319
374
|
/**
|
|
320
375
|
* Refresh the Client-Side Row Model, executing the grouping, filtering and sorting again.
|
|
321
376
|
* Optionally provide the step you wish the refresh to apply from. Defaults to `everything`.
|
|
377
|
+
* @agModule `ClientSideRowModelApiModule`
|
|
322
378
|
*/
|
|
323
379
|
refreshClientSideRowModel(step?: ClientSideRowModelStep): void;
|
|
324
380
|
/**
|
|
@@ -326,27 +382,50 @@ export interface _ClientSideRowModelGridApi<TData> {
|
|
|
326
382
|
* This effectively goes through all the data that you provided to the grid before the grid performed any grouping.
|
|
327
383
|
* If using tree data, goes through all the nodes for the data you provided, including nodes that have children,
|
|
328
384
|
* but excluding groups the grid created where gaps were missing in the hierarchy.
|
|
385
|
+
* @agModule `ClientSideRowModelApiModule`
|
|
329
386
|
*/
|
|
330
387
|
forEachLeafNode(callback: (rowNode: IRowNode<TData>) => void): void;
|
|
331
|
-
/**
|
|
388
|
+
/**
|
|
389
|
+
* Similar to `forEachNode`, except skips any filtered out data.
|
|
390
|
+
* @agModule `ClientSideRowModelApiModule`
|
|
391
|
+
*/
|
|
332
392
|
forEachNodeAfterFilter(callback: (rowNode: IRowNode<TData>, index: number) => void): void;
|
|
333
|
-
/**
|
|
393
|
+
/**
|
|
394
|
+
* Similar to `forEachNodeAfterFilter`, except the callbacks are called in the order the rows are displayed in the grid.
|
|
395
|
+
* @agModule `ClientSideRowModelApiModule`
|
|
396
|
+
*/
|
|
334
397
|
forEachNodeAfterFilterAndSort(callback: (rowNode: IRowNode<TData>, index: number) => void): void;
|
|
335
|
-
/**
|
|
398
|
+
/**
|
|
399
|
+
* Tells the grid to recalculate the row heights.
|
|
400
|
+
* @agModule `ClientSideRowModelApiModule`
|
|
401
|
+
*/
|
|
336
402
|
resetRowHeights(): void;
|
|
337
|
-
/**
|
|
403
|
+
/**
|
|
404
|
+
* Update row data. Pass a transaction object with lists for `add`, `remove` and `update`.
|
|
405
|
+
* @agModule `ClientSideRowModelApiModule`
|
|
406
|
+
*/
|
|
338
407
|
applyTransaction(rowDataTransaction: RowDataTransaction<TData>): RowNodeTransaction<TData> | null | undefined;
|
|
339
|
-
/**
|
|
408
|
+
/**
|
|
409
|
+
* Same as `applyTransaction` except executes asynchronously for efficiency.
|
|
410
|
+
* @agModule `ClientSideRowModelApiModule`
|
|
411
|
+
*/
|
|
340
412
|
applyTransactionAsync(rowDataTransaction: RowDataTransaction<TData>, callback?: (res: RowNodeTransaction<TData>) => void): void;
|
|
341
|
-
/**
|
|
413
|
+
/**
|
|
414
|
+
* Executes any remaining asynchronous grid transactions, if any are waiting to be executed.
|
|
415
|
+
* @agModule `ClientSideRowModelApiModule`
|
|
416
|
+
*/
|
|
342
417
|
flushAsyncTransactions(): void;
|
|
343
418
|
/**
|
|
344
419
|
* Returns a list of all selected nodes at 'best cost', a feature to be used with groups / trees.
|
|
345
420
|
* If a group has all its children selected, then the group appears in the result, but not the children.
|
|
346
421
|
* Designed for use with `'children'` as the group selection type, where groups don't actually appear in the selection normally.
|
|
422
|
+
* @agModule `ClientSideRowModelApiModule`
|
|
347
423
|
*/
|
|
348
424
|
getBestCostNodeSelection(): IRowNode<TData>[] | undefined;
|
|
349
|
-
/**
|
|
425
|
+
/**
|
|
426
|
+
* Returns `true` if the Client-Side row model has no rows. It is not impacted by filtering and does not include pinned rows.
|
|
427
|
+
* @agModule `ClientSideRowModelApiModule`
|
|
428
|
+
*/
|
|
350
429
|
isRowDataEmpty(): boolean;
|
|
351
430
|
}
|
|
352
431
|
export interface _CsrmSsrmSharedGridApi {
|
|
@@ -364,13 +443,19 @@ export interface _SsrmInfiniteSharedGridApi {
|
|
|
364
443
|
* Set `rowCount` to adjust the height of the vertical scroll.
|
|
365
444
|
* Set `maxRowFound` to enable / disable searching for more rows.
|
|
366
445
|
* Use this method if you add or remove rows into the dataset and need to reset the number of rows or instruct the grid that the entire row count is no longer known.
|
|
446
|
+
* @agModule `InfiniteRowModelModule / ServerSideRowModelApiModule`
|
|
367
447
|
*/
|
|
368
448
|
setRowCount(rowCount: number, maxRowFound?: boolean): void;
|
|
369
449
|
/**
|
|
370
450
|
* Returns an object representing the state of the cache. This is useful for debugging and understanding how the cache is working.
|
|
451
|
+
* @agModule `InfiniteRowModelModule / ServerSideRowModelApiModule`
|
|
371
452
|
*/
|
|
372
453
|
getCacheBlockState(): any;
|
|
373
|
-
/**
|
|
454
|
+
/**
|
|
455
|
+
* Returns `false` if grid allows for scrolling past the last row to load more rows, thus providing infinite scroll.
|
|
456
|
+
*
|
|
457
|
+
* @agModule `InfiniteRowModelModule / ServerSideRowModelApiModule`
|
|
458
|
+
*/
|
|
374
459
|
isLastRowIndexKnown(): boolean | undefined;
|
|
375
460
|
}
|
|
376
461
|
export interface _ColumnAutosizeApi {
|
|
@@ -385,6 +470,7 @@ export interface _ColumnAutosizeApi {
|
|
|
385
470
|
* and row data is initially empty or yet to be set,
|
|
386
471
|
* the column sizing will happen asynchronously when row data is added.
|
|
387
472
|
* To always perform this synchronously, set `cellDataType = false` on the default column definition.
|
|
473
|
+
* @agModule `ColumnAutoSizeModule`
|
|
388
474
|
**/
|
|
389
475
|
sizeColumnsToFit(paramsOrGridWidth?: ISizeColumnsToFitParams | number): void;
|
|
390
476
|
/**
|
|
@@ -392,6 +478,7 @@ export interface _ColumnAutosizeApi {
|
|
|
392
478
|
* and row data is initially empty or yet to be set,
|
|
393
479
|
* the column sizing will happen asynchronously when row data is added.
|
|
394
480
|
* To always perform this synchronously, set `cellDataType = false` on the default column definition.
|
|
481
|
+
* @agModule `ColumnAutoSizeModule`
|
|
395
482
|
*/
|
|
396
483
|
autoSizeColumns(keys: (string | ColDef | Column)[], skipHeader?: boolean): void;
|
|
397
484
|
/**
|
|
@@ -399,6 +486,7 @@ export interface _ColumnAutosizeApi {
|
|
|
399
486
|
* and row data is initially empty or yet to be set,
|
|
400
487
|
* the column sizing will happen asynchronously when row data is added.
|
|
401
488
|
* To always perform this synchronously, set `cellDataType = false` on the default column definition.
|
|
489
|
+
* @agModule `ColumnAutoSizeModule`
|
|
402
490
|
*/
|
|
403
491
|
autoSizeAllColumns(skipHeader?: boolean): void;
|
|
404
492
|
}
|
|
@@ -416,40 +504,87 @@ export interface _ColumnMoveApi {
|
|
|
416
504
|
moveColumns(columnsToMoveKeys: (string | ColDef | Column)[], toIndex: number): void;
|
|
417
505
|
}
|
|
418
506
|
export interface _ColumnHoverApi {
|
|
419
|
-
/**
|
|
507
|
+
/**
|
|
508
|
+
* Returns true if the column is currently hovered.
|
|
509
|
+
* @agModule `ColumnHoverModule`
|
|
510
|
+
*/
|
|
420
511
|
isColumnHovered(column: Column): boolean;
|
|
421
512
|
}
|
|
422
513
|
export interface _ColumnGridApi<TData> {
|
|
423
514
|
/**
|
|
424
515
|
* Returns the current column definitions.
|
|
516
|
+
* @agModule `ColumnApiModule`
|
|
425
517
|
*/
|
|
426
518
|
getColumnDefs(): (ColDef<TData> | ColGroupDef<TData>)[] | undefined;
|
|
519
|
+
/**
|
|
520
|
+
* Returns the column definition with the given `colKey`, which can either be the `colId` (a string) or the column instance.
|
|
521
|
+
* @agModule `ColumnApiModule`
|
|
522
|
+
*/
|
|
427
523
|
getColumnDef<TValue = any>(key: string | Column<TValue>): ColDef<TData, TValue> | null;
|
|
428
|
-
/**
|
|
524
|
+
/**
|
|
525
|
+
* Returns the display name for a column. Useful if you are doing your own header rendering and want the grid to work out if `headerValueGetter` is used, or if you are doing your own column management GUI, to know what to show as the column name.
|
|
526
|
+
* @agModule `ColumnApiModule`
|
|
527
|
+
*/
|
|
429
528
|
getDisplayNameForColumn(column: Column, location: HeaderLocation): string;
|
|
430
|
-
/**
|
|
529
|
+
/**
|
|
530
|
+
* Returns the column with the given `colKey`, which can either be the `colId` (a string) or the `colDef` (an object).
|
|
531
|
+
* @agModule `ColumnApiModule`
|
|
532
|
+
*/
|
|
431
533
|
getColumn<TValue = any>(key: string | ColDef<TData, TValue> | Column<TValue>): Column<TValue> | null;
|
|
432
|
-
/**
|
|
534
|
+
/**
|
|
535
|
+
* Returns all the columns, regardless of visible or not.
|
|
536
|
+
* @agModule `ColumnApiModule`
|
|
537
|
+
*/
|
|
433
538
|
getColumns(): Column[] | null;
|
|
434
|
-
/**
|
|
539
|
+
/**
|
|
540
|
+
* Applies the state of the columns from a previous state. Returns `false` if one or more columns could not be found.
|
|
541
|
+
* @agModule `ColumnApiModule`
|
|
542
|
+
*/
|
|
435
543
|
applyColumnState(params: ApplyColumnStateParams): boolean;
|
|
436
|
-
/**
|
|
544
|
+
/**
|
|
545
|
+
* Gets the state of the columns. Typically used when saving column state.
|
|
546
|
+
* @agModule `ColumnApiModule`
|
|
547
|
+
*/
|
|
437
548
|
getColumnState(): ColumnState[];
|
|
438
|
-
/**
|
|
549
|
+
/**
|
|
550
|
+
* Sets the state back to match the originally provided column definitions.
|
|
551
|
+
* @agModule `ColumnApiModule`
|
|
552
|
+
*/
|
|
439
553
|
resetColumnState(): void;
|
|
440
|
-
/**
|
|
554
|
+
/**
|
|
555
|
+
* Returns `true` if pinning left or right, otherwise `false`.
|
|
556
|
+
* @agModule `ColumnApiModule`
|
|
557
|
+
*/
|
|
441
558
|
isPinning(): boolean;
|
|
442
|
-
/**
|
|
559
|
+
/**
|
|
560
|
+
* Returns `true` if pinning left, otherwise `false`.
|
|
561
|
+
* @agModule `ColumnApiModule`
|
|
562
|
+
*/
|
|
443
563
|
isPinningLeft(): boolean;
|
|
444
|
-
/**
|
|
564
|
+
/**
|
|
565
|
+
* Returns `true` if pinning right, otherwise `false`.
|
|
566
|
+
* @agModule `ColumnApiModule`
|
|
567
|
+
*/
|
|
445
568
|
isPinningRight(): boolean;
|
|
446
|
-
/**
|
|
569
|
+
/**
|
|
570
|
+
* Returns the column to the right of the provided column, taking into consideration open / closed column groups and visible columns. This is useful if you need to know what column is beside yours e.g. if implementing your own cell navigation.
|
|
571
|
+
* @agModule `ColumnApiModule`
|
|
572
|
+
*/
|
|
447
573
|
getDisplayedColAfter<TValue = any>(col: Column): Column<TValue> | null;
|
|
448
|
-
/**
|
|
574
|
+
/**
|
|
575
|
+
* Same as `getVisibleColAfter` except gives column to the left.
|
|
576
|
+
* @agModule `ColumnApiModule`
|
|
577
|
+
*/
|
|
449
578
|
getDisplayedColBefore<TValue = any>(col: Column): Column<TValue> | null;
|
|
450
|
-
/**
|
|
579
|
+
/**
|
|
580
|
+
* Sets the visibility of columns. Key can be the column ID or `Column` object.
|
|
581
|
+
* @agModule `ColumnApiModule`
|
|
582
|
+
*/
|
|
451
583
|
setColumnsVisible(keys: (string | Column)[], visible: boolean): void;
|
|
452
|
-
/**
|
|
584
|
+
/**
|
|
585
|
+
* Set a column's pinned / unpinned state. Key can be the column ID, field, `ColDef` object or `Column` object.
|
|
586
|
+
* @agModule `ColumnApiModule`
|
|
587
|
+
*/
|
|
453
588
|
setColumnsPinned(keys: (string | ColDef | Column)[], pinned: ColumnPinnedType): void;
|
|
454
589
|
/**
|
|
455
590
|
* Returns all the grid columns, same as `getColumns()`, except
|
|
@@ -457,17 +592,34 @@ export interface _ColumnGridApi<TData> {
|
|
|
457
592
|
* a) it has the order of the columns that are presented in the grid
|
|
458
593
|
*
|
|
459
594
|
* b) it's after the 'pivot' step, so if pivoting, has the value columns for the pivot.
|
|
595
|
+
*
|
|
596
|
+
* @agModule `ColumnApiModule`
|
|
460
597
|
*/
|
|
461
598
|
getAllGridColumns(): Column[];
|
|
462
|
-
/**
|
|
599
|
+
/**
|
|
600
|
+
* Same as `getAllDisplayedColumns` but just for the pinned left portion of the grid.
|
|
601
|
+
* @agModule `ColumnApiModule`
|
|
602
|
+
*/
|
|
463
603
|
getDisplayedLeftColumns(): Column[];
|
|
464
|
-
/**
|
|
604
|
+
/**
|
|
605
|
+
* Same as `getAllDisplayedColumns` but just for the center portion of the grid.
|
|
606
|
+
* @agModule `ColumnApiModule`
|
|
607
|
+
*/
|
|
465
608
|
getDisplayedCenterColumns(): Column[];
|
|
466
|
-
/**
|
|
609
|
+
/**
|
|
610
|
+
* Same as `getAllDisplayedColumns` but just for the pinned right portion of the grid.
|
|
611
|
+
* @agModule `ColumnApiModule`
|
|
612
|
+
*/
|
|
467
613
|
getDisplayedRightColumns(): Column[];
|
|
468
|
-
/**
|
|
614
|
+
/**
|
|
615
|
+
* Returns all columns currently displayed (e.g. are visible and if in a group, the group is showing the columns) for the pinned left, centre and pinned right portions of the grid.
|
|
616
|
+
* @agModule `ColumnApiModule`
|
|
617
|
+
*/
|
|
469
618
|
getAllDisplayedColumns(): Column[];
|
|
470
|
-
/**
|
|
619
|
+
/**
|
|
620
|
+
* Same as `getAllGridColumns()`, except only returns rendered columns, i.e. columns that are not within the viewport and therefore not rendered, due to column virtualisation, are not displayed.
|
|
621
|
+
* @agModule `ColumnApiModule`
|
|
622
|
+
*/
|
|
471
623
|
getAllDisplayedVirtualColumns(): Column[];
|
|
472
624
|
}
|
|
473
625
|
export interface _ColumnGroupGridApi {
|
|
@@ -501,52 +653,95 @@ export interface _ColumnGroupGridApi {
|
|
|
501
653
|
getAllDisplayedColumnGroups(): (Column | ColumnGroup)[] | null;
|
|
502
654
|
}
|
|
503
655
|
export interface _DragGridApi {
|
|
504
|
-
/**
|
|
656
|
+
/**
|
|
657
|
+
* Adds a drop zone outside of the grid where rows can be dropped.
|
|
658
|
+
* @agModule `RowDragModule`
|
|
659
|
+
*/
|
|
505
660
|
addRowDropZone(params: RowDropZoneParams): void;
|
|
506
|
-
/**
|
|
661
|
+
/**
|
|
662
|
+
* Removes an external drop zone added by `addRowDropZone`.
|
|
663
|
+
* @agModule `RowDragModule` */
|
|
507
664
|
removeRowDropZone(params: RowDropZoneParams): void;
|
|
508
|
-
/**
|
|
665
|
+
/**
|
|
666
|
+
* Returns the `RowDropZoneParams` to be used by another grid's `addRowDropZone` method.
|
|
667
|
+
* @agModule `RowDragModule`
|
|
668
|
+
*/
|
|
509
669
|
getRowDropZoneParams(events?: RowDropZoneEvents): RowDropZoneParams | undefined;
|
|
510
670
|
}
|
|
511
671
|
export interface _EditGridApi<TData> {
|
|
512
|
-
/**
|
|
672
|
+
/**
|
|
673
|
+
* Returns the list of active cell editor instances. Optionally provide parameters to restrict to certain columns / row nodes.
|
|
674
|
+
* @agModule `TextEditorModule` / `LargeTextEditorModule` / `NumberEditorModule` / `DateEditorModule` / `CheckboxEditorModule` / `CustomEditorModule` / `SelectEditorModule` / `RichSelectModule`
|
|
675
|
+
*/
|
|
513
676
|
getCellEditorInstances(params?: GetCellEditorInstancesParams<TData>): ICellEditor[];
|
|
514
|
-
/**
|
|
677
|
+
/**
|
|
678
|
+
* If the grid is editing, returns back details of the editing cell(s).
|
|
679
|
+
* @agModule `TextEditorModule` / `LargeTextEditorModule` / `NumberEditorModule` / `DateEditorModule` / `CheckboxEditorModule` / `CustomEditorModule` / `SelectEditorModule` / `RichSelectModule`
|
|
680
|
+
*/
|
|
515
681
|
getEditingCells(): CellPosition[];
|
|
516
|
-
/**
|
|
682
|
+
/**
|
|
683
|
+
* If a cell is editing, it stops the editing. Pass `true` if you want to cancel the editing (i.e. don't accept changes).
|
|
684
|
+
* @agModule `TextEditorModule` / `LargeTextEditorModule` / `NumberEditorModule` / `DateEditorModule` / `CheckboxEditorModule` / `CustomEditorModule` / `SelectEditorModule` / `RichSelectModule`
|
|
685
|
+
*/
|
|
517
686
|
stopEditing(cancel?: boolean): void;
|
|
518
|
-
/**
|
|
687
|
+
/**
|
|
688
|
+
* Start editing the provided cell. If another cell is editing, the editing will be stopped in that other cell.
|
|
689
|
+
* @agModule `TextEditorModule` / `LargeTextEditorModule` / `NumberEditorModule` / `DateEditorModule` / `CheckboxEditorModule` / `CustomEditorModule` / `SelectEditorModule` / `RichSelectModule`
|
|
690
|
+
*/
|
|
519
691
|
startEditingCell(params: StartEditingCellParams): void;
|
|
520
692
|
}
|
|
521
693
|
export interface _UndoRedoGridApi {
|
|
522
|
-
/**
|
|
694
|
+
/**
|
|
695
|
+
* Reverts the last cell edit.
|
|
696
|
+
* @agModule `UndoRedoEditModule`
|
|
697
|
+
*/
|
|
523
698
|
undoCellEditing(): void;
|
|
524
|
-
/**
|
|
699
|
+
/**
|
|
700
|
+
* Re-applies the most recently undone cell edit.
|
|
701
|
+
* @agModule `UndoRedoEditModule`
|
|
702
|
+
*/
|
|
525
703
|
redoCellEditing(): void;
|
|
526
|
-
/**
|
|
704
|
+
/**
|
|
705
|
+
* Returns current number of available cell edit undo operations.
|
|
706
|
+
* @agModule `UndoRedoEditModule`
|
|
707
|
+
*/
|
|
527
708
|
getCurrentUndoSize(): number;
|
|
528
|
-
/**
|
|
709
|
+
/**
|
|
710
|
+
* Returns current number of available cell edit redo operations.
|
|
711
|
+
* @agModule `UndoRedoEditModule`
|
|
712
|
+
*/
|
|
529
713
|
getCurrentRedoSize(): number;
|
|
530
714
|
}
|
|
531
715
|
export interface _FilterGridApi {
|
|
532
|
-
/**
|
|
716
|
+
/**
|
|
717
|
+
* Returns `true` if any filter is set. This includes quick filter, column filter, external filter or advanced filter.
|
|
718
|
+
* @agModule `TextFilterModule` / `NumberFilterModule` / `DateFilterModule` / `SetFilterModule` / `MultiFilterModule` / `CustomFilterModule` / `QuickFilterModule` / `ExternalFilterModule` / `AdvancedFilterModule`
|
|
719
|
+
* */
|
|
533
720
|
isAnyFilterPresent(): boolean;
|
|
534
721
|
/**
|
|
535
722
|
* Informs the grid that a filter has changed. This is typically called after a filter change through one of the filter APIs.
|
|
536
723
|
* @param source The source of the filter change event. If not specified defaults to `'api'`.
|
|
724
|
+
* @agModule `TextFilterModule` / `NumberFilterModule` / `DateFilterModule` / `SetFilterModule` / `MultiFilterModule` / `CustomFilterModule` / `QuickFilterModule` / `ExternalFilterModule` / `AdvancedFilterModule`
|
|
537
725
|
*/
|
|
538
726
|
onFilterChanged(source?: FilterChangedEventSourceType): void;
|
|
539
727
|
}
|
|
540
728
|
export interface _ColumnFilterGridApi {
|
|
541
|
-
/**
|
|
729
|
+
/**
|
|
730
|
+
* Returns `true` if any column filter is set, otherwise `false`.
|
|
731
|
+
* @agModule `TextFilterModule` / `NumberFilterModule` / `DateFilterModule` / `SetFilterModule` / `MultiFilterModule` / `CustomFilterModule`
|
|
732
|
+
*/
|
|
542
733
|
isColumnFilterPresent(): boolean;
|
|
543
734
|
/**
|
|
544
735
|
* Returns the filter component instance for a column.
|
|
545
736
|
* For getting/setting models for individual column filters, use `getColumnFilterModel` and `setColumnFilterModel` instead of this.
|
|
546
737
|
* `key` can be a column ID or a `Column` object.
|
|
738
|
+
* @agModule `TextFilterModule` / `NumberFilterModule` / `DateFilterModule` / `SetFilterModule` / `MultiFilterModule` / `CustomFilterModule`
|
|
547
739
|
*/
|
|
548
740
|
getColumnFilterInstance<TFilter extends IFilter>(key: string | Column): Promise<TFilter | null | undefined>;
|
|
549
|
-
/**
|
|
741
|
+
/**
|
|
742
|
+
* Destroys a filter. Useful to force a particular filter to be created from scratch again.
|
|
743
|
+
* @agModule `TextFilterModule` / `NumberFilterModule` / `DateFilterModule` / `SetFilterModule` / `MultiFilterModule` / `CustomFilterModule`
|
|
744
|
+
*/
|
|
550
745
|
destroyFilter(key: string | Column): void;
|
|
551
746
|
/**
|
|
552
747
|
* Sets the state of all the column filters. Provide it with what you get from `getFilterModel()` to restore filter state.
|
|
@@ -554,64 +749,96 @@ export interface _ColumnFilterGridApi {
|
|
|
554
749
|
* the filter model will be applied asynchronously after row data is added.
|
|
555
750
|
* To always perform this synchronously, set `cellDataType = false` on the default column definition,
|
|
556
751
|
* or provide cell data types for every column.
|
|
752
|
+
* @agModule `TextFilterModule` / `NumberFilterModule` / `DateFilterModule` / `SetFilterModule` / `MultiFilterModule` / `CustomFilterModule`
|
|
557
753
|
*/
|
|
558
754
|
setFilterModel(model: FilterModel | null): void;
|
|
559
|
-
/**
|
|
755
|
+
/**
|
|
756
|
+
* Gets the current state of all the column filters. Used for saving filter state.
|
|
757
|
+
* @agModule `TextFilterModule` / `NumberFilterModule` / `DateFilterModule` / `SetFilterModule` / `MultiFilterModule` / `CustomFilterModule`
|
|
758
|
+
*/
|
|
560
759
|
getFilterModel(): FilterModel;
|
|
561
760
|
/**
|
|
562
761
|
* Gets the current filter model for the specified column.
|
|
563
762
|
* Will return `null` if no active filter.
|
|
763
|
+
* @agModule `TextFilterModule` / `NumberFilterModule` / `DateFilterModule` / `SetFilterModule` / `MultiFilterModule` / `CustomFilterModule`
|
|
564
764
|
*/
|
|
565
765
|
getColumnFilterModel<TModel>(column: string | Column): TModel | null;
|
|
566
766
|
/**
|
|
567
767
|
* Sets the filter model for the specified column.
|
|
568
768
|
* Setting a `model` of `null` will reset the filter (make inactive).
|
|
569
769
|
* Must wait on the response before calling `api.onFilterChanged()`.
|
|
770
|
+
* @agModule `TextFilterModule` / `NumberFilterModule` / `DateFilterModule` / `SetFilterModule` / `MultiFilterModule` / `CustomFilterModule`
|
|
570
771
|
*/
|
|
571
772
|
setColumnFilterModel<TModel>(column: string | Column, model: TModel | null): Promise<void>;
|
|
572
|
-
/**
|
|
773
|
+
/**
|
|
774
|
+
* Show the filter for the provided column.
|
|
775
|
+
* @agModule `TextFilterModule` / `NumberFilterModule` / `DateFilterModule` / `SetFilterModule` / `MultiFilterModule` / `CustomFilterModule`
|
|
776
|
+
*/
|
|
573
777
|
showColumnFilter(colKey: string | Column): void;
|
|
574
778
|
}
|
|
575
779
|
export interface _QuickFilterGridApi {
|
|
576
780
|
/**
|
|
577
781
|
* Only supported for Client-Side Row Model.
|
|
578
782
|
* Returns `true` if the Quick Filter is set, otherwise `false`.
|
|
783
|
+
* @agModule `QuickFilterModule`
|
|
579
784
|
*/
|
|
580
785
|
isQuickFilterPresent(): boolean;
|
|
581
786
|
/**
|
|
582
787
|
* Only supported for Client-Side Row Model.
|
|
583
788
|
* Get the current Quick Filter text from the grid, or `undefined` if none is set.
|
|
789
|
+
* @agModule `QuickFilterModule`
|
|
584
790
|
*/
|
|
585
791
|
getQuickFilter(): string | undefined;
|
|
586
792
|
/**
|
|
587
793
|
* Only supported for Client-Side Row Model.
|
|
588
794
|
* Reset the Quick Filter cache text on every rowNode.
|
|
795
|
+
* @agModule `QuickFilterModule`
|
|
589
796
|
*/
|
|
590
797
|
resetQuickFilter(): void;
|
|
591
798
|
}
|
|
592
799
|
export interface _FindApi<TData> {
|
|
593
|
-
/**
|
|
800
|
+
/**
|
|
801
|
+
* Go to the next match.
|
|
802
|
+
* @agModule `FindModule`
|
|
803
|
+
*/
|
|
594
804
|
findNext(): void;
|
|
595
|
-
/**
|
|
805
|
+
/**
|
|
806
|
+
* Go to the previous match.
|
|
807
|
+
* @agModule `FindModule`
|
|
808
|
+
*/
|
|
596
809
|
findPrevious(): void;
|
|
597
|
-
/**
|
|
810
|
+
/**
|
|
811
|
+
* Get the total number of matches.
|
|
812
|
+
* @agModule `FindModule`
|
|
813
|
+
*/
|
|
598
814
|
findGetTotalMatches(): number;
|
|
599
815
|
/**
|
|
600
816
|
* Go to the provided match (first match is `1`).
|
|
601
817
|
* By default, if the provided match is already active, this will do nothing.
|
|
602
818
|
* If `force` is set to `true`, this will instead reset the active match to that provided
|
|
603
819
|
* (e.g. scroll the grid).
|
|
820
|
+
* @agModule `FindModule`
|
|
604
821
|
*/
|
|
605
822
|
findGoTo(match: number, force?: boolean): void;
|
|
606
|
-
/**
|
|
823
|
+
/**
|
|
824
|
+
* Clear the active match.
|
|
825
|
+
* @agModule `FindModule`
|
|
826
|
+
*/
|
|
607
827
|
findClearActive(): void;
|
|
608
|
-
/**
|
|
828
|
+
/**
|
|
829
|
+
* Get the active match, or `undefined` if no active match.
|
|
830
|
+
* @agModule `FindModule`
|
|
831
|
+
*/
|
|
609
832
|
findGetActiveMatch(): FindMatch<TData> | undefined;
|
|
610
|
-
/**
|
|
833
|
+
/**
|
|
834
|
+
* Get the number of matches within the provided cell.
|
|
835
|
+
* @agModule `FindModule`
|
|
836
|
+
*/
|
|
611
837
|
findGetNumMatches(params: FindCellParams<TData>): number;
|
|
612
838
|
/**
|
|
613
839
|
* Get the parts of a cell value, including matches and active match.
|
|
614
840
|
* Used for custom cell components.
|
|
841
|
+
* @agModule `FindModule`
|
|
615
842
|
*/
|
|
616
843
|
findGetParts(params: FindCellValueParams<TData>): FindPart[];
|
|
617
844
|
/**
|
|
@@ -619,11 +846,15 @@ export interface _FindApi<TData> {
|
|
|
619
846
|
*
|
|
620
847
|
* This should only be called in situations where data is mutated outside of the grid,
|
|
621
848
|
* and `api.refreshCells()` or `api.redrawRows()` are being used (`api.findRefresh()` should be called after these).
|
|
849
|
+
* @agModule `FindModule`
|
|
622
850
|
*/
|
|
623
851
|
findRefresh(): void;
|
|
624
852
|
}
|
|
625
853
|
export interface _StateGridApi {
|
|
626
|
-
/**
|
|
854
|
+
/**
|
|
855
|
+
* Get the current state of the grid. Can be used in conjunction with the `initialState` grid option to save and restore grid state.
|
|
856
|
+
* @agModule `GridStateModule`
|
|
857
|
+
*/
|
|
627
858
|
getState(): GridState;
|
|
628
859
|
}
|
|
629
860
|
export interface _PaginationGridApi {
|
|
@@ -631,40 +862,84 @@ export interface _PaginationGridApi {
|
|
|
631
862
|
* Returns `true` when the last page is known.
|
|
632
863
|
* This will always be `true` if you are using the Client-Side Row Model for pagination.
|
|
633
864
|
* Returns `false` when the last page is not known; this only happens when using Infinite Row Model.
|
|
865
|
+
* @agModule `PaginationModule`
|
|
634
866
|
*/
|
|
635
867
|
paginationIsLastPageFound(): boolean;
|
|
636
|
-
/**
|
|
868
|
+
/**
|
|
869
|
+
* Returns how many rows are being shown per page.
|
|
870
|
+
* @agModule `PaginationModule`
|
|
871
|
+
*/
|
|
637
872
|
paginationGetPageSize(): number;
|
|
638
|
-
/**
|
|
873
|
+
/**
|
|
874
|
+
* Returns the 0-based index of the page which is showing.
|
|
875
|
+
* @agModule `PaginationModule`
|
|
876
|
+
*/
|
|
639
877
|
paginationGetCurrentPage(): number;
|
|
640
|
-
/**
|
|
878
|
+
/**
|
|
879
|
+
* Returns the total number of pages.
|
|
880
|
+
* @agModule `PaginationModule`
|
|
881
|
+
*/
|
|
641
882
|
paginationGetTotalPages(): number;
|
|
642
883
|
/**
|
|
643
884
|
* Returns the total number of pageable rows, as impacted by `gridOptions.paginateChildRows: true`.
|
|
644
885
|
*
|
|
645
886
|
* It is recommended to instead use `gridApi.getDisplayedRowCount()` if not using pagination, or if `gridOption.paginateChildRows=true`.
|
|
887
|
+
*
|
|
888
|
+
* @agModule `PaginationModule`
|
|
646
889
|
**/
|
|
647
890
|
paginationGetRowCount(): number;
|
|
648
|
-
/**
|
|
891
|
+
/**
|
|
892
|
+
* Navigates to the next page.
|
|
893
|
+
* @agModule `PaginationModule`
|
|
894
|
+
*/
|
|
649
895
|
paginationGoToNextPage(): void;
|
|
650
|
-
/**
|
|
896
|
+
/**
|
|
897
|
+
* Navigates to the previous page.
|
|
898
|
+
* @agModule `PaginationModule`
|
|
899
|
+
*/
|
|
651
900
|
paginationGoToPreviousPage(): void;
|
|
652
|
-
/**
|
|
901
|
+
/**
|
|
902
|
+
* Navigates to the first page.
|
|
903
|
+
* @agModule `PaginationModule`
|
|
904
|
+
*/
|
|
653
905
|
paginationGoToFirstPage(): void;
|
|
654
|
-
/**
|
|
906
|
+
/**
|
|
907
|
+
* Navigates to the last page.
|
|
908
|
+
* @agModule `PaginationModule`
|
|
909
|
+
*/
|
|
655
910
|
paginationGoToLastPage(): void;
|
|
656
|
-
/**
|
|
911
|
+
/**
|
|
912
|
+
* Goes to the specified page. If the page requested doesn't exist, it will go to the last page.
|
|
913
|
+
* @agModule `PaginationModule`
|
|
914
|
+
*/
|
|
657
915
|
paginationGoToPage(page: number): void;
|
|
658
916
|
}
|
|
659
917
|
export interface _PinnedRowGridApi {
|
|
660
|
-
/**
|
|
918
|
+
/**
|
|
919
|
+
* Gets the number of top pinned rows.
|
|
920
|
+
* @agModule `PinnedRowModule`
|
|
921
|
+
*/
|
|
661
922
|
getPinnedTopRowCount(): number;
|
|
662
|
-
/**
|
|
923
|
+
/**
|
|
924
|
+
* Gets the number of bottom pinned rows.
|
|
925
|
+
* @agModule `PinnedRowModule`
|
|
926
|
+
*/
|
|
663
927
|
getPinnedBottomRowCount(): number;
|
|
664
|
-
/**
|
|
928
|
+
/**
|
|
929
|
+
* Gets the top pinned row with the specified index.
|
|
930
|
+
* @agModule `PinnedRowModule`
|
|
931
|
+
*/
|
|
665
932
|
getPinnedTopRow<TPinnedData = any>(index: number): IRowNode<TPinnedData> | undefined;
|
|
666
|
-
/**
|
|
933
|
+
/**
|
|
934
|
+
* Gets the bottom pinned row with the specified index.
|
|
935
|
+
* @agModule `PinnedRowModule`
|
|
936
|
+
*/
|
|
667
937
|
getPinnedBottomRow<TPinnedData = any>(index: number): IRowNode<TPinnedData> | undefined;
|
|
938
|
+
/**
|
|
939
|
+
* Iterates over each pinned row, calling the provided callback for each row
|
|
940
|
+
* @agModule `PinnedRowModule`
|
|
941
|
+
*/
|
|
942
|
+
forEachPinnedRow<TPinnedData = any>(floating: NonNullable<RowPinnedType>, callback: (rowNode: IRowNode<TPinnedData>) => void): void;
|
|
668
943
|
}
|
|
669
944
|
export interface _RenderGridApi<TData> {
|
|
670
945
|
/**
|
|
@@ -673,57 +948,110 @@ export interface _RenderGridApi<TData> {
|
|
|
673
948
|
* Example: `api.setGridAriaProperty('label', 'my grid')` will set `aria-label=\"my grid\"`.
|
|
674
949
|
*
|
|
675
950
|
* `api.setGridAriaProperty('label', null)` will remove the `aria-label` attribute from the grid element.
|
|
951
|
+
* @agModule `RenderApiModule`
|
|
676
952
|
*/
|
|
677
953
|
setGridAriaProperty(property: string, value: string | null): void;
|
|
678
|
-
/**
|
|
954
|
+
/**
|
|
955
|
+
* Performs change detection on all cells, refreshing cells where required.
|
|
956
|
+
* @agModule `RenderApiModule`
|
|
957
|
+
*/
|
|
679
958
|
refreshCells(params?: RefreshCellsParams<TData>): void;
|
|
680
|
-
/**
|
|
959
|
+
/**
|
|
960
|
+
* Redraws the header. Useful if a column name changes, or something else that changes how the column header is displayed.
|
|
961
|
+
* @agModule `RenderApiModule`
|
|
962
|
+
*/
|
|
681
963
|
refreshHeader(): void;
|
|
682
|
-
/**
|
|
964
|
+
/**
|
|
965
|
+
* Returns `true` when there are no more animation frames left to process.
|
|
966
|
+
* @agModule `RenderApiModule`
|
|
967
|
+
*/
|
|
683
968
|
isAnimationFrameQueueEmpty(): boolean;
|
|
969
|
+
/**
|
|
970
|
+
* Flushes all animation frames.
|
|
971
|
+
* @agModule `RenderApiModule`
|
|
972
|
+
*/
|
|
684
973
|
flushAllAnimationFrames(): void;
|
|
685
974
|
/**
|
|
686
975
|
* Gets the sizes that various UI elements will be rendered at with the current theme.
|
|
687
976
|
* If you override the row or header height using `gridOptions`, the override value you provided will be returned.
|
|
977
|
+
* @agModule `RenderApiModule`
|
|
688
978
|
*/
|
|
689
979
|
getSizesForCurrentTheme(): {
|
|
690
980
|
rowHeight: number;
|
|
691
981
|
headerHeight: number;
|
|
692
982
|
};
|
|
693
|
-
/**
|
|
983
|
+
/**
|
|
984
|
+
* Returns the list of active cell renderer instances.
|
|
985
|
+
* @agModule `RenderApiModule`
|
|
986
|
+
*/
|
|
694
987
|
getCellRendererInstances(params?: GetCellRendererInstancesParams<TData>): ICellRenderer<TData>[];
|
|
695
988
|
}
|
|
696
989
|
export interface _HighlightChangesGridApi<TData> {
|
|
697
|
-
/**
|
|
990
|
+
/**
|
|
991
|
+
* Flash rows, columns or individual cells.
|
|
992
|
+
* @agModule `HighlightChangesModule`
|
|
993
|
+
*/
|
|
698
994
|
flashCells(params?: FlashCellsParams<TData>): void;
|
|
699
995
|
}
|
|
700
996
|
export interface _SideBarGridApi<TData> {
|
|
701
|
-
/**
|
|
997
|
+
/**
|
|
998
|
+
* Returns `true` if the side bar is visible.
|
|
999
|
+
* @agModule `SideBarModule`
|
|
1000
|
+
*/
|
|
702
1001
|
isSideBarVisible(): boolean;
|
|
703
|
-
/**
|
|
1002
|
+
/**
|
|
1003
|
+
* Show/hide the entire side bar, including any visible panel and the tab buttons.
|
|
1004
|
+
* @agModule `SideBarModule`
|
|
1005
|
+
*/
|
|
704
1006
|
setSideBarVisible(show: boolean): void;
|
|
705
|
-
/**
|
|
1007
|
+
/**
|
|
1008
|
+
* Sets the side bar position relative to the grid. Possible values are `'left'` or `'right'`.
|
|
1009
|
+
* @agModule `SideBarModule`
|
|
1010
|
+
*/
|
|
706
1011
|
setSideBarPosition(position: 'left' | 'right'): void;
|
|
707
|
-
/**
|
|
1012
|
+
/**
|
|
1013
|
+
* Opens a particular tool panel. Provide the ID of the tool panel to open.
|
|
1014
|
+
* @agModule `SideBarModule`
|
|
1015
|
+
*/
|
|
708
1016
|
openToolPanel(key: string): void;
|
|
709
|
-
/**
|
|
1017
|
+
/**
|
|
1018
|
+
* Closes the currently open tool panel (if any).
|
|
1019
|
+
* @agModule `SideBarModule`
|
|
1020
|
+
*/
|
|
710
1021
|
closeToolPanel(): void;
|
|
711
|
-
/**
|
|
1022
|
+
/**
|
|
1023
|
+
* Returns the ID of the currently shown tool panel if any, otherwise `null`.
|
|
1024
|
+
* @agModule `SideBarModule`
|
|
1025
|
+
*/
|
|
712
1026
|
getOpenedToolPanel(): string | null;
|
|
713
|
-
/**
|
|
1027
|
+
/**
|
|
1028
|
+
* Force refreshes all tool panels by calling their `refresh` method.
|
|
1029
|
+
* @agModule `SideBarModule`
|
|
1030
|
+
*/
|
|
714
1031
|
refreshToolPanel(): void;
|
|
715
|
-
/**
|
|
1032
|
+
/**
|
|
1033
|
+
* Returns `true` if the tool panel is showing, otherwise `false`.
|
|
1034
|
+
* @agModule `SideBarModule`
|
|
1035
|
+
*/
|
|
716
1036
|
isToolPanelShowing(): boolean;
|
|
717
1037
|
getToolPanelInstance(id: 'columns'): IColumnToolPanel | undefined;
|
|
718
1038
|
getToolPanelInstance(id: 'filters'): IFiltersToolPanel | undefined;
|
|
719
1039
|
getToolPanelInstance<TToolPanel = IToolPanel<TData>>(id: string): TToolPanel | undefined;
|
|
720
|
-
/**
|
|
1040
|
+
/**
|
|
1041
|
+
* Gets the tool panel instance corresponding to the supplied `id`.
|
|
1042
|
+
* @agModule `SideBarModule`
|
|
1043
|
+
*/
|
|
721
1044
|
getToolPanelInstance<TToolPanel = IToolPanel<TData>>(id: string): TToolPanel | undefined;
|
|
722
|
-
/**
|
|
1045
|
+
/**
|
|
1046
|
+
* Returns the current side bar configuration. If a shortcut was used, returns the detailed long form.
|
|
1047
|
+
* @agModule `SideBarModule`
|
|
1048
|
+
*/
|
|
723
1049
|
getSideBar(): SideBarDef | undefined;
|
|
724
1050
|
}
|
|
725
1051
|
export interface _StatusBarGridApi<TData = any> {
|
|
726
|
-
/**
|
|
1052
|
+
/**
|
|
1053
|
+
* Gets the status panel instance corresponding to the supplied `id`.
|
|
1054
|
+
* @agModule `StatusBarModule` */
|
|
727
1055
|
getStatusPanel<TStatusPanel = IStatusPanel<TData>>(key: string): TStatusPanel | undefined;
|
|
728
1056
|
}
|
|
729
1057
|
export interface _InfiniteRowModelGridApi {
|
|
@@ -731,6 +1059,7 @@ export interface _InfiniteRowModelGridApi {
|
|
|
731
1059
|
* Marks all the currently loaded blocks in the cache for reload.
|
|
732
1060
|
* If you have 10 blocks in the cache, all 10 will be marked for reload.
|
|
733
1061
|
* The old data will continue to be displayed until the new data is loaded.
|
|
1062
|
+
* @agModule `InfiniteRowModelModule`
|
|
734
1063
|
*/
|
|
735
1064
|
refreshInfiniteCache(): void;
|
|
736
1065
|
/**
|
|
@@ -738,6 +1067,7 @@ export interface _InfiniteRowModelGridApi {
|
|
|
738
1067
|
* The grid is then told to refresh. Only the blocks required to display the current data on screen are fetched (typically no more than 2).
|
|
739
1068
|
* The grid will display nothing while the new blocks are loaded.
|
|
740
1069
|
* Use this to immediately remove the old data from the user.
|
|
1070
|
+
* @agModule `InfiniteRowModelModule`
|
|
741
1071
|
*/
|
|
742
1072
|
purgeInfiniteCache(): void;
|
|
743
1073
|
/** The row count defines how many rows the grid allows scrolling to. */
|
|
@@ -745,57 +1075,123 @@ export interface _InfiniteRowModelGridApi {
|
|
|
745
1075
|
getInfiniteRowCount(): number | undefined;
|
|
746
1076
|
}
|
|
747
1077
|
export interface _CsvExportGridApi {
|
|
748
|
-
/**
|
|
1078
|
+
/**
|
|
1079
|
+
* Similar to `exportDataAsCsv`, except returns the result as a string rather than download it.
|
|
1080
|
+
* @agModule `CsvExportModule`
|
|
1081
|
+
*/
|
|
749
1082
|
getDataAsCsv(params?: CsvExportParams): string | undefined;
|
|
750
|
-
/**
|
|
1083
|
+
/**
|
|
1084
|
+
* Downloads a CSV export of the grid's data.
|
|
1085
|
+
* @agModule `CsvExportModule`
|
|
1086
|
+
*/
|
|
751
1087
|
exportDataAsCsv(params?: CsvExportParams): void;
|
|
752
1088
|
}
|
|
753
1089
|
export interface _RowGroupingGridApi {
|
|
754
|
-
/**
|
|
1090
|
+
/**
|
|
1091
|
+
* Set the row group columns.
|
|
1092
|
+
* @agModule `RowGroupingModule`
|
|
1093
|
+
*/
|
|
755
1094
|
setRowGroupColumns(colKeys: (string | ColDef | Column)[]): void;
|
|
756
|
-
/**
|
|
1095
|
+
/**
|
|
1096
|
+
* Move the column to a new position in the row grouping order.
|
|
1097
|
+
* @agModule `RowGroupingModule`
|
|
1098
|
+
*/
|
|
757
1099
|
moveRowGroupColumn(fromIndex: number, toIndex: number): void;
|
|
758
|
-
/**
|
|
1100
|
+
/**
|
|
1101
|
+
* Remove columns from the row groups.
|
|
1102
|
+
* @agModule `RowGroupingModule`
|
|
1103
|
+
*/
|
|
759
1104
|
removeRowGroupColumns(colKeys: (string | ColDef | Column)[]): void;
|
|
760
|
-
/**
|
|
1105
|
+
/**
|
|
1106
|
+
* Add columns to the row groups.
|
|
1107
|
+
* @agModule `RowGroupingModule`
|
|
1108
|
+
*/
|
|
761
1109
|
addRowGroupColumns(colKeys: (string | ColDef | Column)[]): void;
|
|
762
|
-
/**
|
|
1110
|
+
/**
|
|
1111
|
+
* Get row group columns.
|
|
1112
|
+
* @agModule `RowGroupingModule`
|
|
1113
|
+
*/
|
|
763
1114
|
getRowGroupColumns(): Column[];
|
|
764
1115
|
}
|
|
765
1116
|
export interface _AggregationGridApi<TData> {
|
|
766
|
-
/**
|
|
1117
|
+
/**
|
|
1118
|
+
* Add aggregations function with the specified keys.
|
|
1119
|
+
* @agModule `RowGroupingModule / PivotModule / TreeDataModule`
|
|
1120
|
+
*/
|
|
767
1121
|
addAggFuncs(aggFuncs: {
|
|
768
1122
|
[key: string]: IAggFunc<TData>;
|
|
769
1123
|
}): void;
|
|
770
|
-
/**
|
|
1124
|
+
/**
|
|
1125
|
+
* Clears all aggregation functions (including those provided by the grid).
|
|
1126
|
+
* @agModule `RowGroupingModule / PivotModule / TreeDataModule`
|
|
1127
|
+
*/
|
|
771
1128
|
clearAggFuncs(): void;
|
|
772
|
-
/**
|
|
1129
|
+
/**
|
|
1130
|
+
* Sets the agg function for a column. `aggFunc` can be one of the built-in aggregations or a custom aggregation by name or direct function.
|
|
1131
|
+
* @agModule `RowGroupingModule / PivotModule / TreeDataModule`
|
|
1132
|
+
*/
|
|
773
1133
|
setColumnAggFunc<TValue = any>(key: string | ColDef<TData, TValue> | Column<TValue>, aggFunc: string | IAggFunc<TData, TValue> | null | undefined): void;
|
|
774
1134
|
}
|
|
775
1135
|
export interface _PivotGridApi<TData> {
|
|
776
|
-
/**
|
|
1136
|
+
/**
|
|
1137
|
+
* Returns whether pivot mode is currently active.
|
|
1138
|
+
* @agModule `PivotModule`
|
|
1139
|
+
*/
|
|
777
1140
|
isPivotMode(): boolean;
|
|
778
|
-
/**
|
|
1141
|
+
/**
|
|
1142
|
+
* Returns the pivot result column for the given `pivotKeys` and `valueColId`.
|
|
1143
|
+
* @agModule `PivotModule`
|
|
1144
|
+
*/
|
|
779
1145
|
getPivotResultColumn<TValue = any>(pivotKeys: string[], valueColKey: string | ColDef<TData, TValue> | Column<TValue>): Column<TValue> | null;
|
|
780
|
-
/**
|
|
1146
|
+
/**
|
|
1147
|
+
* Set the value columns to the provided list of columns.
|
|
1148
|
+
* @agModule `PivotModule`
|
|
1149
|
+
*/
|
|
781
1150
|
setValueColumns(colKeys: (string | ColDef | Column)[]): void;
|
|
782
|
-
/**
|
|
1151
|
+
/**
|
|
1152
|
+
* Get a list of the existing value columns.
|
|
1153
|
+
* @agModule `PivotModule`
|
|
1154
|
+
*/
|
|
783
1155
|
getValueColumns(): Column[];
|
|
784
|
-
/**
|
|
1156
|
+
/**
|
|
1157
|
+
* Remove the given list of columns from the existing set of value columns.
|
|
1158
|
+
* @agModule `PivotModule`
|
|
1159
|
+
*/
|
|
785
1160
|
removeValueColumns(colKeys: (string | ColDef | Column)[]): void;
|
|
786
|
-
/**
|
|
1161
|
+
/**
|
|
1162
|
+
* Add the given list of columns to the existing set of value columns.
|
|
1163
|
+
* @agModule `PivotModule`
|
|
1164
|
+
*/
|
|
787
1165
|
addValueColumns(colKeys: (string | ColDef | Column)[]): void;
|
|
788
|
-
/**
|
|
1166
|
+
/**
|
|
1167
|
+
* Set the columns for the grid to pivot on.
|
|
1168
|
+
* @agModule `PivotModule`
|
|
1169
|
+
*/
|
|
789
1170
|
setPivotColumns(colKeys: (string | ColDef | Column)[]): void;
|
|
790
|
-
/**
|
|
1171
|
+
/**
|
|
1172
|
+
* Stops the grid from pivoting on the provided columns.
|
|
1173
|
+
* @agModule `PivotModule`
|
|
1174
|
+
*/
|
|
791
1175
|
removePivotColumns(colKeys: (string | ColDef | Column)[]): void;
|
|
792
|
-
/**
|
|
1176
|
+
/**
|
|
1177
|
+
* Add columns for the grid to pivot on.
|
|
1178
|
+
* @agModule `PivotModule`
|
|
1179
|
+
*/
|
|
793
1180
|
addPivotColumns(colKeys: (string | ColDef | Column)[]): void;
|
|
794
|
-
/**
|
|
1181
|
+
/**
|
|
1182
|
+
* Get the columns which the grid is pivoting on.
|
|
1183
|
+
* @agModule `PivotModule`
|
|
1184
|
+
*/
|
|
795
1185
|
getPivotColumns(): Column[];
|
|
796
|
-
/**
|
|
1186
|
+
/**
|
|
1187
|
+
* Set explicit pivot column definitions yourself. Used for advanced use cases only.
|
|
1188
|
+
* @agModule `PivotModule`
|
|
1189
|
+
*/
|
|
797
1190
|
setPivotResultColumns(colDefs: (ColDef | ColGroupDef)[] | null): void;
|
|
798
|
-
/**
|
|
1191
|
+
/**
|
|
1192
|
+
* Returns the grid's pivot result columns.
|
|
1193
|
+
* @agModule `PivotModule`
|
|
1194
|
+
*/
|
|
799
1195
|
getPivotResultColumns(): Column[] | null;
|
|
800
1196
|
}
|
|
801
1197
|
export interface _CellSelectionGridApi {
|
|
@@ -804,12 +1200,14 @@ export interface _CellSelectionGridApi {
|
|
|
804
1200
|
*
|
|
805
1201
|
* The start is the first cell the user clicked on and the end is the cell where the user stopped dragging.
|
|
806
1202
|
* Do not assume that the start cell's index is numerically before the end cell, as the user could have dragged up.
|
|
1203
|
+
* @agModule `CellSelectionModule`
|
|
807
1204
|
*/
|
|
808
1205
|
getCellRanges(): CellRange[] | null;
|
|
809
1206
|
/**
|
|
810
1207
|
* Adds the provided cell range to the selected ranges.
|
|
811
1208
|
*
|
|
812
1209
|
* This keeps any previous ranges. If you wish to only have the new range selected, then call `clearCellSelection()` first.
|
|
1210
|
+
* @agModule `CellSelectionModule`
|
|
813
1211
|
*/
|
|
814
1212
|
addCellRange(params: CellRangeParams): void;
|
|
815
1213
|
/**
|
|
@@ -817,7 +1215,10 @@ export interface _CellSelectionGridApi {
|
|
|
817
1215
|
* @deprecated v32.2 Use `clearCellSelection` instead
|
|
818
1216
|
*/
|
|
819
1217
|
clearRangeSelection(): void;
|
|
820
|
-
/**
|
|
1218
|
+
/**
|
|
1219
|
+
* Clears the selected cell ranges.
|
|
1220
|
+
* @agModule `CellSelectionModule`
|
|
1221
|
+
*/
|
|
821
1222
|
clearCellSelection(): void;
|
|
822
1223
|
}
|
|
823
1224
|
export interface _ServerSideRowModelGridApi<TData> {
|
|
@@ -826,6 +1227,7 @@ export interface _ServerSideRowModelGridApi<TData> {
|
|
|
826
1227
|
*
|
|
827
1228
|
* If `rowSelection.groupSelects` is `'self'` the returned object will be flat, and will conform to `IServerSideSelectionState`.
|
|
828
1229
|
* If `rowSelection.groupSelects` is `'descendants'` or `'filteredDescendants'` the returned object will be hierarchical, and will conform to `IServerSideGroupSelectionState`.
|
|
1230
|
+
* @agModule `ServerSideRowModelApiModule`
|
|
829
1231
|
*/
|
|
830
1232
|
getServerSideSelectionState(): IServerSideSelectionState | IServerSideGroupSelectionState | null;
|
|
831
1233
|
/**
|
|
@@ -833,116 +1235,230 @@ export interface _ServerSideRowModelGridApi<TData> {
|
|
|
833
1235
|
*
|
|
834
1236
|
* If `rowSelection.groupSelects` is `'self'` the param will be flat, and should conform to `IServerSideSelectionState`.
|
|
835
1237
|
* If `rowSelection.groupSelects` is `'descendants'` or `'filteredDescendants'` the param will be hierarchical, and should conform to `IServerSideGroupSelectionState`.
|
|
1238
|
+
* @agModule `ServerSideRowModelApiModule`
|
|
836
1239
|
*/
|
|
837
1240
|
setServerSideSelectionState(state: IServerSideSelectionState | IServerSideGroupSelectionState): void;
|
|
838
|
-
/**
|
|
1241
|
+
/**
|
|
1242
|
+
* Apply transactions to the server side row model.
|
|
1243
|
+
* @agModule `ServerSideRowModelApiModule`
|
|
1244
|
+
*/
|
|
839
1245
|
applyServerSideTransaction(transaction: ServerSideTransaction): ServerSideTransactionResult<TData> | undefined;
|
|
840
|
-
/**
|
|
1246
|
+
/**
|
|
1247
|
+
* Batch apply transactions to the server side row model.
|
|
1248
|
+
* @agModule `ServerSideRowModelApiModule`
|
|
1249
|
+
*/
|
|
841
1250
|
applyServerSideTransactionAsync(transaction: ServerSideTransaction, callback?: (res: ServerSideTransactionResult<TData>) => void): void;
|
|
842
1251
|
/**
|
|
843
1252
|
* Applies row data to a server side store.
|
|
844
1253
|
* New rows will overwrite rows at the same index in the same way as if provided by a datasource success callback.
|
|
1254
|
+
* @agModule `ServerSideRowModelApiModule`
|
|
845
1255
|
*/
|
|
846
1256
|
applyServerSideRowData(params: {
|
|
847
1257
|
successParams: LoadSuccessParams<TData>;
|
|
848
1258
|
route?: string[];
|
|
849
1259
|
startRow?: number;
|
|
850
1260
|
}): void;
|
|
851
|
-
/**
|
|
1261
|
+
/**
|
|
1262
|
+
* Gets all failed server side loads to retry.
|
|
1263
|
+
* @agModule `ServerSideRowModelApiModule`
|
|
1264
|
+
*/
|
|
852
1265
|
retryServerSideLoads(): void;
|
|
1266
|
+
/**
|
|
1267
|
+
* Flush all pending async transactions.
|
|
1268
|
+
* @agModule `ServerSideRowModelApiModule`
|
|
1269
|
+
*/
|
|
853
1270
|
flushServerSideAsyncTransactions(): void;
|
|
854
1271
|
/**
|
|
855
1272
|
* Refresh a server-side store level.
|
|
856
1273
|
* If you pass no parameters, then the top level store is refreshed.
|
|
857
1274
|
* To refresh a child level, pass in the string of keys to get to the desired level.
|
|
858
1275
|
* Once the store refresh is complete, the storeRefreshed event is fired.
|
|
1276
|
+
* @agModule `ServerSideRowModelApiModule`
|
|
859
1277
|
*/
|
|
860
1278
|
refreshServerSide(params?: RefreshServerSideParams): void;
|
|
861
|
-
/**
|
|
1279
|
+
/**
|
|
1280
|
+
* Returns info on all server side group levels.
|
|
1281
|
+
* @agModule `ServerSideRowModelApiModule`
|
|
1282
|
+
*/
|
|
862
1283
|
getServerSideGroupLevelState(): ServerSideGroupLevelState[];
|
|
863
1284
|
}
|
|
864
1285
|
export interface _ContextMenuGridApi {
|
|
865
1286
|
/**
|
|
866
1287
|
* Displays the AG Grid context menu
|
|
1288
|
+
* @agModule `ContextMenuModule`
|
|
867
1289
|
*/
|
|
868
1290
|
showContextMenu(params?: IContextMenuParams): void;
|
|
869
1291
|
}
|
|
870
1292
|
export interface _ColumnChooserGridApi {
|
|
871
|
-
/**
|
|
1293
|
+
/**
|
|
1294
|
+
* Show the column chooser.
|
|
1295
|
+
* @agModule `ColumnMenuModule`
|
|
1296
|
+
*/
|
|
872
1297
|
showColumnChooser(params?: ColumnChooserParams): void;
|
|
873
|
-
/**
|
|
1298
|
+
/**
|
|
1299
|
+
* Hide the column chooser if visible.
|
|
1300
|
+
* @agModule `ColumnMenuModule`
|
|
1301
|
+
*/
|
|
874
1302
|
hideColumnChooser(): void;
|
|
875
1303
|
}
|
|
876
1304
|
export interface _MasterDetailGridApi {
|
|
877
|
-
/**
|
|
1305
|
+
/**
|
|
1306
|
+
* Register a detail grid with the master grid when it is created.
|
|
1307
|
+
* @agModule `MasterDetailModule`
|
|
1308
|
+
*/
|
|
878
1309
|
addDetailGridInfo(id: string, gridInfo: DetailGridInfo): void;
|
|
879
|
-
/**
|
|
1310
|
+
/**
|
|
1311
|
+
* Unregister a detail grid from the master grid when it is destroyed.
|
|
1312
|
+
* @agModule `MasterDetailModule`
|
|
1313
|
+
*/
|
|
880
1314
|
removeDetailGridInfo(id: string): void;
|
|
881
|
-
/**
|
|
1315
|
+
/**
|
|
1316
|
+
* Returns the `DetailGridInfo` corresponding to the supplied `detailGridId`.
|
|
1317
|
+
* @agModule `MasterDetailModule`
|
|
1318
|
+
*/
|
|
882
1319
|
getDetailGridInfo(id: string): DetailGridInfo | undefined;
|
|
883
|
-
/**
|
|
1320
|
+
/**
|
|
1321
|
+
* Iterates through each `DetailGridInfo` in the grid and calls the supplied callback on each.
|
|
1322
|
+
* @agModule `MasterDetailModule`
|
|
1323
|
+
*/
|
|
884
1324
|
forEachDetailGridInfo(callback: (gridInfo: DetailGridInfo, index: number) => void): void;
|
|
885
1325
|
}
|
|
886
1326
|
export interface _ExcelExportGridApi {
|
|
887
|
-
/**
|
|
1327
|
+
/**
|
|
1328
|
+
* Similar to `exportDataAsExcel`, except instead of downloading a file, it will return a [Blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob) to be processed by the user.
|
|
1329
|
+
* @agModule `ExcelExportModule`
|
|
1330
|
+
*/
|
|
888
1331
|
getDataAsExcel(params?: ExcelExportParams): string | Blob | undefined;
|
|
889
|
-
/**
|
|
1332
|
+
/**
|
|
1333
|
+
* Downloads an Excel export of the grid's data.
|
|
1334
|
+
* @agModule `ExcelExportModule`
|
|
1335
|
+
*/
|
|
890
1336
|
exportDataAsExcel(params?: ExcelExportParams): void;
|
|
891
|
-
/**
|
|
1337
|
+
/**
|
|
1338
|
+
* This is method to be used to get the grid's data as a sheet, that will later be exported either by `getMultipleSheetsAsExcel()` or `exportMultipleSheetsAsExcel()`.
|
|
1339
|
+
* @agModule `ExcelExportModule`
|
|
1340
|
+
*/
|
|
892
1341
|
getSheetDataForExcel(params?: ExcelExportParams): string | undefined;
|
|
893
|
-
/**
|
|
1342
|
+
/**
|
|
1343
|
+
* Similar to `exportMultipleSheetsAsExcel`, except instead of downloading a file, it will return a [Blob](https://developer.mozilla.org/en-US/docs/Web/API/Blob) to be processed by the user.
|
|
1344
|
+
* @agModule `ExcelExportModule`
|
|
1345
|
+
*/
|
|
894
1346
|
getMultipleSheetsAsExcel(params: ExcelExportMultipleSheetParams): Blob | undefined;
|
|
895
|
-
/**
|
|
1347
|
+
/**
|
|
1348
|
+
* Downloads an Excel export of multiple sheets in one file.
|
|
1349
|
+
* @agModule `ExcelExportModule`
|
|
1350
|
+
*/
|
|
896
1351
|
exportMultipleSheetsAsExcel(params: ExcelExportMultipleSheetParams): void;
|
|
897
1352
|
}
|
|
898
1353
|
export interface _ClipboardGridApi {
|
|
899
|
-
/**
|
|
1354
|
+
/**
|
|
1355
|
+
* Copies data to clipboard by following the same rules as pressing Ctrl+C.
|
|
1356
|
+
* @agModule `ClipboardModule`
|
|
1357
|
+
*/
|
|
900
1358
|
copyToClipboard(params?: IClipboardCopyParams): void;
|
|
901
|
-
/**
|
|
1359
|
+
/**
|
|
1360
|
+
* Cuts data to clipboard by following the same rules as pressing Ctrl+X.
|
|
1361
|
+
* @agModule `ClipboardModule`
|
|
1362
|
+
*/
|
|
902
1363
|
cutToClipboard(params?: IClipboardCopyParams): void;
|
|
903
|
-
/**
|
|
1364
|
+
/**
|
|
1365
|
+
* Copies the selected rows to the clipboard.
|
|
1366
|
+
* @agModule `ClipboardModule`
|
|
1367
|
+
*/
|
|
904
1368
|
copySelectedRowsToClipboard(params?: IClipboardCopyRowsParams): void;
|
|
905
|
-
/**
|
|
1369
|
+
/**
|
|
1370
|
+
* Copies the selected ranges to the clipboard.
|
|
1371
|
+
* @agModule `ClipboardModule`
|
|
1372
|
+
*/
|
|
906
1373
|
copySelectedRangeToClipboard(params?: IClipboardCopyParams): void;
|
|
907
|
-
/**
|
|
1374
|
+
/**
|
|
1375
|
+
* Copies the selected range down, similar to `Ctrl + D` in Excel.
|
|
1376
|
+
* @agModule `ClipboardModule`
|
|
1377
|
+
*/
|
|
908
1378
|
copySelectedRangeDown(): void;
|
|
909
|
-
/**
|
|
1379
|
+
/**
|
|
1380
|
+
* Pastes the data from the Clipboard into the focused cell of the grid. If no grid cell is focused, calling this method has no effect.
|
|
1381
|
+
* @agModule `ClipboardModule`
|
|
1382
|
+
*/
|
|
910
1383
|
pasteFromClipboard(): void;
|
|
911
1384
|
}
|
|
912
1385
|
export interface _GridChartsGridApi {
|
|
913
|
-
/**
|
|
1386
|
+
/**
|
|
1387
|
+
* Returns a list of models with information about the charts that are currently rendered from the grid.
|
|
1388
|
+
* @agModule `IntegratedChartsModule`
|
|
1389
|
+
*/
|
|
914
1390
|
getChartModels(): ChartModel[] | undefined;
|
|
915
|
-
/**
|
|
1391
|
+
/**
|
|
1392
|
+
* Returns the `ChartRef` using the supplied `chartId`.
|
|
1393
|
+
* @agModule `IntegratedChartsModule`
|
|
1394
|
+
*/
|
|
916
1395
|
getChartRef(chartId: string): ChartRef | undefined;
|
|
917
|
-
/**
|
|
1396
|
+
/**
|
|
1397
|
+
* Returns a base64-encoded image data URL for the referenced chartId.
|
|
1398
|
+
* @agModule `IntegratedChartsModule`
|
|
1399
|
+
*/
|
|
918
1400
|
getChartImageDataURL(params: GetChartImageDataUrlParams): string | undefined;
|
|
919
|
-
/**
|
|
1401
|
+
/**
|
|
1402
|
+
* Starts a browser-based image download for the referenced chartId.
|
|
1403
|
+
* @agModule `IntegratedChartsModule`
|
|
1404
|
+
*/
|
|
920
1405
|
downloadChart(params: ChartDownloadParams): void;
|
|
921
|
-
/**
|
|
1406
|
+
/**
|
|
1407
|
+
* Open the Chart Tool Panel.
|
|
1408
|
+
* @agModule `IntegratedChartsModule`
|
|
1409
|
+
*/
|
|
922
1410
|
openChartToolPanel(params: OpenChartToolPanelParams): void;
|
|
923
|
-
/**
|
|
1411
|
+
/**
|
|
1412
|
+
* Close the Chart Tool Panel.
|
|
1413
|
+
* @agModule `IntegratedChartsModule`
|
|
1414
|
+
*/
|
|
924
1415
|
closeChartToolPanel(params: CloseChartToolPanelParams): void;
|
|
925
|
-
/**
|
|
1416
|
+
/**
|
|
1417
|
+
* Used to programmatically create charts from a range.
|
|
1418
|
+
* @agModule `IntegratedChartsModule`
|
|
1419
|
+
*/
|
|
926
1420
|
createRangeChart(params: CreateRangeChartParams): ChartRef | undefined;
|
|
927
|
-
/**
|
|
1421
|
+
/**
|
|
1422
|
+
* Used to programmatically create pivot charts from a grid.
|
|
1423
|
+
* @agModule `IntegratedChartsModule`
|
|
1424
|
+
*/
|
|
928
1425
|
createPivotChart(params: CreatePivotChartParams): ChartRef | undefined;
|
|
929
|
-
/**
|
|
1426
|
+
/**
|
|
1427
|
+
* Used to programmatically create cross filter charts from a range.
|
|
1428
|
+
* @agModule `IntegratedChartsModule`
|
|
1429
|
+
*/
|
|
930
1430
|
createCrossFilterChart(params: CreateCrossFilterChartParams): ChartRef | undefined;
|
|
931
|
-
/**
|
|
1431
|
+
/**
|
|
1432
|
+
* Used to programmatically update a chart.
|
|
1433
|
+
* @agModule `IntegratedChartsModule`
|
|
1434
|
+
*/
|
|
932
1435
|
updateChart(params: UpdateChartParams): void;
|
|
933
|
-
/**
|
|
1436
|
+
/**
|
|
1437
|
+
* Restores a chart using the `ChartModel` that was previously obtained from `getChartModels()`.
|
|
1438
|
+
* @agModule `IntegratedChartsModule`
|
|
1439
|
+
*/
|
|
934
1440
|
restoreChart(chartModel: ChartModel, chartContainer?: HTMLElement): ChartRef | undefined;
|
|
935
1441
|
}
|
|
936
1442
|
export interface _AdvancedFilterGridApi {
|
|
937
|
-
/**
|
|
1443
|
+
/**
|
|
1444
|
+
* Get the state of the Advanced Filter. Used for saving Advanced Filter state
|
|
1445
|
+
* @agModule `AdvancedFilterModule`
|
|
1446
|
+
*/
|
|
938
1447
|
getAdvancedFilterModel(): AdvancedFilterModel | null;
|
|
939
|
-
/**
|
|
1448
|
+
/**
|
|
1449
|
+
* Set the state of the Advanced Filter. Used for restoring Advanced Filter state
|
|
1450
|
+
* @agModule `AdvancedFilterModule`
|
|
1451
|
+
*/
|
|
940
1452
|
setAdvancedFilterModel(advancedFilterModel: AdvancedFilterModel | null): void;
|
|
941
|
-
/**
|
|
1453
|
+
/**
|
|
1454
|
+
* Open the Advanced Filter Builder dialog (if enabled).
|
|
1455
|
+
* @agModule `AdvancedFilterModule`
|
|
1456
|
+
*/
|
|
942
1457
|
showAdvancedFilterBuilder(): void;
|
|
943
1458
|
/**
|
|
944
1459
|
* Closes the Advanced Filter Builder dialog (if enabled).
|
|
945
1460
|
* Un-applied changes are discarded.
|
|
1461
|
+
* @agModule `AdvancedFilterModule`
|
|
946
1462
|
*/
|
|
947
1463
|
hideAdvancedFilterBuilder(): void;
|
|
948
1464
|
}
|