etsy/AndroidStaggeredGridArchived
AndroidStaggeredGrid
The AndroidStaggeredGrid library provides a multi-column, masonry-style grid component for Android applications. It arranges items in a staggered layout where rows contain items of varying heights, similar to a Pinterest-style grid. The library supports dynamic column count configuration and includes built-in item interaction handling through tap event callbacks.
Key capabilities include adjustable column counts that can be changed at runtime, separate column configurations for portrait and landscape orientations, automatic scroll position restoration across configuration changes, and an empty state placeholder view when the grid contains no items. The component also supports fixed header and footer views with content area padding.
The implementation follows Android’s adapter-based view recycling pattern to manage memory efficiently with long lists, tracking per-column heights to determine placement of new items.
Features
- Staggered - Displays items in a multi-column grid where each row contains items of different heights, similar to a masonry layout.
- Staggered Grid Column Height Trackers - Maintains per-column cumulative height to determine the shortest column for inserting the next item.
- Item Action Triggers - Triggers a callback when a user taps an item in the staggered grid.
- Staggered Grid Column Count Updates - Rebuilds the entire child layout when the number of columns changes at runtime, respecting new column widths.
- Staggered Grid - Overrides AbsListView's layout logic to measure and position children in multiple columns with varying row heights.
- Masonry Layouts - Arranges items in a Pinterest-style layout with varying column sizes and heights.
- Orientation-Adaptive Column Counts - Supports dynamic column count configuration and separate layouts for portrait and landscape orientations.
- Orientation-Specific Column Counts - Renders the staggered grid with separate column counts for portrait and landscape orientations.
- Staggered Grid Column Counts - Adjusts the number of grid columns at runtime while supporting items of different heights.
- Orientation Change Restorations - Automatically restores scroll position and layout when the device orientation changes.
- View Recycling - Reuses off-screen child views via Android's BaseAdapter recycling pattern to manage memory in long lists.
- Grid Header and Footer Views - Allows adding fixed header and footer views to the grid with padding that applies only to the grid content area.
- Grid Item Tap Handlers - Registers tap events on grid items and invokes a callback for custom actions.
- Orientation-Aware Column Counts - Switches between separate portrait and landscape column counts by detecting configuration changes in the layout pass.
- Empty State Placeholders - Shows a designated empty view by swapping the grid content with it when the adapter data size is zero.
- Orientation-Adaptive Grid Layouts - Renders a staggered grid with separate column counts for portrait and landscape orientations automatically.
- Configuration Change Scroll Restorers - Persists and restores the scroll position of a staggered grid across configuration changes like device rotation.
- Configuration Change Scroll Restorers - Saves and restores the scroll offset and column data across configuration changes using the View's onSaveInstanceState and onRestoreInstanceState.
- Item Click Delegators - Fires click callbacks by intercepting touch events on child views and dispatching them through OnItemClickListener.
- Grid Layouts - Grid view supporting multiple columns with varying row sizes.
- Lists and Grids - Staggered grid layout implementation.
- User Interface Components - Grid view which supports multiple columns with rows of varying sizes.
