Jetpack?Compose實現(xiàn)對角線滾動效果
緣起
不久前刷到 newki
前輩的文章,用自定義 viewGroup
的方式實現(xiàn)了如圖效果: Android自定義ViewGroup嵌套與交互實戰(zhàn),幕布全屏滾動效果
我當(dāng)時的反應(yīng): new bee ! new bee ! 這效果不錯
初試
大佬用 Android View 出來了,那能否用 Google 新一代 UI Compose
來整一個呢?
正好手上有本 fun 神寫得書 《Jetpack Compose 從入門到實戰(zhàn)》。這不就好辦了么!
正當(dāng)我 啪的一下,很快啊,吭! 開始行動之后,
拿著書翻到了手勢處理這一章節(jié),找到了這個:
Scrollable
,當(dāng)視圖組件的寬度或長度超出屏幕邊界時,我們希望能滑動查看更多的內(nèi)容... 這不就完事了么,隨便寫個 composable
加一個 Modifier.scrollable
即可實現(xiàn)滑動效果
但是,緊接著一句話 “Orientation 僅有 Horizontal 與 Vertical 可供選擇,這說明我們只能監(jiān)聽水平或垂直方向的滾動。”
那我們?nèi)绻o一個組合同時添加兩個方向的scrollable
呢? 比如這樣:
private fun TwoOrientaionScrollView(modifier: Modifier = Modifier) { val horizontalScrollState = rememberScrollState() val verticalScrollState = rememberScrollState() Column(modifier = modifier .horizontalScroll(horizontalScrollState) .verticalScroll(verticalScrollState) ) { ... } }
經(jīng)過測試,這種方法只能實現(xiàn)在兩個方向滑動(垂直,水平)且每次手勢只有一個方向在滑動,我們要達(dá)到目標(biāo)效果,那必須是要支持斜著滑動的。
大意了,沒有閃,被 Android 官方擺了一道。
探索
既然官方提供的開箱即用的 API
無法滿足我們的要求,那我們就需要動手去定制一個特殊的手勢處理規(guī)則去實現(xiàn)。
那萬能的互聯(lián)網(wǎng)中有沒有大佬已經(jīng)用compose
自定義手勢實現(xiàn)了呢?
可是找遍了 google
百度
chatGPT
也沒有找到什么有價值的文章值得去參考,倒是在Stack Overflow
上一番翻箱倒柜之后,找到了一個線索————這種需求叫做 對角線滾動 / diagonal scroll
,并且外國同行已經(jīng)提了 issue 給 google
質(zhì)問他們?yōu)楹螞]有對角線滾動。但截止到今天 2023/2/7 仍舊google
沒有提供新的api
也沒有關(guān)閉這個問題。
插一句,不知道為何隔壁鴻蒙原本是支持自由方向滾動的,鴻蒙稱之為 Orientation.free , 但是在 api v9 時卻把這個方向給廢棄了
當(dāng)我愈發(fā)苦惱時,我把 diagonal scroll
鍵入交友網(wǎng)站github
時,一道閃光出現(xiàn)了
chihsuanwu/compose-free-scroll:提供可讓組合自由滾動的 modifier
這是來自臺灣省的開發(fā)者的開源項目,作者也已經(jīng)發(fā)布到遠(yuǎn)程倉,可以讓大家一鍵導(dǎo)入并極速使用
測試效果:
完美!
學(xué)習(xí)
接下來一起學(xué)習(xí)一下大佬的代碼吧 ,核心代碼:
FreeScrollState.kt
用來表示滑動狀態(tài),并提供了滑動到指定位置的方法FreeScroll.kt
實現(xiàn)允許對角線滾動的modifier
FreeScrollState
內(nèi)部使用兩個 ScrollState
分別控制水平和垂直滾動的 state
class FreeScrollState( val horizontalScrollState: ScrollState, val verticalScrollState: ScrollState, ) { ... } // 用rememberScrollState 分別創(chuàng)建兩個方向的 scrollState @Composable fun rememberFreeScrollState(initialX: Int = 0, initialY: Int = 0): FreeScrollState { val horizontalScrollState = rememberScrollState(initialX) val verticalScrollState = rememberScrollState(initialY) return FreeScrollState( horizontalScrollState = horizontalScrollState, verticalScrollState = verticalScrollState, ) }
值得一提的是,可以學(xué)習(xí)到作者使用協(xié)程來處理 scrollBy
, scrollTo
以及 animateScrollBy
animateScrollTo
, 例如:
suspend fun scrollTo( x: Int, y: Int, ): Offset = coroutineScope { val xOffset = async { horizontalScrollState.scrollTo(x) } val yOffset = async { verticalScrollState.scrollTo(y) } // 使用 async.awawit() 來同時獲取兩個結(jié)果 Offset(xOffset.await(), yOffset.await()) }
freeScroll
這是一個Modifier
的拓展方法,在這個方法中,實現(xiàn)了自定義手勢邏輯。
fun Modifier.freeScroll( state: FreeScrollState, enabled: Boolean = true ): Modifier = composed { val velocityTracker = remember { VelocityTracker() } val flingSpec = rememberSplineBasedDecay<Float>() this.verticalScroll(state = state.verticalScrollState, enabled = false) .horizontalScroll(state = state.horizontalScrollState, enabled = false) .pointerInput(enabled) { if (!enabled) return@pointerInput coroutineScope { detectDragGestures( onDragStart = { }, onDrag = { change, dragAmount -> change.consume() //1 拖拽中 onDrag(change, dragAmount, state, velocityTracker, this) }, onDragEnd = { //2 拖拽結(jié)束時 onEnd(velocityTracker, state, flingSpec, this) } ) } } }
可以看到,核心就是PointerInput
中采用detectDraGestures
拖拽監(jiān)聽,并聲明了一個速度追蹤 器velocityTracker
,和一個衰減動畫 rememberSplineBasedDecay
來使拖拽結(jié)束有一段慣性運動也就是fling
@OptIn(ExperimentalComposeUiApi::class) private fun onDrag( change: PointerInputChange, dragAmount: Offset, state: FreeScrollState, velocityTracker: VelocityTracker, coroutineScope: CoroutineScope ) { // Add historical position to velocity tracker to increase accuracy val changeList = change.historical.map { it.uptimeMillis to it.position } + (change.uptimeMillis to change.position) changeList.forEach { (time, pos) -> val position = Offset( pos.x - state.horizontalScrollState.value, pos.y - state.verticalScrollState.value ) velocityTracker.addPosition(time, position) } coroutineScope.launch { state.horizontalScrollState.scrollBy(-dragAmount.x) state.verticalScrollState.scrollBy(-dragAmount.y) } }
把onDrag
抽出一個方法,方法中,我們將拖拽的過程中的手勢點位添加到速度追蹤 器velocityTracker
中不斷精確我們得滾動速度。并將位置點位更新到兩個scrollState
private fun onEnd( velocityTracker: VelocityTracker, state: FreeScrollState, flingSpec: DecayAnimationSpec<Float>, coroutineScope: CoroutineScope ) { val velocity = velocityTracker.calculateVelocity() velocityTracker.resetTracking() // Launch two animation separately to make sure they work simultaneously. coroutineScope.launch { state.horizontalScrollState.fling(-velocity.x, flingSpec) } coroutineScope.launch { state.verticalScrollState.fling(-velocity.y, flingSpec) } }
private suspend fun ScrollState.fling(initialVelocity: Float, flingDecay: DecayAnimationSpec<Float>) { if (abs(initialVelocity) < 0.1f) return // Ignore flings with very low velocity scroll { var lastValue = 0f AnimationState( initialValue = 0f, initialVelocity = initialVelocity, ).animateDecay(flingDecay) { val delta = value - lastValue val consumed = scrollBy(delta) lastValue = value // avoid rounding errors and stop if anything is unconsumed if (abs(delta - consumed) > 0.5f) this.cancelAnimation() } } }
在拖拽結(jié)束后,從velocityTracker
拿出估算的速度值,用來給設(shè)置fling的衰減滾動動畫。 也就是說實際上滾動效果== 拖拽移動 + fling。
總結(jié)
JetPack Compose
是一個很強(qiáng)大很現(xiàn)代的 UI 工具,與使用自定義 View
來實現(xiàn)復(fù)雜手勢以及動畫效果時,代碼量大大減少,更加靈活。但是現(xiàn)在由于一方面 Android
原生開發(fā)者不斷減少,以及官方文檔相對簡陋,社區(qū)資料也比較匱乏,在出現(xiàn)不能覆蓋需求的問題時,比較耗費時間去找到問題的答案,好在官方目前更新速度還是非常的快,目前也已經(jīng)是達(dá)到可用甚至是易用的程度了,相信距離好用也不遙遠(yuǎn)。
到此這篇關(guān)于Jetpack Compose實現(xiàn)對角線滾動效果的文章就介紹到這了,更多相關(guān)Jetpack Compose對角線滾動內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Android WebView 不支持 H5 input type="file" 解決方法
這篇文章主要介紹了Android WebView 不支持 H5 input type="file" 解決方法,需要的朋友可以參考下2017-06-06Android實現(xiàn)類似execel的表格 能回顯并能修改表格內(nèi)容的方法
今天小編就為大家分享一篇Android實現(xiàn)類似execel的表格 能回顯并能修改表格內(nèi)容的方法,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2018-08-08Android 深入探究自定義view之流式布局FlowLayout的使用
FlowLayout(int align, int hgap, int vgap)創(chuàng)建一個新的流布局管理器,它具有指定的對齊方式以及指定的水平和垂直間隙,意思就是說從左上角開始添加原件,依次往后排,第一行擠滿了就換一行接著排2021-11-11Android五種隱藏狀態(tài)欄和標(biāo)題欄的方法
這篇文章主要介紹了Android五種隱藏狀態(tài)欄和標(biāo)題欄的方法的相關(guān)資料,需要的朋友可以參考下2017-05-05