软件简介

AndroidStaggeredGrid 是一个支持实现多行多列且可变尺寸的阶梯形网格视图的开源库。

StaggeredGridView 的开发是因为该开源作者在实现其Etsy
app时发现Google的Android库中没有提供相关功能以实现其需求，即需要在landscape &
portrait两种模式下显示不同的行、列，且能在模、竖屏都保持单元格显示同步, 运行稳定，还要支持自定义页头 & 页脚。

该库使用简单，可以通过作者提供的/sample app的源码了解使用细节，如图：

总的来说使用该库只需3步：

1. 将 StaggeredGridView 加入到需要显示的布局文件中，如：

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
<com.etsy.android.grid.StaggeredGridView
        android:id="@+id/grid_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:item_margin="8dp"
        app:column_count_portrait="2"
        app:column_count_landscape="3" />
 </FrameLayout>

2. 配置属性：

item_margin - The margin around each grid item (default 0dp).
column_count_portrait - The number of columns displayed when the grid is in portrait (default 2).
column_count_landscape - The number of columns displayed when the grid is in landscape (default 3).
grid_paddingLeft - Padding to the left of the grid. Does not apply to headers and footers (default 0).
grid_paddingRight - Padding to the right of the grid. Does not apply to headers and footers (default 0).
grid_paddingTop - Padding to the top of the grid. Does not apply to headers and footers (default 0).
grid_paddingBottom - Padding to the bottom of the grid. Does not apply to headers and footers (default 0).

3. 配置适配器，这与使用GridView/ListView时基本一样：

ListAdapter adapter = ...;
StaggeredGridView gridView = (StaggeredGridView) findViewById(R.id.grid_view);
gridView.setAdapter(adapter);

说明: 由于列宽在屏幕方向横竖变化时亦会变化, 网格视图需要每个单元格维护自身的宽高比例，该库提供了 DynamicHeightImageView
类作为示例实现单元格视图高度按其宽度变化的功能。