property

Grid

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.

api

property

The imperative API of LyteNyte Grid for triggering actions such as column resizing, row expansion, and selection.

state

property

The declarative state of LyteNyte Grid. This contains all core and optional features represented as atoms.

view

property

The current layout view of the grid, reflecting visible headers and rows based on virtualization and scroll position.

property

GridState

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.

aggModel

property

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.

cellRenderers

property

A registry of named cell renderer functions. These can be referenced by name in individual column definitions to customize cell rendering behavior.

cellSelectionMode

property

Controls the grid's current cell selection mode. This determines how users may interact with and select individual or grouped cells.

cellSelections

property

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.

colOverscanEnd

property

Specifies the number of extra columns to render after the last visible column. Helps with smoother horizontal scrolling to the right.

colOverscanStart

property

Specifies the number of extra columns to render before the first visible column. Helps with smoother horizontal scrolling to the left.

colScanDistance

property

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.

columnBase

property

A base column configuration object used as a fallback for individual columns.

columnDoubleClickToAutosize

property

If true, double-clicking on a column's resize handle will trigger an autosize for that column based on its content.

columnGroupDefaultExpansion

property

The default expansion state for column groups when no specific state has been set.

columnGroupExpansions

property

A map of column group ids to their expansion state. This controls whether individual groups are expanded or collapsed. Direct mutation bypasses grid events.

columnGroupJoinDelimiter

property

The delimiter string used to construct hierarchical column group ids by joining nested keys.

columnGroupMeta

property

Computed metadata about the column group structure in the grid. This is used internally for layout and interaction logic involving grouped headers.

columnMarker

property

Configuration object for the marker column, which is often used to indicate row-specific states like expansion or editing.

columnMarkerEnabled

property

Enables or disables the marker column in the grid.

columnMeta

property

Computed metadata for each column in the grid, including rendering metrics and positional information. Useful for custom layout or advanced plugin behavior.

columnPivotColumnGroupExpansions

property

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.

columnPivotColumns

property

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.

columnPivotMode

property

Controls whether column pivoting is enabled in the grid. When true, pivot columns will be generated based on the active pivot model.

columnPivotModel

property

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.

columnPivotRowGroupExpansions

property

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.

columns

property

All column definitions registered in the grid, including both visible and hidden columns.

columnSizeToFit

property

Controls whether columns should automatically resize to fit the available width of the grid viewport.

dialogFrames

property

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.

editActivePosition

property

Represents the current active edit position in the grid. If no edit is active, this is null.

editCellMode

property

Determines the cell edit mode for the grid. Modes include read-only and editable states.

editClickActivator

property

Specifies the mouse interaction pattern (e.g., single click, double click) required to activate a cell edit.

editRenderers

property

A map of named edit renderers. These renderers are used to customize the editing experience for cells in editable columns.

editRowValidatorFn

property

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.

filterInModel

property

The in (set) filter model to apply to LyteNyte Grid.

filterModel

property

An array of filters currently applied to the grid. If empty, no filters are active.

floatingCellRenderers

property

A map of named floating row cell renderers. These renderers can be assigned by name in the floating row column configurations.

floatingRowEnabled

property

Controls whether the floating row is enabled in the grid. When enabled, the floating row appears fixed below the column headers.

floatingRowHeight

property

Specifies the height, in pixels, of the floating row when enabled.

gridId

property

A unique identifier associated with the grid instance.

headerCellRenderers

property

A map of named header cell renderers. These can be referenced in column definitions to customize how column headers are displayed.

headerGroupHeight

property

The vertical height (in pixels) allocated for grouped header rows, if present.

headerHeight

property

The vertical height (in pixels) allocated for the header row of the grid.

heightTotal

property

The total height (in pixels) of all rows currently present in the grid.

popoverFrames

property

A dictionary of popover frames currently managed by the grid. These can be dynamically shown or hidden using the popoverFrameOpen and popoverFrameClose API methods.

quickSearch

property

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.

quickSearchSensitivity

property

Specifies whether the quick search is case-sensitive or insensitive. Controls how text is matched during quick search filtering.

rowAutoHeightGuess

property

A fallback row height (in pixels) used before actual row heights are measured. Especially useful when rendering rows with dynamic or unknown content heights.

rowDataSource

property

The configured row data source for the grid. This defines how rows are fetched, paged, or streamed into the grid.

rowDataStore

property

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.

rowDetailAutoHeightGuess

property

The default estimated height for row detail sections before their actual height has been measured.

rowDetailExpansions

property

Represents the set of row ids with expanded row detail sections.

rowDetailHeight

property

Specifies the height of the row detail section when expanded.

rowDetailRenderer

property

The function that renders additional row detail content when a row is expanded.

rowFullWidthPredicate

property

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.

rowFullWidthRenderer

property

The component function that renders full-width rows in the grid. This renderer is called whenever a row matches the full-width predicate.

rowGroupColumn

property

Defines the template or configuration for the automatically generated row group column. This controls its appearance and behavior.

rowGroupDefaultExpansion

property

Controls the default expansion state of all row groups. If a number is provided, groups up to that depth will be expanded by default.

rowGroupDisplayMode

property

Specifies how automatically generated row group columns should be displayed in the grid. This controls their visibility and layout.

rowGroupExpansions

property

An object mapping row group ids to their expansion state. Updating this directly will not trigger grid events and should be done with care.

rowGroupModel

property

An array representing the fields or columns being used to group rows. An empty array disables row grouping.

rowHeight

property

The height configuration for rows in the grid. This may be a fixed number, a function, or a configuration object.

rowOverscanBottom

property

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.

rowOverscanTop

property

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.

rowScanDistance

property

Controls how many rows back the grid should look when computing layout for row-spanning cells. Higher values allow larger spans but impact performance.

rowSelectChildren

property

If true, selecting a parent row will automatically select its child rows. Useful for hierarchical or grouped data selection.

rowSelectedIds

property

A set of selected row ids in the grid.

rowSelectionActivator

property

Specifies the interaction pattern or input trigger that initiates row selection, such as clicks or keyboard inputs.

rowSelectionMode

property

Specifies the selection mode of the grid, such as single or multiple row selection.

rowSelectionPivot

property

Identifies the anchor row used for shift-based range selections. Defines the selection starting point.

rtl

property

Boolean flag that determines whether the grid renders in right-to-left (RTL) mode.

sortModel

property

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.

viewBounds

property

The current view bounds of the grid, representing the row and column segments that should be rendered based on scroll position and viewport.

viewport

property

The HTML element representing the viewport of the grid. May be null before initialization.

viewportHeightInner

property

The internal height of the viewport, typically matching the clientHeight of the viewport element.

viewportHeightOuter

property

The outer height of the viewport, corresponding to its offsetHeight.

viewportWidthInner

property

The internal width of the viewport, usually equal to the clientWidth of the viewport element.

viewportWidthOuter

property

The outer width of the viewport, corresponding to its offsetWidth.

virtualizeCols

property

Controls whether columns should be virtualized. Improves performance for large column sets by only rendering visible columns. Enabled by default.

virtualizeRows

property

Controls whether rows should be virtualized. Improves performance for large datasets by only rendering visible rows. Enabled by default.

widthTotal

property

The total combined width (in pixels) of all visible columns in the grid.

xPositions

property

The horizontal (x-axis) pixel positions of each visible column in the grid. Used to determine where each column should render on screen.

yPositions

property

The vertical (y-axis) pixel positions of rows in the grid. Determines how each row is positioned within the scrollable area.

property

UseLyteNyteProps

The initial props that may be passed to the useLyteNyte hook. The hook returns the state representation of LyteNyte Grid.

aggModel

property

The initial aggregation model to apply to LyteNyte Grid.

No properties

cellRenderers

property

The map of named cell renderers that can be referenced by name in the grid.

TypeRecord

cellSelectionMode

property

The cell selection mode to use.

cellSelections

property

The initial cell selections in the grid.

No properties

colOverscanEnd

property

The number of columns after the last visible column to render.

Type

number

colOverscanStart

property

The number of columns before the first visible column to render.

Type

number

colScanDistance

property

The number of columns LyteNyte Grid should scan when computing layout.

Type

number

columnBase

property

The base column definition.

columnDoubleClickToAutosize

property

A boolean indicating if double click to autosize a column should be enabled.

Type

boolean

columnGroupDefaultExpansion

property

The default expansion state for column groups if not specified explicitly.

Type

boolean

columnGroupExpansions

property

The initial expansion state for column groups.

TypeRecord

columnGroupJoinDelimiter

property

A delimiter used to concatenate group paths into a single group id.

Type

string

columnMarker

property

The column marker definition.

columnMarkerEnabled

property

A boolean indicating if the column marker should be visible.

Type

boolean

columnPivotMode

property

A boolean indicating if the column pivot mode should be on.

Type

boolean

columnPivotModel

property

The initial column pivot model to apply to LyteNyte Grid.

columns

property

The initial column definitions.

No properties

columnSizeToFit

property

Indicates whether the grid should size columns to fit the available width.

Type

boolean

dialogFrames

property

The dialog frames available in the grid.

TypeRecord

editCellMode

property

The initial cell edit mode.

editClickActivator

property

The mouse interaction that should begin cell editing.

editRenderers

property

The edit renderers that may be referenced by name.

TypeRecord

editRowValidatorFn

property

A function for validating grid updates at a row level.

filterInModel

property

The in (set) filter model to apply to LyteNyte Grid.

TypeRecord

filterModel

property

The initial filter model to apply to the grid.

TypeRecord

floatingCellRenderers

property

The floating cell renderers that may be referenced by name.

TypeRecord

floatingRowEnabled

property

A boolean indicating if the floating row should be enabled.

Type

boolean

floatingRowHeight

property

The height in px of the floating row.

Type

number

gridId

property

A unique identifier for the grid instance.

Type

string

headerCellRenderers

property

The header cell renderers that may be referenced by name.

TypeRecord

headerGroupHeight

property

The height in pixels for the header groups.

Type

number

headerHeight

property

The height in pixels that the header should occupy.

Type

number

popoverFrames

property

The popover frames available in the grid.

TypeRecord

quickSearch

property

The quick search filter value.

Type

null | string

Variants

  • null
  • string

quickSearchSensitivity

property

The case sensitivity of the quick search filter.

rowAutoHeightGuess

property

Initial height guess for auto-height rows, used before actual measurement.

Type

number

rowDataSource

property

The data source used by LyteNyte Grid to manage and provide row data.

rowDetailAutoHeightGuess

property

The initial guess of the height of a row detail area before the actual height is observed.

Type

number

rowDetailExpansions

property

The initial row detail expansion state.

TypeSet

rowDetailHeight

property

The height of the row detail area.

rowDetailRenderer

property

A function used to render the content for a row detail area.

rowFullWidthPredicate

property

The function predicate used to determine if a row should be rendered as full width.

rowFullWidthRenderer

property

The renderer used to render the content of a full width row.

rowGroupColumn

property

Template for generating row group columns dynamically.

rowGroupDefaultExpansion

property

Default expansion depth for row groups. Can be a boolean or a depth number.

Type

number | boolean

Variants

  • number
  • boolean

rowGroupDisplayMode

property

The row group display mode to use in the grid.

rowGroupExpansions

property

Initial expansion state of specific row groups by row id.

No properties

rowGroupModel

property

The initial row group model configuration to apply.

No properties

rowHeight

property

Row height strategy used by LyteNyte Grid for rendering rows.

rowOverscanBottom

property

The number of rows below the last visible row to render.

Type

number

rowOverscanTop

property

The number of rows above the first visible row to render.

Type

number

rowScanDistance

property

The number of rows LyteNyte Grid should scan when computing layout.

Type

number

rowSelectChildren

property

A boolean indicating if the row selection should select children as well.

Type

boolean

rowSelectedIds

property

The initial selected row ids.

TypeSet

rowSelectionActivator

property

The mouse interaction that should begin row selection.

rowSelectionMode

property

The row selection mode to use.

rtl

property

Whether to use right-to-left rendering. If false, left-to-right is assumed.

Type

boolean

sortModel

property

The initial sort model to apply to the grid.

No properties

virtualizeCols

property

A boolean indicating if the columns in the grid should be virtualized.

Type

boolean

virtualizeRows

property

A boolean indicating if the rows in the grid should be virtualized.

Type

boolean