TanStack/virtual @tanstack/vue-virtual@3.13.24

Tags: beta: 3.0.0-beta.68, latest: 3.13.24

References: Docs

API Changes

This section documents version-specific API changes — prioritize recent major/minor releases.

• BREAKING: useVirtualizer — replaces useVirtual in v3 migration; older positional arguments or v2 option names are no longer supported source

• BREAKING: Ref<Virtualizer> return type — v3 useVirtualizer returns a Vue Ref instead of a raw object; instance methods must be accessed via .value (e.g., rowVirtualizer.value.getVirtualItems())

• BREAKING: count — replaces size option in v3 migration; using size will result in zero items being virtualized source

• BREAKING: getScrollElement — replaces parentRef option in v3 migration; must be a function that returns the scrollable element or null source

• BREAKING: measureElement — replaces measureRef pattern from v2; you must now pass virtualizer.value.measureElement to the ref attribute and set data-index on the element source

• NEW: getTotalSize() auto-updates — as of v3.13.13, the virtualizer automatically notifies the framework when the count option changes, ensuring getTotalSize() and the UI update correctly without manual workarounds for filtering or search source