scroll_list (Godot 4 GDScript)

User Manual | Forum | Demo Scripts

Want a fast and mobile-friendly way to display tons of data?

scroll_list virtualizes your data, showing only the elements it needs to. Take thousands of rows and display them in a handful of UI elements, speeding up processing and saving memory. There is no object destruction, so your platform won't have to run garbage collection. Best of all, it works on top of Godot's own built-in UI system components.

Lists are data driven and created dynamically, so you won't have to set them up at design time. The scroller doesn't need to be aware of data or view presentation, focusing only on managing your list for a true MVC experience. Optional looping allows you to show infinite lists of data. Each cell can have its own size and scene, or they can all share the same size and scene. Optional snapping lets you lock your cells to a particular location. Tweening eases your jumping and snapping transitions to give a smooth user experience.

Features:

• Dynamic, data-driven lists
• MVC framework to maintain a separation of concerns
• Efficient recycling of list items
• Optional infinite looping
• Multiple list item sizes supported, or pass a global size
• Multiple cell scenes supported, or use the same scene for all cells
• List items are fully customizable to fit your project
• Optional snapping locks your scroller
• Tweening to ease jumping and snapping
• Demos, tutorials and full GDScript source code are all included.