Column Autosizing

LyteNyte Grid can automatically size columns to fit their content. Columns don't need to be visible to be autosized - the LyteNyte Grid uses custom heuristic functions to determine the optimal width based on the content.

Column autosizing can consider header width, cell content width, or both. For each column, you can define headerAutosizeFunc and cellAutosizeFn to control how widths are calculated. When these functions aren't provided, LyteNyte Grid uses a default function that measures text width.

Since LyteNyte Grid emphasizes custom header and cell renderers for highlighting important content, we recommend providing matching autosize functions when using custom renderers to ensure accurate sizing calculations.

Autosizing API

LyteNyte Grid provides two API methods for autosizing columns: autosizeColumn for individual columns and autosizeColumns for multiple or all columns. You can mark specific columns to be skipped during bulk autosizing by setting their cellSkipOnAutosizeAll property to true.

TODO;

Both autosize methods return an AutosizeResult object containing key-value pairs where keys are column ids and values are the newly calculated sizes. These methods also support a "dry run" option that performs calculations without applying changes to the grid state. For complete details, consult the API Reference.

Header Autosizing

You can provide a custom header autosize function via the headerAutosizeFunc property on any column. This function will be used when you want headers to be considered during autosize calculations.

TODO;

Cell Autosizing

The cellAutosizeFn determines how LyteNyte Grid calculates the optimal width for cells in a column. Each column can have its own unique autosize function. When using custom cell renderers, you should provide a matching cellAutosizeFn to ensure accurate sizing.

TODO;

Virtualization Considerations

LyteNyte Grid uses row virtualization to maximize performance, which means only currently visible rows are considered when calculating cell sizes. If the grid viewport hasn't been initialized yet, the LyteNyte Grid falls back to using approximately 50 rows for calculations.

This approach works well in most cases, but some situations may require more specialized handling. For columns with a known set of possible values, a useful strategy is to define an autosize function that returns the maximum possible width for those values, regardless of which rows are currently displayed.

TODO;