1. 程式人生 > >Android中Recyclerview使用5----新增頭部:RecyclerViewHeader

Android中Recyclerview使用5----新增頭部:RecyclerViewHeader

有兩種使用RecyclerViewHeader的方法:

方法1

(使用起來非常簡單,但是它會新增額外的佈局,因此效率略低於第二種方法):

為header建立一個xml佈局(可以包括任意view或者ViewGroup)

<FrameLayout
    android:layout_width="match_parent"
    android:layout_height="100dp">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_gravity="center"
        android:text="header"/>

</FrameLayout>

使用靜態初始方法從xml中建立RecyclerViewHeader

RecyclerViewHeader header = RecyclerViewHeader.fromXml(context, R.layout.header);

將RecyclerViewHeader Attach 到RecyclerView,搞定!

RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view);
// set LayoutManager for your RecyclerView
header.attachTo(recyclerView);

方法2

Header-already-aligned approach (不會引入任何額外佈局):

將RecyclerViewHeader佈局放在RecyclerView的上層。

<FrameLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    <android.support.v7.widget.RecyclerView
        android:id="@+id/recycler"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_gravity="center_horizontal|top" />

    <com.bartoszlipinski.recyclerviewheader.RecyclerViewHeader
        android:id="@+id/header"
        android:layout_width="match_parent"
        android:layout_height="100dp"
        android:layout_gravity="center_horizontal|top">

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_centerInParent="true"
            android:text="header"/>

    </com.bartoszlipinski.recyclerviewheader.RecyclerViewHeader>

</FrameLayout>

獲得RecyclerViewHeader物件:

RecyclerViewHeader header = (RecyclerViewHeader) findViewById(R.id.header);

把RecyclerViewHeader賦予RecyclerView

RecyclerView recyclerView = (RecyclerView) findViewById(R.id.recycler_view);
// set LayoutManager for your RecyclerView
header.attachTo(recyclerView, true);

注意事項

RecyclerViewHeader必須在RecyclerView設定了LayoutManager之後呼叫。

目前該庫適用於LinearLayoutManager,GridLayoutManager和StaggeredGridLayoutManager佈局的RecyclerViews。

只支援垂直佈局LayoutManager

超快和輕鬆為RecyclerView新增頭部:RecyclerViewHeader

如果你打算在RecyclerView中使用setOnScrollListener(...)方法,確保在setOnScrollListener(...)的attachTo(...)方法之前使用。

匯入專案

 build.gradle

dependencies {
    compile 'com.bartoszlipinski.recyclerviewheader:library:1.2.0'
}