lazy_wrap 1.0.0

A Flutter widget that mimics Wrap layout behavior with lazy rendering and zero layout jumps.

lazy_wrap

A performant Flutter widget that combines the layout of Wrap with lazy rendering. Perfect for large lists with variable-sized items.

✨ Features

Feature	Fixed Mode	Dynamic Mode
Lazy rendering	✅	✅
Zero layout jumps	✅	✅ (Offstage measurement)
Horizontal scroll	✅	✅
Fade-in animation	❌	✅
Custom loading indicator	❌	✅

📦 Installation

dependencies:
  lazy_wrap: ^1.0.0

🚀 Usage

Fixed Mode (Best Performance)

Use when all items have the same size:

LazyWrap.fixed(
  itemCount: 10000,
  estimatedItemWidth: 120,
  estimatedItemHeight: 100,
  itemBuilder: (context, index) => ProductCard(index),
  spacing: 8,
  runSpacing: 8,
)

Dynamic Mode (Variable Sizes)

Use when items have different sizes:

LazyWrap.dynamic(
  itemCount: 10000,
  itemBuilder: (context, index) => VariableCard(index),
  spacing: 8,
  runSpacing: 8,
  
  // Optional customization
  fadeInItems: true,                    // Smooth fade-in animation
  fadeInDuration: Duration(ms: 200),
  batchSize: 50,                        // Items per batch
  loadingBuilder: (ctx) => MyLoader(),  // Custom loading indicator
)

🎯 When to Use Which

Scenario	Recommended
Grid of cards (same size)	LazyWrap.fixed
Tags/chips (variable width)	LazyWrap.dynamic
Mixed content	LazyWrap.dynamic
Maximum performance	LazyWrap.fixed

🌀 Demo

👉 Live Demo

📋 API Reference

Common Parameters

Parameter	Type	Default	Description
itemCount	int	required	Total number of items
itemBuilder	Widget Function(BuildContext, int)	required	Builds each item
spacing	double	8	Horizontal space between items
runSpacing	double	8	Vertical space between rows
padding	EdgeInsets	zero	Padding around content
scrollDirection	Axis	vertical	Scroll direction
cacheExtent	double	300	Pre-render buffer in pixels

Fixed Mode Only

Parameter	Type	Default	Description
estimatedItemWidth	double	required	Width of each item
estimatedItemHeight	double	required	Height of each item

Dynamic Mode Only

Parameter	Type	Default	Description
batchSize	int	50	Items loaded per batch
fadeInItems	bool	true	Enable fade-in animation
fadeInDuration	Duration	200ms	Fade animation duration
loadingBuilder	Widget Function(BuildContext)?	null	Custom loading indicator

☕ Support

If this package helps you, consider supporting:

📣 Author

Created by Hensell • GitHub

Contributors