https://github.com/500px/greedo-layout-for-android
Full aspect ratio grid LayoutManager for Android's RecyclerView
https://github.com/500px/greedo-layout-for-android
android android-recyclerview aspect-ratio greedo-layout grid layout recyclerview
Last synced: 26 days ago
JSON representation
Full aspect ratio grid LayoutManager for Android's RecyclerView
- Host: GitHub
- URL: https://github.com/500px/greedo-layout-for-android
- Owner: 500px
- License: mit
- Created: 2016-02-05T20:57:07.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2022-06-21T21:20:31.000Z (almost 3 years ago)
- Last Synced: 2025-04-13T23:55:42.475Z (about 2 months ago)
- Topics: android, android-recyclerview, aspect-ratio, greedo-layout, grid, layout, recyclerview
- Language: Java
- Homepage:
- Size: 1.69 MB
- Stars: 1,630
- Watchers: 84
- Forks: 156
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Greedo Layout for Android
A drop-in custom layout manager for Android RecyclerViews to layout a grid of photos while respecting their aspect ratios.
## Setup
Download the latest release via Gradle:
``` groovy
repositories {
maven { url 'https://github.com/500px/greedo-layout-for-android/raw/master/releases/' }
}
dependencies {
compile 'com.fivehundredpx:greedo-layout:1.5.1'
}
```
## Usage
See the sample project for a complete solution on how to use GreedoLayout. Below are the specific steps.
```java
// Create an instance of the GreedoLayoutManager and pass it to the RecyclerView
MyRecyclerAdapter recyclerAdapter = new MyRecyclerAdapter(this);
GreedoLayoutManager layoutManager = new GreedoLayoutManager(recyclerAdapter);
RecyclerView recyclerView = (RecyclerView)findViewById(R.id.recycler_view);
recyclerView.setLayoutManager(layoutManager);
recyclerView.setAdapter(recyclerAdapter);
// Set the max row height in pixels
layoutManager.setMaxRowHeight(300);
// If you would like to add spacing between items (Note, MeasUtils is in the sample project)
int spacing = MeasUtils.dpToPx(4, this);
recyclerView.addItemDecoration(new GreedoSpacingItemDecoration(spacing));
```
And then, in your RecyclerView adapter, or some other class of your choosing, implement `SizeCalculatorDelegate`. This implementation got passed to the layout manager above.
```java
public class MyRecyclerAdapter extends RecyclerView.Adapter implements SizeCalculatorDelegate {
@Override
public double aspectRatioForIndex(int index) {
// Return the aspect ratio of your image at the given index
}
}
```
## License
GreedoLayout is released under the MIT license. See LICENSE for details.