本文是MultiItem系列的擴展文章婚脱,跨RecyclerView的Item拖動箍铲,并支持縮放的功能诡壁,主要防辦公軟件的面板触机,本功能的實現(xiàn)大量參考了ItemTouchHelper
的源碼颠区。
MutliItem主要解決多類型RecyclerView Adapter問題削锰,在正常使用中做到了Adapter零編碼,解放了復(fù)雜的Adapter類毕莱,提高擴展性器贩。
源碼地址
Github地址:https://github.com/free46000/MultiItem,請大家多多關(guān)注朋截,更多更新會首先在GitHub上體現(xiàn)蛹稍,也會在第一時間在本平臺發(fā)布。
系列文章
效果截圖


用法
拖動功能
拖動功能使用比較簡單部服,拖動功能相關(guān)流程和控制都會回調(diào)到ItemDragListener
監(jiān)聽中唆姐。
實例化拖動輔助類,設(shè)置監(jiān)聽廓八,并在dispatchTouchEvent
中調(diào)用dragHelper.onTouch(ev)
方法
@Override
protected void onCreate(Bundle savedInstanceState) {
...
//ItemDragHelper奉芦,需要傳入外層的橫向滾動的RecyclerView
dragHelper = new ItemDragHelper(horizontalRecycler);
//為dragHelper設(shè)置拖動監(jiān)聽赵抢,基本都有默認實現(xiàn),可根據(jù)具體業(yè)務(wù)繼承重寫方法
dragHelper.setOnItemDragListener(new OnBaseDragListener());
}
@Override
public boolean dispatchTouchEvent(MotionEvent ev) {
//需要保證在Activity或者外層的ViewGroup中重寫此方法
//調(diào)用dragHelper.onTouch():true消耗掉事件;false則執(zhí)行super
return dragHelper.onTouch(ev) || super.dispatchTouchEvent(ev);
}
為垂直列表注冊數(shù)據(jù)源声功,必須實現(xiàn)ItemData
接口
//注冊的數(shù)據(jù)源(TextDragBean)類烦却,必須實現(xiàn)`ItemData`接口
baseItemAdapter.register(TextDragBean.class, new TextViewDragManager());
開啟拖動功能
dragHelper.startDrag(viewHolder);
拖動監(jiān)聽,此處只復(fù)寫了拖動結(jié)束回調(diào)的接口
class OnBaseDragListener extends OnItemDragListener {
@Override
public void onDragFinish(RecyclerView recyclerView, int itemRecyclerPos, int itemPos) {
super.onDragFinish(recyclerView, itemRecyclerPos, itemPos);
String text = String.format("拖動起始第%s個列表的第%s項 結(jié)束第%s個列表的第%s項 \n\n拖動數(shù)據(jù):%s", originalRecyclerPosition,
originalItemPosition, itemRecyclerPos, itemPos, dragItemData);
Toast.makeText(PanelActivity.this, text, Toast.LENGTH_SHORT).show();
}
}
通用Item拖動控制功能
主要包括對Item的拖動先巴、移動其爵、切換的控制功能,數(shù)據(jù)源需要實現(xiàn)ItemDrag
接口伸蚯,這樣在拖動過程中OnItemDragListener
會根據(jù)不同的狀態(tài)進行對應(yīng)的控制摩渺。
當然你也可以通過OnBaseDragListener
的不同回調(diào)方法,根據(jù)業(yè)務(wù)實現(xiàn)定制化的控制朝卒,這里我們看下ItemDrag
接口:
/**
* 數(shù)據(jù)源Item拖動接口证逻,實現(xiàn)一些move change等定制化的通用控制
* Created by free46000 on 2017/4/3.
*/
public interface ItemDrag {
/**
* 是否可以在自己的Recycler中move
*
* @return boolean
*/
boolean isCanMove();
/**
* 是否可以切換到其他Recycler
*
* @return boolean
*/
boolean isCanChangeRecycler();
/**
* 是否可以開啟拖動
*
* @return boolean
*/
boolean isCanDrag();
}
雙擊縮小功能
實例化輔助類并為輔助類設(shè)置需要的視圖對象
//實例化縮放功能輔助類
scaleHelper = new ViewScaleHelper();
//設(shè)置最外層的Content視圖
scaleHelper.setContentView(contentView);
//設(shè)置橫向的Recycler列表視圖
scaleHelper.setHorizontalView(horizontalRecycler);
添加外層的垂直視圖到輔助類,進行縮放統(tǒng)一管理
scaleHelper.addVerticalView(verticalView);
在OnItemDragListener
的回調(diào)中返回當前縮放級別抗斤,配合完成縮放后的拖動功能
class OnBaseDragListener extends OnItemDragListener {
@Override
public float getScale() {
return scaleHelper.isInScaleMode() ? scaleHelper.getScale() : super.getScale();
}
}
開啟或關(guān)閉縮放功能
//開啟或關(guān)閉縮放模式
scaleHelper.toggleScaleModel();
//開啟縮放模式
scaleHelper.startScaleModel();
//關(guān)閉縮放模式
scaleHelper.stopScaleModel();
其他定制化用法
定制化業(yè)務(wù)主要通過復(fù)寫ItemDragListener
的相關(guān)方法實現(xiàn)囚企,下面簡單列舉一些可定制的功能:
-
getScale()
縮放比例詳見ViewScaleHelper#getScale()
- Item和列表選中移動等流程控制相關(guān)方法(包含移動前的確認回調(diào)),詳見源碼及注釋
-
getHorizontalScrollMaxSpeed
getVerticalScrollMaxSpeed
最大水平垂直滾動速度 -
getHorizontalLimit
getVerticalLimit
計算水平垂直滾動距離 -
calcHorizontalScrollDistance
calcVerticalScrollDistance
最大水平垂直滾動速度 -
onDrawFloatView(View floatView)
浮動視圖動畫處理 -
getMoveLimit()
兩個Item是否進行move邊界值
上面所介紹定制化用法并不是全部瑞眼,如有需要更深層次定制可以提交issues或留言
主要流程解析
備注:以下所說觸摸位置都為相對屏幕位置龙宏,這樣方便后續(xù)計算
生成浮動視圖
被拖動Item視圖設(shè)為不可見狀態(tài),浮動視圖采用WindowManager + ImageView
展示被拖動Item視圖的Bitmap
計算橫向和豎向的RecyclerView滾動
- 大量參考了
ItemTouchHelper
的源碼 - 根據(jù)用戶觸摸位置計算是否需要滾動伤疙,和滾動的方向與距離 詳見
ItemDragListener
的calcXXXScrollDistance()
calcScrollXXXDirect()
- 采用定時Runnable形式银酗,保證持續(xù)的滾動
- 滾動時調(diào)用Item位置計算方法,使得在滾動過程中也可以更換Item位置
Item位置更換計算
- 根據(jù)觸摸位置
horizontalRecycler.findChildViewUnder(x, y)
找到垂直recyclerView
的位置徒像,若找到位置繼續(xù) - 根據(jù)上一次垂直
recyclerView
所在的位置黍特,判斷是否為第一次選中或者是切換recyclerView
的操作,此處可通過itemDragListener
回調(diào)攔截此次操作的結(jié)果 - 如果需要切換
recyclerView
的位置锯蛀,此時需要對被拖動的Item進行remove
灭衷,并在新的recyclerView
中add
進去 - 根據(jù)觸摸位置
recyclerView.findChildViewUnder(itemX, itemY)
找到itemView
的位置 - 根據(jù)上一次
itemView
所在的位置,判斷是否需要移動itemView
位置的操作旁涤,此處可通過itemDragListener
回調(diào)攔截此次操作的結(jié)果 - 如果需要移動動
itemView
位置則需要把recyclerView
滾動到合適的位置翔曲,防recyclerView
亂跳
視圖縮放
視圖縮放采用的是把外層的視圖還有橫向列表視圖擴大,并對橫向列表視圖進行setScaleX setScaleY
的操作劈愚,然后對縮放后的視圖寬度進行賦值瞳遍,防止一些充滿屏幕的布局,影響縮放效果菌羽,等停止縮放的時候還原即可掠械。
總結(jié)
這個功能實現(xiàn)起來比較倉促,并沒有過多的考慮,算是一個beta版本份蝴。
以上整理了用法犁功,并對主要流程做了簡單的解析氓轰,如果大家有興趣可以結(jié)合源碼理解原理婚夫,如有不明白,或者實現(xiàn)不夠優(yōu)雅的地方署鸡,歡迎大家指出案糙。