在諾亞財富這個專案中,我們用到了通訊錄功能。如果只是單純地瀏覽,體驗會顯得單調,於是我在查看的基礎上加入了「點擊滑動」的效果。這樣做有兩個目的:一是提升操作體驗;二是通訊錄的數據量往往很大,當點擊某個模組時,讓它滑動到最上層,可視範圍也會隨之變大。
點擊某個模組後,頁面會向上滑動,直到該模組被移到頁面最頂端。下圖是點擊前的狀態,我們以「運營中心」為例:

點擊之後,就會有一段滑動動畫把這個模組帶到頂部:

點擊某個元素時,程式需要知道使用者點的是哪一個 div,而不只是手指觸碰的座標。由於接口回傳的是一維陣列,在轉成多維陣列的過程中需要遍歷一次數據,此時正好可以為每筆數據加上 id:

接著在前端頁面這樣綁定 id:
<div ng-repeat="x in contacts_list" id="{{x.id}}">
一般來說,大家可能會先想到 jQuery 的 scrollTop 方法:
$(selector).scrollTop(offset)
它能實現滑動,但實測時發現兩個問題:點擊同一個模組,在不同的滑動位置觸發,滑動距離卻不一致;而且一旦內容被滑到上層,就再也滑不回來了,這與我們的需求嚴重不符。研究過其他幾個外掛後也無法達成目標,於是便想:功能如此強大的 Ionic 框架,是否內建了合適的方法呢?
$ionicScrollDelegate 用於控制滾動視圖(由 ion-content 與 ion-scroll 指令建立)。它會直接作用於所有滾動視圖,若要控制特定視圖,則可搭配 $getByHandle 方法。其中 resize() 方法在 ng-if 情境下特別常用。
它還提供了取得目前滾動位置的方法 getScrollPosition():
getScrollPosition()
回傳一個物件,包含以下屬性:
這裡我們只需要垂直方向的高度,因此用 $ionicScrollDelegate.getScrollPosition().top 即可取得當前滾動高度。
這兩個方法的關係,有點像絕對路徑(scrollTo)與相對位移(scrollBy)。我們用下面的方式取得點擊模組的位置:
document.getElementById(x.id).offsetTop
這取到的是該 div 距離「整個內容頂部」的位置。但我們每次的需求是讓點擊的模組滑到「螢幕最上方」,而非內容的頂部,因此這裡用 scrollBy 更合適——每次只需移動「螢幕頂部到點擊模組」之間的距離即可:
var scroll = document.getElementById(x.id).offsetTop - $ionicScrollDelegate.getScrollPosition().top;
接著在點擊事件中呼叫 Ionic 自帶的 scrollBy 方法:
$ionicScrollDelegate.resize(); $ionicScrollDelegate.scrollBy(0, scroll, true);
至此,這個功能就完成了。核心思路是:以 offsetTop 取得模組的絕對位置,減去目前的滾動高度 getScrollPosition().top,得到需要移動的相對距離,再交給 scrollBy 帶著動畫滾動過去。希望本文對大家有所幫助。