The grid object encapsulates the full LyteNyte Grid instance, including its state, view, and imperative API.
It is returned by the useLyteNyte
hook and serves as the primary interface for interacting with the grid programmatically.
The imperative API of LyteNyte Grid for triggering actions such as column resizing, row expansion, and selection.
Type | GridApi |
The declarative state of LyteNyte Grid. This contains all core and optional features represented as atoms.
Type | GridState |
The current layout view of the grid, reflecting visible headers and rows based on virtualization and scroll position.
Type | GridAtomReadonly |
The declarative state object of LyteNyte Grid. This state encapsulates all mutable and observable grid properties that affect layout, data, selection, and rendering. Updating any of these atoms will trigger corresponding changes in the grid UI. These state values can also be used to create and synchronize external components such as toolbars, panels, or widgets.
The aggregation model configuration for the grid. Each entry maps a column id to its associated aggregation function. Aggregation results are typically displayed in group or summary rows.
Type | GridAtom |
A registry of named cell renderer functions. These can be referenced by name in individual column definitions to customize cell rendering behavior.
Type | GridAtom |
Controls the grid's current cell selection mode. This determines how users may interact with and select individual or grouped cells.
Type | GridAtom |
An array of cell selections currently active in the grid. Each selection is a rectangular range of selected cells, useful for bulk editing, clipboard actions, or analytics.
Type | GridAtom |
Specifies the number of extra columns to render after the last visible column. Helps with smoother horizontal scrolling to the right.
Type | GridAtom |
Specifies the number of extra columns to render before the first visible column. Helps with smoother horizontal scrolling to the left.
Type | GridAtom |
Controls how many columns back the grid should look when computing layout for column-spanning cells. Larger values allow broader spans but can reduce rendering efficiency.
Type | GridAtom |
A base column configuration object used as a fallback for individual columns.
Type | GridAtom |
If true, double-clicking on a column's resize handle will trigger an autosize for that column based on its content.
Type | GridAtom |
The default expansion state for column groups when no specific state has been set.
Type | GridAtom |
A map of column group ids to their expansion state. This controls whether individual groups are expanded or collapsed. Direct mutation bypasses grid events.
Type | GridAtom |
The delimiter string used to construct hierarchical column group ids by joining nested keys.
Type | GridAtom |
Computed metadata about the column group structure in the grid. This is used internally for layout and interaction logic involving grouped headers.
Type | GridAtomReadonly |
Configuration object for the marker column, which is often used to indicate row-specific states like expansion or editing.
Type | GridAtom |
Enables or disables the marker column in the grid.
Type | GridAtom |
Computed metadata for each column in the grid, including rendering metrics and positional information. Useful for custom layout or advanced plugin behavior.
Type | GridAtomReadonly |
Tracks the expansion state of column groups generated by pivot operations. Each key is a group id, and the value indicates whether it's expanded or collapsed.
Type | GridAtom |
The generated columns from the current pivot model. These columns represent data values derived from pivot operations. They may be updated, but changes may be overridden if the pivot model changes.
Type | GridAtom |
Controls whether column pivoting is enabled in the grid. When true, pivot columns will be generated based on the active pivot model.
Type | GridAtom |
The current column pivot model in use. This model defines how column pivoting is structured in the grid and which columns are used to generate pivot dimensions.
Type | GridAtom |
Tracks the expansion state of row groups generated by the current pivot model. Each key is a row group id, and the value determines its expansion state.
Type | GridAtom |
All column definitions registered in the grid, including both visible and hidden columns.
Type | GridAtom |
Controls whether columns should automatically resize to fit the available width of the grid viewport.
Type | GridAtom |
A dictionary of dialog frames currently managed by the grid. These frames can be programmatically
opened or closed using the dialogFrameOpen
and dialogFrameClose
API methods.
Type | GridAtom |
Represents the current active edit position in the grid. If no edit is active, this is null.
Type | GridAtomReadonly |
Determines the cell edit mode for the grid. Modes include read-only and editable states.
Type | GridAtom |
Specifies the mouse interaction pattern (e.g., single click, double click) required to activate a cell edit.
Type | GridAtom |
A map of named edit renderers. These renderers are used to customize the editing experience for cells in editable columns.
Type | GridAtom |
A function used to validate updates to a row during an edit. This validator can prevent invalid edits before they are applied to the grid state.
Type | GridAtom |
The in (set) filter model to apply to LyteNyte Grid.
Type | GridAtom |
An array of filters currently applied to the grid. If empty, no filters are active.
Type | GridAtom |
A map of named floating row cell renderers. These renderers can be assigned by name in the floating row column configurations.
Type | GridAtom |
Controls whether the floating row is enabled in the grid. When enabled, the floating row appears fixed below the column headers.
Type | GridAtom |
Specifies the height, in pixels, of the floating row when enabled.
Type | GridAtom |
A unique identifier associated with the grid instance.
Type | GridAtom |
A map of named header cell renderers. These can be referenced in column definitions to customize how column headers are displayed.
Type | GridAtom |
The vertical height (in pixels) allocated for grouped header rows, if present.
Type | GridAtom |
The vertical height (in pixels) allocated for the header row of the grid.
Type | GridAtom |
The total height (in pixels) of all rows currently present in the grid.
Type | GridAtomReadonly |
A dictionary of popover frames currently managed by the grid. These can be dynamically shown
or hidden using the popoverFrameOpen
and popoverFrameClose
API methods.
Type | GridAtom |
Represents the current quick search input applied to the grid. When set, rows will be filtered using this value. If null or an empty string, no quick search filtering will be applied.
Type | GridAtom |
Specifies whether the quick search is case-sensitive or insensitive. Controls how text is matched during quick search filtering.
Type | GridAtom |
A fallback row height (in pixels) used before actual row heights are measured. Especially useful when rendering rows with dynamic or unknown content heights.
Type | GridAtom |
The configured row data source for the grid. This defines how rows are fetched, paged, or streamed into the grid.
Type | GridAtom |
The backing store for row data within the grid. This is managed internally and should not be mutated directly unless implementing a custom data source.
Type | RowDataStore |
The default estimated height for row detail sections before their actual height has been measured.
Type | GridAtom |
Represents the set of row ids with expanded row detail sections.
Type | GridAtom |
Specifies the height of the row detail section when expanded.
Type | GridAtom |
The function that renders additional row detail content when a row is expanded.
Type | GridAtom |
A predicate function used to determine whether a given row should be rendered as a full-width row. Full-width rows span across all columns and bypass standard cell layout.
Type | GridAtom |
The component function that renders full-width rows in the grid. This renderer is called whenever a row matches the full-width predicate.
Type | GridAtom |
Defines the template or configuration for the automatically generated row group column. This controls its appearance and behavior.
Type | GridAtom |
Controls the default expansion state of all row groups. If a number is provided, groups up to that depth will be expanded by default.
Type | GridAtom |
Specifies how automatically generated row group columns should be displayed in the grid. This controls their visibility and layout.
Type | GridAtom |
An object mapping row group ids to their expansion state. Updating this directly will not trigger grid events and should be done with care.
Type | GridAtom |
An array representing the fields or columns being used to group rows. An empty array disables row grouping.
Type | GridAtom |
The height configuration for rows in the grid. This may be a fixed number, a function, or a configuration object.
Type | GridAtom |
Specifies the number of additional rows to render below the visible viewport. Increasing this value can reduce flickering when scrolling downward, but may negatively impact rendering performance.
Type | GridAtom |
Specifies the number of additional rows to render above the visible viewport. Increasing this value can reduce visible loading artifacts when scrolling upward, at the cost of performance.
Type | GridAtom |
Controls how many rows back the grid should look when computing layout for row-spanning cells. Higher values allow larger spans but impact performance.
Type | GridAtom |
If true, selecting a parent row will automatically select its child rows. Useful for hierarchical or grouped data selection.
Type | GridAtom |
A set of selected row ids in the grid.
Type | GridAtom |
Specifies the interaction pattern or input trigger that initiates row selection, such as clicks or keyboard inputs.
Type | GridAtom |
Specifies the selection mode of the grid, such as single or multiple row selection.
Type | GridAtom |
Identifies the anchor row used for shift-based range selections. Defines the selection starting point.
Type | GridAtom |
Boolean flag that determines whether the grid renders in right-to-left (RTL) mode.
Type | GridAtom |
An array representing the current sort state of the grid. Each entry defines a column and its sort direction. An empty array means no active sorting.
Type | GridAtom |
The current view bounds of the grid, representing the row and column segments that should be rendered based on scroll position and viewport.
Type | GridAtomReadonly |
The HTML element representing the viewport of the grid. May be null before initialization.
Type | GridAtom |
The internal height of the viewport, typically matching the clientHeight of the viewport element.
Type | GridAtom |
The outer height of the viewport, corresponding to its offsetHeight.
Type | GridAtom |
The internal width of the viewport, usually equal to the clientWidth of the viewport element.
Type | GridAtom |
The outer width of the viewport, corresponding to its offsetWidth.
Type | GridAtom |
Controls whether columns should be virtualized. Improves performance for large column sets by only rendering visible columns. Enabled by default.
Type | GridAtom |
Controls whether rows should be virtualized. Improves performance for large datasets by only rendering visible rows. Enabled by default.
Type | GridAtom |
The total combined width (in pixels) of all visible columns in the grid.
Type | GridAtomReadonly |
The horizontal (x-axis) pixel positions of each visible column in the grid. Used to determine where each column should render on screen.
Type | GridAtomReadonly |
The vertical (y-axis) pixel positions of rows in the grid. Determines how each row is positioned within the scrollable area.
Type | GridAtomReadonly |
The initial props that may be passed to the useLyteNyte
hook. The hook
returns the state representation of LyteNyte Grid.
The initial aggregation model to apply to LyteNyte Grid.
No properties
The map of named cell renderers that can be referenced by name in the grid.
Type | Record |
The cell selection mode to use.
The initial cell selections in the grid.
No properties
The number of columns after the last visible column to render.
number
The number of columns before the first visible column to render.
number
The number of columns LyteNyte Grid should scan when computing layout.
number
The base column definition.
Type | ColumnBase |
A boolean indicating if double click to autosize a column should be enabled.
boolean
The default expansion state for column groups if not specified explicitly.
boolean
The initial expansion state for column groups.
Type | Record |
A delimiter used to concatenate group paths into a single group id.
string
The column marker definition.
Type | ColumnMarker |
A boolean indicating if the column marker should be visible.
boolean
A boolean indicating if the column pivot mode should be on.
boolean
The initial column pivot model to apply to LyteNyte Grid.
Type | ColumnPivotModel |
The initial column definitions.
No properties
Indicates whether the grid should size columns to fit the available width.
boolean
The dialog frames available in the grid.
Type | Record |
The initial cell edit mode.
Type | EditCellMode |
The mouse interaction that should begin cell editing.
The edit renderers that may be referenced by name.
Type | Record |
A function for validating grid updates at a row level.
The in (set) filter model to apply to LyteNyte Grid.
Type | Record |
The initial filter model to apply to the grid.
Type | Record |
The floating cell renderers that may be referenced by name.
Type | Record |
A boolean indicating if the floating row should be enabled.
boolean
The height in px of the floating row.
number
A unique identifier for the grid instance.
string
The header cell renderers that may be referenced by name.
Type | Record |
The height in pixels for the header groups.
number
The height in pixels that the header should occupy.
number
The popover frames available in the grid.
Type | Record |
The quick search filter value.
null | string
null
string
The case sensitivity of the quick search filter.
Initial height guess for auto-height rows, used before actual measurement.
number
The data source used by LyteNyte Grid to manage and provide row data.
Type | RowDataSource |
The initial guess of the height of a row detail area before the actual height is observed.
number
The initial row detail expansion state.
Type | Set |
The height of the row detail area.
Type | RowDetailHeight |
A function used to render the content for a row detail area.
The function predicate used to determine if a row should be rendered as full width.
The renderer used to render the content of a full width row.
Template for generating row group columns dynamically.
Type | RowGroupColumn |
Default expansion depth for row groups. Can be a boolean or a depth number.
number | boolean
number
boolean
The row group display mode to use in the grid.
Initial expansion state of specific row groups by row id.
No properties
The initial row group model configuration to apply.
No properties
Row height strategy used by LyteNyte Grid for rendering rows.
Type | RowHeight |
The number of rows below the last visible row to render.
number
The number of rows above the first visible row to render.
number
The number of rows LyteNyte Grid should scan when computing layout.
number
A boolean indicating if the row selection should select children as well.
boolean
The initial selected row ids.
Type | Set |
The mouse interaction that should begin row selection.
The row selection mode to use.
Type | RowSelectionMode |
Whether to use right-to-left rendering. If false, left-to-right is assumed.
boolean
The initial sort model to apply to the grid.
No properties
A boolean indicating if the columns in the grid should be virtualized.
boolean
A boolean indicating if the rows in the grid should be virtualized.
boolean