VirtualViewList Documentation

VirtualViewList delivers high-performance virtualized scrolling for Cocos Creator projects. It renders only visible items, aggressively reuses nodes, and maintains smooth performance even with massive datasets.

Key Features

• On-Demand Rendering: Only instantiate visible nodes, dramatically reducing draw calls and memory footprint
• Multiple Layouts: Supports vertical, horizontal, and grid layouts with flexible spacing and direction control
• Intelligent Performance:
  • 3-tier adaptive refresh rate (30fps/60fps/120fps) based on scroll velocity
  • Dynamic buffer expansion during fast scrolling to prevent blank areas
  • Frame-distributed loading for smooth handling of 10,000+ items
• Incremental Updates:
  • PrependData - Insert at top while maintaining scroll position
  • AppendData - Append at bottom without flicker
  • RefreshData - Incremental refresh with custom comparison
• Pull-to-Refresh/Load: Built-in pull-down and pull-up mechanics with async callbacks and debounce
• Animation & Interaction: Animated insert/remove with queue management, nested scroll support
• Flexible Templates: Multi-template system with dynamic switching and object pooling

Quick Links

• Quick Start
• Component & Props
• Project Structure
• Layout & Rendering
• Events & Callbacks
• Performance Tuning
• API Reference
• Examples