Documentation

Reference documentation for the vlist virtual list library. For learning content, see Tutorials.

Getting Started

Getting Started

Install, configure, and build your first virtual list

Framework Adapters

React, Vue, Svelte, and SolidJS integration

API Reference

Complete API — config, methods, events, types

TypeScript type definitions

Default values and thresholds

Low-level utilities and feature authoring

Features

All 8 features with examples, costs, and compatibility

2D grid layout with virtualized rows

Pinterest-style layout with shortest-lane placement

Grouped lists with sticky or inline headers

Async data loading with lazy loading and placeholders

Realistic skeleton loading states with zero template duplication

Single & multi-select with keyboard navigation

Handle 1M+ items with automatic scroll compression

Custom scrollbar UI with auto-hide and smooth dragging

Document-level scrolling with native browser scrollbar

Save and restore scroll position for SPA navigation

Under the Hood

Complete source code map

BuilderContext and feature system

DOM rendering and virtualization

Scroll controller, custom scrollbar, and velocity tracking

How vertical and horizontal share one code path

Item auto-size measurement

Resources

Live performance suites — FPS, render time, memory

Bundle analysis and tree-shaking optimization

2,268 tests passing, 36,595 assertions

Architecture, competitive position, and unique features

Interactive example documentation