懸浮效果
先看個(gè)效果
這是一個(gè)
City
列表越除,每個(gè)City
都有所屬的Province
,需要在滑動(dòng)的時(shí)候哩盲,將對(duì)應(yīng)的Province
懸浮在頂部秧倾。懸浮頂部的Province需要根據(jù)列表的滑動(dòng)而適當(dāng)改變位置灵妨,實(shí)現(xiàn)“頂上去”的效果哑蔫。
實(shí)現(xiàn)思路:
- 利用
RecyclerView.ItemDecoration
繪制Province
(就像繪制分割線一樣) - 同一組的
City
,只繪制一個(gè)Province
- 計(jì)算偏移茬射,將當(dāng)前
Province
固定在頂部 - 根據(jù)列表滑動(dòng)鹦蠕,實(shí)現(xiàn)偏移效果
ItemDecoration
既然是利用RecyclerView.ItemDecoration
實(shí)現(xiàn)的懸浮效果冒签,那么有必要了解下它。
ItemDecoration
字面意思:Item
的裝飾钟病。是的萧恕!是裝飾刚梭!不只是畫分割線。
其實(shí)ItemDecoration
的功能非常強(qiáng)大票唆,而我們平時(shí)只是用它來實(shí)現(xiàn)分割線的效果(至少我是這樣)朴读。因此,可能很多同學(xué)認(rèn)為ItemDecoration
就是用來繪制分割線的走趋。其實(shí)不然衅金,ItemDecoration
的功能遠(yuǎn)不止是分割線的繪制。
先看下RecyclerView.ItemDecoration
的源碼(部分):
public static abstract class ItemDecoration {
...
public void onDraw(Canvas c, RecyclerView parent, State state) {
onDraw(c, parent);
}
public void onDrawOver(Canvas c, RecyclerView parent, State state) {
onDrawOver(c, parent);
}
public void getItemOffsets(Rect outRect, View view, RecyclerView parent, State state) {
getItemOffsets(outRect, ((LayoutParams) view.getLayoutParams()).getViewLayoutPosition(),
parent);
}
}
里面是我們常用的三個(gè)方法:
-
getItemOffsets
:通過Rect
為每個(gè)Item
設(shè)置偏移簿煌,用于繪制Decoration
氮唯。 -
onDraw
:通過該方法,在Canvas
上繪制內(nèi)容姨伟,在繪制Item
之前調(diào)用惩琉。(如果沒有通過getItemOffsets
設(shè)置偏移的話,Item
的內(nèi)容會(huì)將其覆蓋) -
onDrawOver
:通過該方法夺荒,在Canvas
上繪制內(nèi)容,在Item
之后調(diào)用瞒渠。(畫的內(nèi)容會(huì)覆蓋在item的上層)
RecyclerView
的背景、onDraw
繪制的內(nèi)容技扼、Item
伍玖、onDrawOver
繪制的內(nèi)容,各層級(jí)關(guān)系如下:
繪制分割線
先看看一般的分割線繪制淮摔。
- 定義分割線高度
private int mHeight = 5; //分割線高度
- 通過
getItemOffsets
預(yù)留空間
@Override
public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
super.getItemOffsets(outRect, view, parent, state);
int position = parent.getChildAdapterPosition(view);
if (position != 0) {
//第一個(gè)item預(yù)留空間
outRect.top = mHeight;
}
}
- 然后在
onDraw
中繪制
@Override
public void onDraw(Canvas c, RecyclerView parent, RecyclerView.State state) {
super.onDraw(c, parent, state);
final int left = parent.getLeft();
final int right = parent.getRight();
final int childCount = parent.getChildCount();
for (int i = 0; i < childCount; i++) {
final View childView = parent.getChildAt(i);
final int bottom = childView.getTop();
final int top = bottom - mHeight;
c.drawRect(left, top, right, bottom, mPaint);
}
}
獲取當(dāng)前RecyclerView
的Item
數(shù)量私沮,遍歷每個(gè)Item
。在對(duì)應(yīng)的位置繪制一個(gè)高度為mHeight
的矩形 和橙,從而實(shí)現(xiàn)分割線的效果仔燕。
(詳情代碼見底部鏈接)
打造懸浮效果
這是一個(gè)城市列表,根據(jù)省份分組魔招,相同的城市只會(huì)顯示一個(gè)省份晰搀。滾動(dòng)城市列表時(shí),省份會(huì)懸浮在頂部办斑。效果如下:
實(shí)現(xiàn)
由于需要懸浮效果外恕,所以需要在onDrawOver
中繪制分組。
- 定義一個(gè)
interface
乡翅,根據(jù)position
通過接口方法getGroupName
獲取當(dāng)前省名(由Activity
實(shí)現(xiàn))
public interface GroupListener {
String getGroupName(int position);
}
- 創(chuàng)建
StickyDecoration
繼承RecyclerView.ItemDecoration
- 定義
isFirstInGroup
方法鳞疲。根據(jù)前一個(gè)省份,判斷當(dāng)前是否為新的省份
//判斷是不是組中的第一個(gè)位置
//根據(jù)前一個(gè)組名蠕蚜,判斷當(dāng)前是否為新的組
private boolean isFirstInGroup(int pos) {
if (pos == 0) {
return true;
} else {
String prevGroupId = getGroupName(pos - 1);
String groupId = getGroupName(pos);
return !TextUtils.equals(prevGroupId, groupId);
}
}
通過position
尚洽,對(duì)比上一個(gè)省份名稱,判斷當(dāng)前省是否為第一個(gè)
- 重寫
getItemOffsets
方法靶累,為懸浮欄預(yù)留空間
@Override
public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
super.getItemOffsets(outRect, view, parent, state);
int pos = parent.getChildAdapterPosition(view);
String groupId = getGroupName(pos);
if (groupId == null) return;
//只有是同一組的第一個(gè)才顯示懸浮欄
if (pos == 0 || isFirstInGroup(pos)) {
outRect.top = mGroupHeight;
}
}
只有第一個(gè)Item
或者新的省份才為懸浮欄預(yù)留空間
- 重寫
onDrawOver
方法(重點(diǎn))
@Override
public void onDrawOver(Canvas c, RecyclerView parent, RecyclerView.State state) {
super.onDrawOver(c, parent, state);
final int itemCount = state.getItemCount();
final int childCount = parent.getChildCount();
final int left = parent.getLeft() + parent.getPaddingLeft();
final int right = parent.getRight() - parent.getPaddingRight();
String preGroupName; //標(biāo)記上一個(gè)item對(duì)應(yīng)的Group
String currentGroupName = null; //當(dāng)前item對(duì)應(yīng)的Group
for (int i = 0; i < childCount; i++) {
View view = parent.getChildAt(i);
int position = parent.getChildAdapterPosition(view);
preGroupName = currentGroupName;
currentGroupName = getGroupName(position);
if (currentGroupName == null || TextUtils.equals(currentGroupName, preGroupName))
continue;
int viewBottom = view.getBottom();
float top = Math.max(mGroupHeight, view.getTop());//top 決定當(dāng)前頂部第一個(gè)懸浮Group的位置
if (position + 1 < itemCount) {
//獲取下個(gè)GroupName
String nextGroupName = getGroupName(position + 1);
//下一組的第一個(gè)View接近頭部
if (!currentGroupName.equals(nextGroupName) && viewBottom < top) {
top = viewBottom;
}
}
//根據(jù)top繪制group
c.drawRect(left, top - mGroupHeight, right, top, mGroutPaint);
Paint.FontMetrics fm = mTextPaint.getFontMetrics();
//文字豎直居中顯示
float baseLine = top - (mGroupHeight - (fm.bottom - fm.top)) / 2 - fm.bottom;
c.drawText(currentGroupName, left + mLeftMargin, baseLine, mTextPaint);
}
}
通過變量preGroupId
和currentGroupId
來保存當(dāng)前分組名和上一個(gè)分組名腺毫。當(dāng)前Item
與上一個(gè)Item
為同一個(gè)分組時(shí)癣疟,跳過該Item的繪制。
其中代碼:
float top = Math.max(mGroupHeight, view.getTop());
根據(jù)當(dāng)前Item
的位置確定繪制分組的位置潮酒。top
將在mGroupHeight
和view.getTop()
中取最大值睛挚,也就是說top
將不會(huì)小于mGroupHeight
,這樣就能實(shí)現(xiàn)吸頂效果急黎。
其中代碼:
if (!currentGroupName.equals(nextGroupName) && viewBottom < top) {
top = viewBottom;
}
當(dāng)下個(gè)分組的頂部(當(dāng)前Item
的底部viewBottom
可近似認(rèn)為下個(gè)Item
的頂部)距離RecyclerView
頂部小于top
時(shí)扎狱,偏移當(dāng)前分組位置。實(shí)現(xiàn)下一組上滑時(shí)候勃教,當(dāng)前分組上移委乌;上一組下滑的時(shí)候,當(dāng)前分組下移荣回。
最后計(jì)算baseLine
遭贸,并繪制背景和文字。
到目前為止心软,一個(gè)帶有懸浮功能的列表就實(shí)現(xiàn)了壕吹。
(詳細(xì)代碼見底部鏈接)
進(jìn)階
當(dāng)我們利用ItemDecoration
實(shí)現(xiàn)文字的懸浮的時(shí)候,是不是還可以搞點(diǎn)事情~ ~我有個(gè)大膽的想法
只有文字的懸浮怎么行删铃!我還希望可以再來個(gè)icon
耳贬?再來幾個(gè)TextView
?來個(gè)自定義布局猎唁?那就來個(gè)自定義布局吧咒劲。
實(shí)現(xiàn)
實(shí)現(xiàn)的原理跟上面一樣,由于需要自定義布局诫隅,所以需要在接口中添加一個(gè)獲取View
的方法腐魂。
- 定義
PowerGroupListener
public interface PowerGroupListener {
String getGroupName(int position);
View getGroupView(int position);
}
相比之前,多了個(gè)getGroupView
方法逐纬,用來獲取View
蛔屹。
- 在
onDrawOver
中繪制
@Override
public void onDrawOver(Canvas c, RecyclerView parent, RecyclerView.State state) {
...
for (int i = 0; i < childCount; i++) {
...
//根據(jù)position獲取View
View groupView = mGroupListener.getGroupView(position);
if (groupView == null) return;
ViewGroup.LayoutParams layoutParams = new ViewGroup.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT, mGroupHeight);
groupView.setLayoutParams(layoutParams);
groupView.setDrawingCacheEnabled(true);
groupView.measure(
View.MeasureSpec.makeMeasureSpec(0, View.MeasureSpec.UNSPECIFIED),
View.MeasureSpec.makeMeasureSpec(0, View.MeasureSpec.UNSPECIFIED));
//指定高度、寬度的groupView
groupView.layout(0, 0, right, mGroupHeight);
groupView.buildDrawingCache();
Bitmap bitmap = groupView.getDrawingCache();
c.drawBitmap(bitmap, left, top - mGroupHeight, null);
}
}
在原來的基礎(chǔ)上做了點(diǎn)修改豁生,通過接口的getGroupView
方法獲取需要繪制的分組View
兔毒,將得到的View繪制到指定位置。
效果:
(詳細(xì)代碼見底部鏈接)
源碼
已封裝成庫(kù)甸箱,歡迎來提Issues
repositories {
jcenter()// If not already there
}
dependencies {
compile 'com.gavin.com.library:stickyDecoration:x.x.x'
}
支持
- LinearLayoutManager
- GridLayoutManager
- 點(diǎn)擊事件
- 分割線
詳細(xì)用法級(jí)源碼請(qǐng)看Github
參考
Android-使用RecyclerView的ItemDecoration 實(shí)現(xiàn)炫酷的 吸頂效果
RecycleView的學(xué)習(xí)(一篇不錯(cuò)的博客育叁,沒有投稿,所以看得人不多)
Android RecyclerView 使用完全解析 體驗(yàn)藝術(shù)般的控件