staggered_flow_grid 1.0.1
staggered_flow_grid: ^1.0.1 copied to clipboard
A high-performance, zero-dependency Flutter widget that renders children in a staggered waterfall grid layout using a custom shortest-column RenderObject.
Changelog #
All notable changes to staggered_flow_grid will be documented in this file.
The format follows Keep a Changelog. This project adheres to Semantic Versioning.
1.0.1 — 2026-04-13 #
Fixed #
- Reduced
pubspec.yamldescription length to strictly under 180 characters, granting the final 10 points to achieve a perfect 160/160 pub.flutter-io.cn score.
1.0.0 — 2026-04-13 #
Initial Release #
-
Core Framework:
StaggeredFlowGridwidget — zero-dependency staggered (waterfall) grid powered by a customRenderBox.RenderStaggeredFlowGrid— public render object for advanced composition and layout.StaggeredGridParentData— optimized parent-data class for direct offset positioning.- Shortest-column waterfall algorithm with O(n) layout pass per frame.
-
Features:
- Full compatibility with
SingleChildScrollViewscaling andSliverToBoxAdaptercontexts. - Built-in parameter constraints for
crossAxisCount,mainAxisSpacing, andcrossAxisSpacing. - Native RTL (Right-to-Left) directional support — automatically reads from the ambient
Directionalitywidget and correctly mirrors the column flow positioning. - Direct
computeDryLayoutoptimization for deep intrinsic sizing (e.g., insideColumnorIntrinsicHeight).
- Full compatibility with
-
Quality Assurance:
- Validated including spacing clamps, RTL assertions, negative bounds, and zero-child behaviors.
- Uses strictly compliant modern static analysis via
flutter_lints: ^5.0.0. - Zero performance warnings, zero static analyzer violations, and full cross-platform compatibility metrics enabled.
-
Showcase Example:
- Comprehensive modern production-level Example app built on
Material 3with seamless dark/light theme switching. - Embedded examples featuring dynamic network images mimicking Pinterest cards (
CachedNetworkImagewith customShimmerBoxloading states). - High-performance, mixed-height article and stats cards, isolating repaint layers.
- Built-in Interactive Playground to manually adjust column spacing, padding, and constraints real-time.
- Comprehensive modern production-level Example app built on