greedo-layout-for-android - Full aspect ratio grid LayoutManager for Android's RecyclerView
jopen
9年前
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:
repositories { maven { url 'https://github.com/500px/greedo-layout-for-android/raw/master/releases/' } } dependencies { compile 'com.fivehundredpx:greedo-layout:1.0.0' }
Usage
See the sample project for a complete solution on how to use GreedoLayout. Below are the specific steps.
// 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.
public class MyRecyclerAdapter extends RecyclerView.Adapter<ViewHolder> 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.