VirtualizationSettings

Configures virtualization behavior for Grid rendering and performance optimization. Provides comprehensive options for enabling virtualization, defining DOM type (rows, columns, or both), customizing buffer sizes, and controlling scroll strategies and caching behavior. Virtualization dramatically improves grid performance with large datasets by rendering only visible content.

Props

The following table outlines the props for the VirtualizationSettings:

NameTypeDefaultDescription
enableCache
boolean
true

Enables caching of virtualized content to optimize performance during repeated browsing. When true, previously loaded and rendered data segments are cached in memory to avoid re-fetching from the server when returning to previously viewed ranges. When false, every viewport change or navigation to a previously viewed range triggers a new data request from the server. Generally recommended to be true for improved performance, unless memory constraints are a concern with extremely large datasets.

enabled
boolean
true

Enables or disables virtualization for the grid. When true, only visible rows and columns in the viewport are rendered in the DOM, significantly improving performance with large datasets. When false, all rows and columns are rendered, which may impact performance on grids with thousands of rows or columns.

preventMaxRenderedRows
boolean
false

Controls maximum row rendering behavior when row virtualization is disabled or not fully active. When enabled, restricts the total number of rendered rows to avoid excessive DOM growth in non-virtualized layouts or column-only virtualized scenarios. Automatically increases the default row buffer value from 5 to 500 to maintain stable rendering performance in large data scenarios. Useful for improving layout stability, reducing unnecessary DOM elements, minimizing reflow operations, and optimizing repaint performance.

scrollMode
ScrollMode.Auto

Specifies the scroll mode for server-side virtualization and data loading. Determines how the grid loads and manages row data during scrolling operations. This property controls the integration between virtualization and data loading strategies.

type
VirtualDomType.Both

Specifies the virtualization type to determine which dimensions are virtualized. Allows independent control over row and column virtualization strategies.

viewPortBuffer
{ rows: 5, columns: 5 }

Defines buffer settings for rows and columns outside the viewport. The buffer represents extra rows and columns rendered beyond the visible viewport to reduce flickering and improve perceived scrolling smoothness during rapid scrolling.