# VScrollView

**Repository Path**: crazybug1989/VScrollView

## Basic Information

- **Project Name**: VScrollView
- **Description**: 基于 CocosCreater 引擎编辑器的全新滚动组件和虚拟列表
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-11-22
- **Last Updated**: 2025-11-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VScrollView

基于 CocosCreater 引擎编辑器的全新滚动组件和虚拟列表,目前仅支持 3.8.7 版本,2.4.x 版本在另一个仓库.

[在线预览地址](https://soidaken.github.io/VSCrollView_SamplesPreView/)

# 它有什么优势,适合什么场景

- 使用极简,无论是编辑器中还是代码 API 使用,基本遵循上手即用,见名知意.
- 子项是等高的,特别适合,比如好友列表/邮件列表/活动列表等
- 子项是不等高模式,一个或者多个预制体,但是不会动态修改子项渲染高度,比如?????
- 子项是不等高模式,一个或者多个预制体,但是会根据数据动态修改子项的渲染高度,比如动态聊天列表.
- Grid 模式,比如背包列表或者装备列表,此模式下只支持等高,也就是单一子项类型.

---

- 交互触摸滚动组件效果全新实现,尽量模拟 App 端的列表效果,并且提供了所有效果调节参数.
- 可关闭虚拟列表功能,只当做轻量滚动组件使用.
- 编辑器中和代码使用极简,一切都从你提供的数据开始,数据索引和渲染索引完全匹配.
- 虚拟列表本身针对等高和非等高分别实现逻辑,使用了节点池+环形缓冲,列表本身的逻辑消耗极低.
- 虚拟列表本身做了渲染分层(单独将 Label 提高层级,对 Label 也做了子分层),分层适用于所有模式(但需要 3.x 的有 Sorting2D 组件的版本).

# 联系我

- 如果你遇到问题或者功能需求,可以联系我 v: soida3
- qq 群:1044961417
- mail:flashfin@foxmail.com

# 你可能会问,如何使用

- samples 里面已清晰列出了几种典型场景,对照场景和代码使用即可.
- 如果你说你需要更详细的教程,抱歉,出门左转,不送.
- 其实还可以实现更多效果,更多具体实用例子,我会持续更新.

# 最后,如果你心情好,请我喝杯咖啡

![alt text](reward_code.jpg)