之前我在GitHub上开源了一个可以实现RecyclerView列表分组的通用Adapter： 。有一些朋友在使用的时候给我反馈，希望能实现头部悬浮吸顶的效果。我当初设计GroupedRecyclerViewAdapter的初衷，是想要实现一个能方便管理RecyclerView多种item类型的Adapter，特别是能实现两级列表的Adapter，因为这样的需求在开发中很常见。所以当初我并没有考虑头部悬浮的功能。直到接到这些使用者的反馈，我才开始考虑添加这样的功能。不过想来也确实应该添加这样的功能，因为头部悬浮一般出现在两级分组的列表，而我的GroupedRecyclerViewAdapter本来就已经实现了两级分组的列表，再添加个头部悬浮的功能也很合理啊。
为了给RecyclerView实现头部悬浮的功能，我在GroupedRecyclerViewAdapter框架里添加了一个StickyHeaderLayout控件，由StickyHeaderLayout实现头部悬浮效果并且管理悬浮吸顶的View。下面我会给出StickyHeaderLayout源码，我在源码中对StickyHeaderLayout的实现有了比较详细的注释，相信大家能很好的理解。由于StickyHeaderLayout是对GroupedRecyclerViewAdapter的功能拓展，它跟GroupedRecyclerViewAdapter密切相关。所以你在阅读它的源码前，需要先了解GroupedRecyclerViewAdapter，而且StickyHeaderLayout也是要与GroupedRecyclerViewAdapter一起使用的。要想了解GroupedRecyclerViewAdapter，请看我的另一篇文章：《
》。如果你只是想使用它的功能，而不需要了解它的实现原理，也可以直接访问。StickyHeaderLayout的源码：
/** * Depiction:头部吸顶布局。只要用StickyHeaderLayout包裹{ @link RecyclerView}, * 并且使用{ @link GroupedRecyclerViewAdapter},就可以实现列表头部吸顶功能。 * StickyHeaderLayout只能包裹RecyclerView，而且只能包裹一个RecyclerView。 * * Author:donkingliang * Dat:2017/11/14 */public class StickyHeaderLayout extends FrameLayout { private Context mContext; private RecyclerView mRecyclerView; //吸顶容器，用于承载吸顶布局。 private FrameLayout mStickyLayout; //保存吸顶布局的缓存池。它以列表组头的viewType为key,ViewHolder为value对吸顶布局进行保存和回收复用。 private final SparseArray
mStickyViews = new SparseArray<>(); //用于在吸顶布局中保存viewType的key。 private final int VIEW_TAG_TYPE = -101; //用于在吸顶布局中保存ViewHolder的key。 private final int VIEW_TAG_HOLDER = -102; //记录当前吸顶的组。 private int mCurrentStickyGroup = -1; //是否吸顶。 private boolean isSticky = true; public StickyHeaderLayout(@NonNull Context context) { super(context); mContext = context; } public StickyHeaderLayout(@NonNull Context context, @Nullable AttributeSet attrs) { super(context, attrs); mContext = context; } public StickyHeaderLayout(@NonNull Context context, @Nullable AttributeSet attrs, @AttrRes int defStyleAttr) { super(context, attrs, defStyleAttr); mContext = context; } @Override public void addView(View child, int index, ViewGroup.LayoutParams params) { if (getChildCount() > 0 || !(child instanceof RecyclerView)) { //外界只能向StickyHeaderLayout添加一个RecyclerView,而且只能添加RecyclerView。 throw new IllegalArgumentException("StickyHeaderLayout can host only one direct child --> RecyclerView"); } super.addView(child, index, params); mRecyclerView = (RecyclerView) child; addOnScrollListener(); addStickyLayout(); } /** * 添加滚动监听 */ private void addOnScrollListener() { mRecyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() { @Override public void onScrolled(RecyclerView recyclerView, int dx, int dy) { // 在滚动的时候，需要不断的更新吸顶布局。 if (isSticky) { updateStickyView(); } } }); } /** * 添加吸顶容器 */ private void addStickyLayout() { mStickyLayout = new FrameLayout(mContext); LayoutParams lp = new LayoutParams(FrameLayout.LayoutParams.MATCH_PARENT, FrameLayout.LayoutParams.WRAP_CONTENT); mStickyLayout.setLayoutParams(lp); super.addView(mStickyLayout, 1, lp); } /** * 更新吸顶布局。 */ private void updateStickyView() { RecyclerView.Adapter adapter = mRecyclerView.getAdapter(); //只有RecyclerView的adapter是GroupedRecyclerViewAdapter的时候，才会添加吸顶布局。 if (adapter instanceof GroupedRecyclerViewAdapter) { GroupedRecyclerViewAdapter gAdapter = (GroupedRecyclerViewAdapter) adapter; //获取列表显示的第一个项。 int firstVisibleItem = getFirstVisibleItem(); //通过显示的第一个项的position获取它所在的组。 int groupPosition = gAdapter.getGroupPositionForPosition(firstVisibleItem); //如果当前吸顶的组头不是我们要吸顶的组头，就更新吸顶布局。这样做可以避免频繁的更新吸顶布局。 if (mCurrentStickyGroup != groupPosition) { mCurrentStickyGroup = groupPosition; //通过groupPosition获取当前组的组头position。这个组头就是我们需要吸顶的布局。 int groupHeaderPosition = gAdapter.getPositionForGroupHeader(groupPosition); if (groupHeaderPosition != -1) { //获取吸顶布局的viewType。 int viewType = gAdapter.getItemViewType(groupHeaderPosition); //如果当前的吸顶布局的类型和我们需要的一样，就直接获取它的ViewHolder，否则就回收。 BaseViewHolder holder = recycleStickyView(viewType); //标志holder是否是从当前吸顶布局取出来的。 boolean flag = holder != null; if (holder == null) { //从缓存池中获取吸顶布局。 holder = getStickyViewByType(viewType); } if (holder == null) { //如果没有从缓存池中获取到吸顶布局，则通过GroupedRecyclerViewAdapter创建。 holder = gAdapter.onCreateViewHolder(mStickyLayout, viewType); holder.itemView.setTag(VIEW_TAG_TYPE, viewType); holder.itemView.setTag(VIEW_TAG_HOLDER, holder); } //通过GroupedRecyclerViewAdapter更新吸顶布局的数据。 //这样可以保证吸顶布局的显示效果跟列表中的组头保持一致。 gAdapter.onBindViewHolder(holder, groupHeaderPosition); //如果holder不是从当前吸顶布局取出来的，就需要把吸顶布局添加到容器里。 if (!flag) { mStickyLayout.addView(holder.itemView); } } else { //如果当前组没有组头，则不显示吸顶布局。 //回收旧的吸顶布局。 recycle(); } } //这是是处理第一次打开时，吸顶布局已经添加到StickyLayout，但StickyLayout的高依然为0的情况。 if (mStickyLayout.getChildCount() > 0 && mStickyLayout.getHeight() == 0) { mStickyLayout.requestLayout(); } //设置mStickyLayout的Y偏移量。 mStickyLayout.setTranslationY(calculateOffset(gAdapter, firstVisibleItem, groupPosition + 1)); } } /** * 判断是否需要先回收吸顶布局，如果要回收，则回收吸顶布局并返回null。 * 如果不回收，则返回吸顶布局的ViewHolder。 * 这样做可以避免频繁的添加和移除吸顶布局。 * * @param viewType * @return */ private BaseViewHolder recycleStickyView(int viewType) { if (mStickyLayout.getChildCount() > 0) { View view = mStickyLayout.getChildAt(0); int type = (int) view.getTag(VIEW_TAG_TYPE); if (type == viewType) { return (BaseViewHolder) view.getTag(VIEW_TAG_HOLDER); } else { recycle(); } } return null; } /** * 回收并移除吸顶布局 */ private void recycle() { if (mStickyLayout.getChildCount() > 0) { View view = mStickyLayout.getChildAt(0); mStickyViews.put((int) (view.getTag(VIEW_TAG_TYPE)), (BaseViewHolder) (view.getTag(VIEW_TAG_HOLDER))); mStickyLayout.removeAllViews(); } } /** * 从缓存池中获取吸顶布局 * * @param viewType 吸顶布局的viewType * @return */ private BaseViewHolder getStickyViewByType(int viewType) { return mStickyViews.get(viewType); } /** * 计算StickyLayout的偏移量。因为如果下一个组的组头顶到了StickyLayout， * 就要把StickyLayout顶上去，直到下一个组的组头变成吸顶布局。否则会发生两个组头重叠的情况。 * * @param gAdapter * @param firstVisibleItem 当前列表显示的第一个项。 * @param groupPosition 下一个组的组下标。 * @return 返回偏移量。 */ private float calculateOffset(GroupedRecyclerViewAdapter gAdapter, int firstVisibleItem, int groupPosition) { int groupHeaderPosition = gAdapter.getPositionForGroupHeader(groupPosition); if (groupHeaderPosition != -1) { int index = groupHeaderPosition - firstVisibleItem; if (mRecyclerView.getChildCount() > index) { //获取下一个组的组头的itemView。 View view = mRecyclerView.getChildAt(index); float off = view.getY() - mStickyLayout.getHeight(); if (off < 0) { return off; } } } return 0; } /** * 获取当前第一个显示的item . */ private int getFirstVisibleItem() { int firstVisibleItem = -1; RecyclerView.LayoutManager layout = mRecyclerView.getLayoutManager(); if (layout != null) { if (layout instanceof LinearLayoutManager) { firstVisibleItem = ((LinearLayoutManager) layout).findFirstVisibleItemPosition(); } else if (layout instanceof GridLayoutManager) { firstVisibleItem = ((GridLayoutManager) layout).findFirstVisibleItemPosition(); } else if (layout instanceof StaggeredGridLayoutManager) { int[] firstPositions = new int[((StaggeredGridLayoutManager) layout).getSpanCount()]; ((StaggeredGridLayoutManager) layout).findFirstVisibleItemPositions(firstPositions); firstVisibleItem = getMin(firstPositions); } } return firstVisibleItem; } private int getMin(int[] arr) { int min = arr[0]; for (int x = 1; x < arr.length; x++) { if (arr[x] < min) min = arr[x]; } return min; } /** * 是否吸顶 * * @return */ public boolean isSticky() { return isSticky; } /** * 设置是否吸顶。 * * @param sticky */ public void setSticky(boolean sticky) { if (isSticky != sticky) { isSticky = sticky; if (mStickyLayout != null) { if (isSticky) { mStickyLayout.setVisibility(VISIBLE); updateStickyView(); } else { recycle(); mStickyLayout.setVisibility(GONE); } } } }}复制代码 StickyHeaderLayout具有以下的优点：
1、非ItemDecoration。StickyHeaderLayout的悬浮View是一个真实的View，而不是一个简单的图像，所以它可以悬浮任何的View。这有别于使用ItemDecoration实现悬浮效果的情况。2、与GroupedRecyclerViewAdapter完美结合。悬浮布局直接交由Adapter创建和更新，这使得悬浮布局在显示上和在处理上(事件监听、业务逻辑等)都与列表中的item保持一致。你可以把悬浮布局看做是列表中的一个项。而且GroupedRecyclerViewAdapter支持多种item类型，所以悬浮布局也可以支持多种item类型。3、StickyHeaderLayout对悬浮布局进行缓存复用，避免不必要的创建和更新、移除等操作。优化界面的绘制流畅。4、使用简单。你只需要使用StickyHeaderLayout包裹RecyclerView，并使用GroupedRecyclerViewAdapter实现两级列表就可以了。效果图：
传送门：