npm / vue-virtual-scroller
vue-virtual-scroller
What changed in vue-virtual-scroller 2 to 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.
1 breaking1 deprecations9 new APIs and options2 performance3 behavior and defaults1 tooling15 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initvue-virtual-scroller 323 changes
Breaking changes 1
handleScroll was removed from the return value as part of simplifying headless usage.
Deprecations 1
Deprecates the sizeDependencies prop.
New APIs and options 5
Page mode supports an explicit scroll parent and can find the nearest parent scroller.
Adds the enabled option to all scroller composables and components.
DisableTransform was added.
FlowMode was added.
useTableColumnWidths was added.
Performance 2
Improves package tree shaking.
General performance improved, with no major garbage collection.
Behavior and default changes 3
itemSize has improved function support.
KeyField can now be a function.
The useDynamicScroller API was simplified.
Fixes and other changes 11
Sparse grid views are now counted when enforcing the item limit.
Identity changes in the dynamic scroller are handled better.
Preserves the last good range during transient sparse cache states to prevent viewport blanking.
Prevents blank rows during transient cache states.
Guards accumulator reads against a transient sparse size cache.
Reverts the size measurement freeze while scrolling.
Adds stability checks for view ids in dynamic and recycle scrollers.
A fix addresses duplicated views.
The hidden view position was increased.
The items watcher now fires when the upstream array mutates in place.
Support was added for variable-size scroll window detection.
vue-virtual-scroller 29 changes
New APIs and options 4
Grid scrolling can be virtualized across both axes.
Headless composables are available for using the library's functionality without its standard UI components.
Enhances useRecycleScroller with visiblePool.
Adds style stamping to useRecycleScroller.
Tooling 1
Types are improved with generics.
Fixes and other changes 4
Adds a guard for when el is undefined.
Requested frames and timeouts are cleared on unmount.
Improves shift, cache restore, and size handling for WindowScroller.
Fixes are made to WindowScroller.