Pinned section header decoration for RecyclerView. 「中文版文档点这里」
A powerful pinned section header library. The realization of ideas comes from「pinned-section-item-decoration」. Please mark a star if you think it's helpful.（＾∀＾）
- Large pinned section header support vertical orientation of the LinearLayoutManager, GridLayoutManager and StaggeredGridLayoutManager.
- Small pinned section header support vertical orientation of the LinearLayoutManager and GridLayoutManager which its span count is 1.
- Support the header of the click, double click and long press event.
- Support the child view of the click, double click and long press event.
- It can draw the separator line and support custom separator line style. (PS: Vertical staggeredgrid layout requires fixed height, can not be randomly changed to lead to item position switch, refer to「See line 97-109 of MainActivity」)
BaseRecyclerViewAdapterHelper(It is highly recommended to use this adapter, which can greatly reduce the amount of work.)
To add a dependency using Gradle:
compile 'com.oushangfeng:PinnedSectionItemDecoration:1.1.1'Adapter needs to implement the PinnedHeaderNotifyer interface then tells ItemDecoration which type is the pinned section header and the information of the pinned section header.「See StockAdapter」
@Override
public boolean isPinnedHeaderType(int viewType) {
return viewType == StockEntity.StockInfo.TYPE_HEADER;
}
@Override
public StockEntity.StockInfo getPinnedHeaderInfo(int position) {
return ((StockEntity.StockInfo) getData().get(position));
}
Adapter needs to process the span count of header through the FullSpanUtil.
@Override
public void onAttachedToRecyclerView(RecyclerView recyclerView) {
super.onAttachedToRecyclerView(recyclerView);
FullSpanUtil.onAttachedToRecyclerView(recyclerView, this, StockEntity.StockInfo.TYPE_HEADER);
}
@Override
public void onViewAttachedToWindow(RecyclerView.ViewHolder holder) {
super.onViewAttachedToWindow(holder);
FullSpanUtil.onViewAttachedToWindow(holder, this, StockEntity.StockInfo.TYPE_DATA);
}
To achieve large pinned section header, RecyclerView only need to add a PinnedHeaderItemDecoration. Note that the top layer of the header where the layout can not be set marginTop.「See StockActivity」
final OnHeaderClickAdapter<StockEntity.StockInfo> clickAdapter = new OnHeaderClickAdapter<StockEntity.StockInfo>() {
@Override
public void onHeaderClick(int id, int position, StockEntity.StockInfo data) {
switch (id) {
case R.id.fl:
// case OnItemTouchListener.HEADER_ID:
Toast.makeText(StockActivity.this, "click, tag: " + data.pinnedHeaderName, Toast.LENGTH_SHORT).show();
break;
case R.id.iv_more:
Toast.makeText(StockActivity.this, "click " + data.pinnedHeaderName + "'s more button", Toast.LENGTH_SHORT).show();
break;
}
}
};
mRecyclerView.addItemDecoration(
new PinnedHeaderItemDecoration.Builder<StockEntity.StockInfo>()
// Set separator line resources id.
.setDividerId(R.drawable.divider)
// Enable draw the separator line, by default it's disable.
.enableDivider(true)
// Set click event for the header and its internal child view.
.setClickIds(R.id.iv_more)
// Enable header click event(not include the child view)， by default it's enable.
.disableHeaderClick(false)
// Set the listener. If the listener is not null and enable the header click event, then the callback return the header's id is ItemTouchListener.HEADER_ID.
.setHeaderClickListener(clickAdapter)
.create());
To achieve small pinned section header is a little bit more complex, such as the layout A of the data .
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="#70E593">
<ImageView
android:id="@+id/iv_animal"
android:layout_gravity="center"
android:layout_width="match_parent"
android:layout_height="120dp"
tools:src="@mipmap/panda0"/>
<TextView
android:id="@+id/tv_pos"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:padding="8dp"
android:textColor="#000000"
android:textSize="18dp"
tools:text="1"/>
</FrameLayout>
This is a layout B with a small pinned section header.
<FrameLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<ImageView
android:id="@+id/iv_animal"
android:layout_width="match_parent"
android:layout_height="120dp"
android:background="#70E593"
tools:src="@mipmap/panda0"/>
<ImageView
android:id="@+id/iv_small_pinned_header"
android:layout_width="50dp"
android:layout_height="50dp"
android:background="#5A5A5A"
android:padding="8dp"
android:textColor="#ffffff"
android:textSize="18dp"
tools:src="@mipmap/panda0"
tools:text="熊猫"/>
</FrameLayout>
The layout B add a header compare whit layout A，then RecyclerView only need to add a SmallPinnedHeaderItemDecoration. Note that the top layer of the header where the layout can not be set marginTop.「See SecondActivity」
OnHeaderClickAdapter<PinnedHeaderEntity<Integer>> headerClickAdapter = new OnHeaderClickAdapter<PinnedHeaderEntity<Integer>>() {
@Override
public void onHeaderClick(int id, int position, PinnedHeaderEntity<Integer> data) {
if (id == R.id.iv_small_pinned_header) {
Toast.makeText(SecondActivity.this, "click tag: " + data.getPinnedHeaderName(), Toast.LENGTH_SHORT).show();
}
}
};
mRecyclerView.addItemDecoration(
// Constructor need to set the id of header.
new SmallPinnedHeaderItemDecoration.Builder<PinnedHeaderEntity<Integer>>(R.id.tv_small_pinned_header)
// Enable draw the separator line, by default it's disable.
.enableDivider(true)
// Set separator line resources id.
.setDividerId(R.drawable.divider)
// Disable header click event(not include the child view)， by default it's enable.
.disableHeaderClick(true)
// Set click event for the header and its internal child view.
// Here I disable header click event, but i set the header id, so the header click event will still happen.
.setClickIds(R.id.tv_small_pinned_header)
// Set the listener. If the listener is not null and enable the header click event, then the callback return the header's id is ItemTouchListener.HEADER_ID.
.setHeaderClickListener(headerClickAdapter)
.create());
- Solve the problem of setting the marginTop.
- Solve the problem of setting the marginBottom.
Copyright 2016 oubowu
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.