TanStack Virtual 参考是一个针对 React 虚拟滚动库 @tanstack/react-virtual v3 的 API 参考技能,由 Agent 参考技能形式提供,内容基于官方 API 文档蒸馏而成。
用途 该技能用于在开发 React 虚拟滚动时快速定位 TanStack Virtual 的相关 API 与示例。其工作方式是:先根据任务类型判断所属类别,再查阅该类别的 README.md 确定目标页面,最后读取对应页面的 .md 文件获取详细说明,而不是一次性加载全部内容。
主要能力与内容范围 入门(getting-started):介绍引入方式、基本概念与安装步骤;讲解 useVirtualizer、useWindowVirtualizer 钩子的用法;涉及文本行高估算(pretext)以及聊天/日志场景的尾部跟随(anchorTo 等)。 API:包括 Virtualizer 类的初始化选项;getVirtualItems、getTotalSize、scrollToIndex、measure 等实例方法;VirtualItem 的结构与坐标信息;以及 rangeExtractor、scrollToFn、measureElement 等默认实现(Utilities),用于面向自定义适配器的场景。 示例(samples):提供固定尺寸行/列虚拟化、可变尺寸行虚拟化、动态测量(measureElement)、grid 虚拟化、sticky headers、infinite scroll、table 虚拟化、window scroller、平滑滚动、padding/gap 等实现示例的指引。
使用方式 技能目录结构为 skills/tanstack-virtual/,包含 SKILL.md、references/(下设 getting-started 与 api 子目录,各含 README.md 及具体页面文档)以及 samples/(含 README.md 与各示例文档,如 fixed-rows.md、fixed-columns.md、variable-rows.md、dynamic-measured.md、grid.md、sticky-headers.md、infinite-scroll.md、table-virtualization.md、window-scroller.md、smooth-scroll.md、padding-gap.md)。使用时按任务映射表选择类别,再逐层进入对应 README 与页面文件阅读。
适用场景 适用于 React 项目中使用 @tanstack/react-virtual 实现列表、表格、网格等虚拟滚动时的 API 查阅与示例参考,包括入门配置、Hook 使用、Virtualizer 选项与实例方法查询、VirtualItem 结构理解、自定义适配器实现,以及各类虚拟化布局示例。
限制 该技能为 API 参考文档的整理,介绍中未提供收费、价格、平台支持范围或性能效果等具体信息。上述内容均以资料所述为准,未提及的部分暂未提供,不应视为已具备的功能。