К основному содержанию
скилл CX Codex

tanstack-vue-virtual-skilld — скилл для Claude Code

Скилл tanstack-vue-virtual-skilld помогает писать, проверять и отлаживать виртуализированные списки и сетки во Vue с @tanstack/vue-virtual. Пригодится и для лент чата с прокруткой к концу.

MIT 129 установок ★ 186 обновлён 2026-10-10

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add skilld-dev/vue-ecosystem-skills --skill tanstack-vue-virtual-skilld -a claude-code
Открыть на GitHub

Что делает tanstack-vue-virtual-skilld

Скилл описывает адаптер Vue для useVirtualizer и useWindowVirtualizer: как передавать реактивные параметры, получать виртуальные элементы и измерять строки. В руководстве есть примеры для динамической высоты и прокрутки окна, а также сведения о методах Virtualizer и возможностях привязки списка к концу.

Есть версии библиотек, на которые рассчитаны примеры: @tanstack/vue-virtual 3.13.x и @tanstack/virtual-core 3.17.x. Для useVirtualizer нужны count, getScrollElement и estimateSize. Адаптер сам задаёт наблюдатели прокрутки, поэтому передавать observeElementRect, observeElementOffset или scrollToFn нельзя. Это важно учесть при переносе существующей конфигурации.

Какие задачи решает

  • виртуализировать длинный список во Vue
  • настроить сетку с виртуальным рендерингом
  • разобраться с реактивными параметрами useVirtualizer
  • сохранить измерения элементов при скрытии списка
  • привязать прокрутку ленты чата к концу

Примеры запросов агенту

  • Настрой виртуализацию динамических строк во Vue с @tanstack/vue-virtual и объясни, как измерять элементы.
  • Проверь мой вызов useWindowVirtualizer и подскажи, как учесть смещение списка на странице.
  • Помоги привязать ленту чата к концу с учётом возможностей @tanstack/virtual-core 3.17.x.

Как установить tanstack-vue-virtual-skilld

1Через Skills CLI (Vercel)

npx skills add skilld-dev/vue-ecosystem-skills --skill tanstack-vue-virtual-skilld -a claude-code

2Вручную: положить файлы

~/.claude/skills/tanstack-vue-virtual-skilld/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tanstack-vue-virtual-skilld/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tanstack-vue-virtual-skilld

Как установить tanstack-vue-virtual-skilld в Claude Code?

Выполните npx skills add skilld-dev/vue-ecosystem-skills --skill tanstack-vue-virtual-skilld -a claude-code. Файл скилла находится по пути ~/.claude/skills/tanstack-vue-virtual-skilld/SKILL.md.

Что делает tanstack-vue-virtual-skilld?

Помогает разрабатывать и отлаживать виртуализированные списки, сетки и ленты во Vue. Включает правила адаптера и примеры работы с прокруткой и измерением элементов.

Какие параметры нужны для useVirtualizer?

Нужны count, getScrollElement и estimateSize. Сам адаптер задаёт observeElementRect, observeElementOffset и scrollToFn, поэтому передавать их не следует.

Исходный текст

SKILL.md · MIT
---
name: tanstack-vue-virtual-skilld
description: Headless UI for virtualizing scrollable elements in Vue. Use when writing, reviewing, or debugging code that imports @tanstack/vue-virtual, calls useVirtualizer or useWindowVirtualizer, or virtualizes lists, grids, masonry, window-scrolled content, or chat feeds in Vue. Provides version-accurate adapter rules, Virtualizer options and methods, and rendering recipes for @tanstack/vue-virtual 3.13.x on @tanstack/virtual-core 3.17.x.
license: MIT
---

# @tanstack/vue-virtual

Headless list/grid virtualization for Vue. The adapter is thin: `useVirtualizer` and `useWindowVirtualizer` construct a core `Virtualizer`, wire it to Vue reactivity, and return it as a `Ref`. Every option and method below comes from `@tanstack/virtual-core`, which the adapter re-exports (`src/index.ts:21`).

## Version facts

- Target: `@tanstack/[email protected]` (`package.json:3`).
- Exact dependency: `@tanstack/[email protected]` (`package.json:52`).
- Peer: `vue ^2.7.0 || ^3.0.0` (`package.json:59`).
- The adapter API has been stable across 3.13.x; releases 3.13.25 to 3.13.39 only bump virtual-core ([vue-virtual changelog](https://github.com/TanStack/virtual/blob/main/packages/vue-virtual/CHANGELOG.md)).
- Install: `npm install @tanstack/vue-virtual` ([installation docs](https://tanstack.com/virtual/latest/docs/installation)).

## Quick start: dynamic-height rows

Canonical pattern, following the [official Vue dynamic example](https://github.com/TanStack/virtual/blob/main/examples/vue/dynamic/src/components/RowVirtualizerDynamic.vue). Block translation positions the rendered block by the first item's `start`; each item flows normally inside it.

```vue
<script setup lang="ts">
import { computed, onMounted, onUpdated, ref, shallowRef } from 'vue'
import { useVirtualizer } from '@tanstack/vue-virtual'

const parentRef = ref<HTMLElement | null>(null)
const rows = Array.from({ length: 10000 }, (_, i) => `Row ${i}`)

const rowVirtualizer = useVirtualizer({
  count: rows.length,
  getScrollElement: () => parentRef.value,
  estimateSize: () => 55,
  overscan: 5,
})

const virtualRows = computed(() => rowVirtualizer.value.getVirtualItems())
const totalSize = computed(() => rowVirtualizer.value.getTotalSize())

const itemEls = shallowRef<HTMLElement[]>([])
function measureAll() {
  rowVirtualizer.value.measureElement(null) // prune disconnected nodes
  itemEls.value.forEach((el) => el && rowVirtualizer.value.measureElement(el))
}
onMounted(measureAll)
onUpdated(measureAll)
</script>

<template>
  <div ref="parentRef" style="height: 400px; overflow-y: auto; contain: strict">
    <div :style="{ height: `${totalSize}px`, position: 'relative', width: '100%' }">
      <div
        :style="{
          position: 'absolute',
          top: 0,
          left: 0,
          width: '100%',
          transform: `translateY(${virtualRows[0]?.start ?? 0}px)`,
        }"
      >
        <div
          v-for="virtualRow in virtualRows"
          :key="virtualRow.key"
          :data-index="virtualRow.index"
          ref="itemEls"
        >
          {{ rows[virtualRow.index] }}
        </div>
      </div>
    </div>
  </div>
</template>
```

The scroll container needs a bounded height and `overflow: auto`. The inner sizer div carries `getTotalSize()`.

## Window virtualizer

`useWindowVirtualizer` scrolls with the browser window; it pre-fills `getScrollElement` (SSR-safe) and `initialOffset`, so pass neither ([vue-virtual docs](https://tanstack.com/virtual/latest/docs/framework/vue/vue-virtual), `src/index.ts:104-114`). When the list sits below other content, measure that offset into `scrollMargin`:

```ts
const parentOffset = ref(0)
onMounted(() => {
  parentOffset.value = parentRef.value?.offsetTop ?? 0
})

const rowVirtualizer = useWindowVirtualizer(
  computed(() => ({
    count: rows.length,
    estimateSize: () => 45,
    scrollMargin: parentOffset.value,
  })),
)
```

Pattern source: [official window example](https://github.com/TanStack/virtual/blob/main/examples/vue/dynamic/src/components/RowVirtualizerDynamicWindow.vue).

## Vue adapter rules (proven by `src/index.ts`)

- Returns `Ref<Virtualizer>`, not a raw instance. Use `.value` in script; templates auto-unwrap (`src/index.ts:30,69`).
- Options accept `MaybeRef`. A plain object is applied once; to update `count`, `overscan`, `enabled`, etc. reactively, pass a `ref` or `computed` of the whole options object. The adapter watches `() => unref(options)` and calls `setOptions` on change (`src/index.ts:48-65`).
- `getScrollElement()` is watched with `immediate: true`. A template ref that is still `null` on setup is picked up when it mounts (`src/index.ts:36-46`).
- `onChange` is wrapped: the adapter calls `triggerRef` on its internal `shallowRef` before your callback, so `computed(() => rowVirtualizer.value.getVirtualItems())` re-evaluates on scroll and resize (`src/index.ts:53-56`).
- Observers are cleaned up via `onScopeDispose` (`src/index.ts:67`).
- Items measured with `measureElement` must carry the index attribute, `data-index` by default (configurable via `indexAttribute`).
- Do not pass `observeElementRect`, `observeElementOffset`, or `scrollToFn`; the adapter pre-fills them (`src/index.ts:83-90`).

Details: [Vue adapter API](./references/vue-adapter.md).

## API reference

Full options table, instance methods, and `VirtualItem` shape: [Virtualizer API](./references/virtualizer-api.md).

Required options for `useVirtualizer`: `count`, `getScrollElement`, `estimateSize` ([virtualizer docs](https://tanstack.com/virtual/latest/docs/api/virtualizer)).

## What is new since virtual-core 3.14.0

vue-virtual 3.13.39 ships core 3.17.11; these arrived via core minors ([virtual-core changelog](https://github.com/TanStack/virtual/blob/main/packages/virtual-core/CHANGELOG.md)):

- 3.16.0: end-anchored mode for chat, logs, reverse feeds. `anchorTo: 'end'`, `followOnAppend`, `scrollEndThreshold`, plus `scrollToEnd()`, `isAtEnd()`, `getDistanceFromEnd()`. See [Chat and end anchoring](./references/chat-end-anchoring.md).
- 3.15.0: `takeSnapshot()` for scroll restoration round-trips with `initialMeasurementsCache` + `initialOffset`.
- 3.15.0: default scroll adjustment now skips compensation during backward scroll (fixes "items jump while scrolling up"); override by assigning the instance property `shouldAdjustScrollPositionOnItemSizeChange`, which is not an option.
- 3.15.0: iOS Safari momentum-scroll handling, default on; scroll compensation writes are deferred while touching or bouncing.
- 3.17.0: `useCachedMeasurements` keeps measurements alive while the list is hidden.
- Pre-3.15 options still current: `lanes` with `laneAssignmentMode` (3.14.0), `gap`, `indexAttribute`, `initialMeasurementsCache`, `isRtl`.

## Best practices

- Estimate large for dynamic items: set `estimateSize` near the maximum likely size so initial positions and the scrollbar stay stable ([virtualizer docs](https://tanstack.com/virtual/latest/docs/api/virtualizer)).
- Prefer block translation (as in the quick start) over per-item absolute positioning; smooth `scrollToIndex` skips measuring items far from the target, and block translation keeps the rendered block internally consistent ([virtualizer docs](https://tanstack.com/virtual/latest/docs/api/virtualizer)).
- Give a stable `getItemKey` (row id, not index) whenever data reorders, filters, prepends, or streams; index keys break end-anchored chat and scroll restoration ([chat docs](https://tanstack.com/virtual/latest/docs/chat)).
- Subtract `scrollMargin` from item starts when items are positioned absolutely inside a shared scroll container ([virtualizer docs](https://tanstack.com/virtual/latest/docs/api/virtualizer)).
- Use the `gap` option instead of CSS margins so `getTotalSize()` accounts for spacing.
- `count` changes invalidate the measurement cache and update `getTotalSize()` automatically (fixed in 3.13.13, [changelog](https://github.com/TanStack/virtual/blob/main/packages/vue-virtual/CHANGELOG.md)); in Vue still route reactive data through `computed` options.
- Leave `useAnimationFrameWithResizeObserver` off unless measured to help; it defers measurements by a frame ([virtualizer docs](https://tanstack.com/virtual/latest/docs/api/virtualizer)).
- Pause observers with `enabled: false` instead of unmounting to preserve measurements.

Recipes for masonry, padding, sticky headers, scroll restoration, and hidden lists: [Patterns](./references/patterns.md).

Migrating from v2: `useVirtual` is gone; v3 uses `useVirtualizer`, the `count` option (not `size`), `getScrollElement` (not `parentRef`), and `measureElement` refs with `data-index` ([vue-virtual docs](https://tanstack.com/virtual/latest/docs/framework/vue/vue-virtual)).

## References

- [Vue adapter API](./references/vue-adapter.md): signatures, reactivity contract, SSR behavior.
- [Virtualizer API](./references/virtualizer-api.md): all options, defaults, instance methods, `VirtualItem`.
- [Patterns](./references/patterns.md): masonry, scroll margin, sticky ranges, scroll restoration, hidden lists.
- [Chat and end anchoring](./references/chat-end-anchoring.md): `anchorTo: 'end'` chat feeds in Vue.

© skilld-dev · MIT · skilld-dev/vue-ecosystem-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
tanstack-virtual oakoss Скилл учит агента виртуализировать длинные списки, таблицы и сетки на TanStack Virtual: в DOM остаются только видимые строки. CX Codex +1 148установок tanstack-store oakoss Объясняет агенту устройство TanStack Store: стор, производные значения, батчи и эффекты. Описывает общее состояние нескольких компонентов. CX Codex +1 113установок virtual-lists patterns.dev Скилл virtual-lists обучает агента технике виртуализации списков и таблиц в веб-приложениях. Помогает убрать задержки при скролле и ускорить начальную отрисовку страниц. CX Codex +1 1 700установок vue Anthony Fu Помогает проектировать компоненты Vue и настраивать реактивность. Пригодится при переходе на скрипт с сетапом и composables. CX Codex +1 718установок ui+vue提示词 qdleader Промпт ui+vue提示词 для Claude Code ведёт модель от анализа задачи к макету, спецификации и коду Vue-компонента. Включайте его, чтобы получить экран целиком — от требований до готового кода. GP ChatGPT ★ 571звёзд репо vue-expert 0xfurai Субагент vue-expert для Claude Code, заточенный под разработку на Vue.js. Помогает писать однофайловые компоненты, настраивать Vue Router и проектировать хранилище Vuex. CX Codex ★ 1 029звёзд репо

Из того же набора32

Весь набор →
vueuse-integrations-skilld Скилл vueuse-integrations-skilld учит ИИ-агента правильно использовать 12 обёрток библиотеки @vueuse/integrations v15. Помогает писать типизированный код без ошибок в импортах и сигнатурах. CX Codex +1 145установок tanstack-vue-table-skilld Скилл tanstack-vue-table-skilld обучает агента правилам @tanstack/vue-table v9: явной регистрации фич в tableFeatures, атомарному состоянию и миграции с v8. Пригодится при сборке headless-таблиц на Vue 3. CX Codex +1 144установок vueuse-motion-skilld Скилл vueuse-motion-skilld помогает ИИ писать и отлаживать декларативные анимации через @vueuse/motion в Vue 3 и Nuxt 3 без ошибок в таймингах и SSR. CX Codex +1 141установок vueuse-shared-skilld Скилл vueuse-shared-skilld добавляет в Claude Code, Cursor и другие редакторы знание API @vueuse/shared v15.0.0 — фреймворк-агностичных реактивных утилит для Vue. CX Codex +1 137установок tanstack-vue-form-skilld Скилл tanstack-vue-form-skilld помогает писать, проверять и отлаживать формы Vue на @tanstack/vue-form с актуальным API TanStack Form. CX Codex +1 125установок vueuse-math-skilld Скилл vueuse-math-skilld для работы с композаблами @vueuse/math в Vue 3: клампинг, проекция, округление, агрегация реактивных чисел. CX Codex +1 119установок floating-ui-vue-skilld Скилл floating-ui-vue-skilld помогает писать позиционирование всплывающих окон, тултипов и меню через @floating-ui/vue 2.0.1 во Vue 3.3+. CX Codex +1 119установок vue-data-ui-skilld Скилл vue-data-ui-skilld помогает агенту работать с библиотекой графиков vue-data-ui для Vue 3: выбирать компоненты, настраивать темы и разбирать ошибки. CX Codex +1 118установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой