petyosi/react-virtuoso
React Virtuoso
React Virtuoso is a React component library for rendering large datasets efficiently through virtualized lists, grids, tables, and chat interfaces. It automatically measures variable-height items at runtime, computes accurate scroll offsets without requiring fixed sizes, and renders only the items within the visible viewport plus a configurable buffer zone. The library manages scroll position through a state machine that tracks direction, position, and anchor items to handle auto-scroll, sticky headers, and bidirectional loading.
The library distinguishes itself with specialized components for common data display patterns, including grouped lists with sticky headers that remain fixed while scrolling through each group, chat message lists with auto-scroll and scroll position control for streaming responses, responsive multi-column grids and masonry layouts, and virtualized HTML tables with sticky headers and columns. It supports on-demand data loading triggered by scroll position, enabling endless scrolling and bidirectional data fetching. Each component can be customized by swapping default HTML elements, CSS classes, or styled components for the scroller, viewport, list, header, footer, and individual items.
The library provides declarative scroll control, programmatic scrolling to specific items, and flexible vertical alignment for short lists. It uses ResizeObserver to detect container and item dimension changes, recalculating scroll metrics and re-rendering visible items as needed. The documentation covers installation, component APIs, and configuration options for each virtualized layout type.
Features
- Scroll-Triggered Data Loaders - Provides scroll-triggered data loading for endless scrolling and bidirectional fetching in virtualized lists.
- Scroll-Triggered Data Loaders - Provides scroll-triggered data loading for endless scrolling and bidirectional fetching in virtualized lists.
- DOM Node Recycling - Renders only visible items plus a configurable overscan buffer, recycling DOM nodes for smooth scrolling.
- Scroll-Based Resource Loading - Provides scroll-triggered data loading for endless scrolling and bidirectional fetching.
- Index-Based Scroll Anchoring - Implements index-based scroll anchoring to maintain visual position when items are added or removed.
- Auto-Scrolling Viewports - Automatically scrolls to the latest message when new content arrives in chat interfaces.
- Chat Message List Renderers - Renders chat message lists with auto-scroll, scroll position control, and support for streaming responses.
- Virtualized Chat Message Lists - Ships a virtualized chat message list component with auto-scroll and streaming response support.
- Virtualized List Rendering - Renders large lists efficiently by displaying only items in the visible viewport.
- Virtual Grid Renderers - Provides a virtualized grid component for responsive multi-column and masonry layouts with large datasets.
- Infinite Scrolling - Implements infinite scrolling with automatic content loading as the user scrolls through virtualized lists.
- Virtualized Grouped Lists - Provides a React component for grouped lists with virtualized items and sticky headers.
- Sticky Header Grouped Lists - Renders grouped lists with sticky headers that remain fixed while scrolling through each group's items.
- Virtualized Grouped Lists - Renders grouped lists with virtualized items and sticky headers that remain fixed while scrolling through each group.
- Dynamic Item Size Calculators - Automatically measures and renders items of varying heights without requiring manual size calculations.
- Runtime Height Caching - Provides automatic runtime measurement and caching of variable item heights for accurate virtualized scrolling.
- Virtualized Variable-Height Items - Automatically measures and adjusts variable-height items in virtualized lists at runtime.
- Message List Renderers - Renders virtualized message lists with auto-scroll and scroll position control for conversation histories.
- Virtual Scroll Layout Recalculators - Uses ResizeObserver to dynamically recalculate scroll metrics when container or item dimensions change.
- Infinite Scroll Triggers - Triggers loading of additional content when the user scrolls to the end of the list.
- Scroll State Machines - Maintains a scroll position state machine to coordinate auto-scroll, sticky headers, and bidirectional loading.
- Grouped List Sticky Headers - Ships a specialized component that renders grouped lists with sticky headers that swap at group boundaries.
- Virtual List Renderers - Provides a virtualized list renderer that accepts custom UI components for items, groups, and containers.
- Virtualized Data Tables - Ships a virtualized HTML table component with sticky headers, columns, and row virtualization.
- Virtualized List Rendering - Renders large datasets efficiently by displaying only visible items in the viewport with automatic variable height handling.
- CSS Class and Styled Component Styling - Provides CSS class and styled component overrides for customizing grid item and list styling.
- Component Slot Customization - Allows swapping default header, footer, sticky elements, and loading indicators with custom components.
- Virtual Scroller Structure Overrides - Lets developers override the default HTML elements for the scroller, viewport, list, header, footer, and empty placeholder.
- Virtualized - Allows replacing default item, group, or list containers with custom React components for virtualized rows.
- Column-Based Responsive Grids - Provides a responsive multi-column grid that adapts to screen width through CSS-based column sizing.
- Virtualized - Ships a virtualized masonry layout for product listings and image galleries.
- Responsive Grid Layouts - Provides a responsive multi-column grid component that adapts to screen width using CSS-controlled layout.
- Scroll Position Maintenance - Updates scroll position automatically based on data property changes with smooth animation.
- Scroll-to-Index Mappers - Scrolls the virtual list to bring a specific item index into view with alignment options.
- Virtual Scrollers - Provides a virtual scroller component whose internal HTML structure can be customized via element overrides.
