效果圖

粘性頭部

簡述

這一篇我們繼續(xù)擴展上一篇的SwipeAdapter，增加粘性頭部的支持，我們命名為PinnedAdapter，在第一篇的demo截圖中有一張模擬了慕課網(wǎng)中Swift課程的實現(xiàn)就是用了本篇的擴展進行實現(xiàn)的。下文中的item header為粘性頭部控件。
這里我們用最簡單的一種方式實現(xiàn)，我們采取的實現(xiàn)方式是這樣的：每一個item view都帶一個item header，在需要的時候設(shè)置其可見性。
接下來還是定義下我們的需求：
a. 在item支持滑動菜單的情況下，我們不允許item header滑動
b. item header當前沒有提供監(jiān)聽器

經(jīng)過上面的描述我們已經(jīng)知道，客戶端設(shè)置的最原始的item view可能經(jīng)過SwipeLayout的包裝，到這里后我們還需要對其進行一次LinearLayout包裝，命名為PinnedLayout，我們將用它創(chuàng)建新的viewHolder。

1. 創(chuàng)建viewHolder

@Override
final
public BaseViewHolder onCreateHolder(ViewGroup parent, int viewType) {
    BaseViewHolder holder = super.onCreateHolder(parent, viewType);
    View headerView = inflater.inflate(getPinnedItemViewLayout(), parent, false);
    PinnedLayout pinnedLayout = new PinnedLayout(context);
    pinnedLayout.setUpView(parent, holder.itemView, headerView);
    //說明客戶端設(shè)置了支持滑動菜單
    if (holder.itemView instanceof SwipeLayout) {
        View itemView = ((SwipeLayout) holder.itemView).getItemView();
        itemView.setClickable(true);
        return new BaseViewHolder(pinnedLayout, itemView);
    }else {
        return new BaseViewHolder(pinnedLayout);
    }
}

2. 數(shù)據(jù)綁定

在這部分的處理里面我們需要完成以下幾點：
a. 在原有的功能上我們需要擴展一個設(shè)置粘性頭部數(shù)據(jù)的方法

  /**
   * 設(shè)置粘性控件數(shù)據(jù)
   * @param holder
   * @param position 數(shù)據(jù)域中的索引
   * @param type 數(shù)據(jù)所在的組
   */
void convertPinnedHolder(BaseViewHolder holder, int position, int type);

b. 需要為item設(shè)置一個標識，用來標識在這一組中該item位于哪個位置
這個是用于在滑動處理中用來處理每個item頭部可見性以及粘性頭部

private interface PinnedItemRange {
    int FIRST    = 1;
    int OTHER    = 2;
}

c. 為item設(shè)置關(guān)聯(lián)數(shù)據(jù)的索引位置
這個是為了在回調(diào)給客戶端設(shè)置頭部數(shù)據(jù)的時候用的。

關(guān)鍵的點已經(jīng)描述清楚，下面看具體邏輯
代碼如下：

@Override
final
protected void onBindHolder(BaseViewHolder holder, int position) {
    PinnedLayout pinnedLayout = (PinnedLayout) holder.itemView;
    //每個組的第一條需要設(shè)置header可見
    if (0 == position || getItem(position).type != getItem(position - 1).type) {
        pinnedLayout.pinnedView.setVisibility(View.VISIBLE);
        holder.itemView.setTag(R.string.pinned_item_status, PinnedItemRange.FIRST);
    } else {
        pinnedLayout.pinnedView.setVisibility(View.GONE);
        holder.itemView.setTag(R.string.pinned_item_status, PinnedItemRange.OTHER);
    }
    final int type = getItem(position).type;
    holder.itemView.setTag(R.string.pinned_item_data_type, type);
    holder.itemView.setTag(R.string.item_index_in_datasection, position);
    super.onBindHolder(holder, position);
    this.convertPinnedHolder(holder, position, type);
}

3. 滑動處理

數(shù)據(jù)處理完畢之后，我們需要處理滑動中數(shù)據(jù)的操作。在上面數(shù)據(jù)綁定的時候我們已經(jīng)設(shè)置了在處理過程中需要的標識數(shù)據(jù)，在滑動過程中我們需要知道以下幾點：

1. 滑動時粘性頭部控件pinnedView所在位置上方和下方的控件以及附帶的數(shù)據(jù)
2. 滑動時pinnedView數(shù)據(jù)綁定
3. 滑動時pinnedView動畫

以上3點具體的邏輯都在下面的監(jiān)聽器里

private RecyclerView.OnScrollListener scrollListener = new RecyclerView.OnScrollListener() {
    @Override
    public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
        super.onScrolled(recyclerView, dx, dy);
        final int pinnedViewWidth = pinnedView.getMeasuredWidth();
        final int pinnedViewHeight = pinnedView.getMeasuredHeight();
        //獲取Adapter中粘性頭部位置上方的控件
        View headerView = recyclerView.findChildViewUnder(pinnedViewWidth / 2, 5);
        Object obj = headerView.getTag(R.string.pinned_item_data_type);
        if (headerView != null && null != obj && obj instanceof Integer) {
            int position = (int) headerView.getTag(R.string.item_index_in_datasection);
            convertPinnedHolder(pinnedViewHolder, position, (int) obj);
        }
        //獲取Adapter中粘性頭部位置下方的控件
        headerView = recyclerView.findChildViewUnder(pinnedViewWidth / 2, pinnedViewHeight + 1);
        obj = headerView.getTag(R.string.pinned_item_status);
        if (null == headerView || null == obj || !(obj instanceof Integer)) {
            return;
        }
        int transViewStatus = (int) obj;
        int translationY = headerView.getTop() - pinnedViewHeight;
        if (transViewStatus == PinnedItemRange.FIRST) {
            if (headerView.getTop() > 0) {
                pinnedView.setTranslationY(translationY);
            } else {
                pinnedView.setTranslationY(0);
            }
        } else if (transViewStatus == PinnedItemRange.OTHER) {
            pinnedView.setTranslationY(0);
        }
    }
};

4. 設(shè)置粘性頭部及滑動監(jiān)聽

經(jīng)過上面的描述，所有的處理過程以ok，剩下最后一點就是為RecyclerView添加滾動監(jiān)聽，同時希望粘性頭部也讓我們的庫自動加上去，不必讓客戶端很羅嗦的修改xml文件等，這樣就對界面的布局有點要求，我們這里限定為RecyclerView要有一個FrameLayout的父容器包裹。

@Override
public void onAttachedToRecyclerView(RecyclerView recyclerView) {
    super.onAttachedToRecyclerView(recyclerView);
    try {
        //父容器是FrameLayout,否則讓粘性功能失效
        FrameLayout parent = (FrameLayout) recyclerView.getParent();
        if (null == this.pinnedViewHolder) {
            this.initPinnedView(parent, recyclerView);
        }
        recyclerView.addOnScrollListener(scrollListener);
    } catch (Exception e) {
        Log.e("DEBUG", "RecyclerView parent must be FrameLayout");
        e.printStackTrace();
        Toast.makeText(context, "RecyclerView parent must be FrameLayout", Toast.LENGTH_SHORT).show();
    }
}

5. ItemWrapper包裝器

在我這種粘性頭部實現(xiàn)的方式中，從邏輯中也能看出來是將數(shù)據(jù)進行了分組，將每一個實體數(shù)據(jù)都關(guān)聯(lián)到組上，這一實現(xiàn)是通過將實體數(shù)據(jù)進行ItemWrapper包裝，為每個實體數(shù)據(jù)設(shè)置type組屬性實現(xiàn)的，所以這一篇的PinnedAdapter將數(shù)據(jù)通過泛型的方式進行了限定public class PinnedAdapter<T extends ItemWrapper>。

到這里為止，為Adapter添加粘性頭部支持就結(jié)束了，Adapter的整個擴展系列也結(jié)束了，如果感覺有幫助的話歡迎到github star以下或者fork都行，有問題也可以提出來，也可以幫助我更好的完善。

后面會抽出點時間基于這個擴展庫再封裝一個支持下拉、上拉的分頁處理庫。