onLoadingProgress property

void Function(int loaded, int total)? onLoadingProgress

Callback fired with progress updates as images load. Receives (loadedCount, totalCount).

When loaded == total, all images are fully loaded and rendered.

Since all items are rendered at once (non-lazy), the UI may appear unresponsive during initial load. This callback provides essential user feedback to indicate loading progress and prevent the perception of a frozen app, especially important for lists with 50+ items that include images.

Implementation

final void Function(int loaded, int total)? onLoadingProgress;