效果圖
簡述
這一篇我們繼續(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ù),在滑動過程中我們需要知道以下幾點:
- 滑動時粘性頭部控件
pinnedView
所在位置上方和下方的控件以及附帶的數(shù)據(jù)- 滑動時
pinnedView
數(shù)據(jù)綁定- 滑動時
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都行飒货,有問題也可以提出來,也可以幫助我更好的完善峭竣。
后面會抽出點時間基于這個擴展庫再封裝一個支持下拉、上拉的分頁處理庫晃虫。