概要
iScroll 4 幾乎重寫了整个框架的原始碼。這個專案源於行動版 WebKit 瀏覽器(iPhone、iPad、Android)雖然提供了限高限寬元素的本地捲動能力,但一旦使用,整個頁面就無法再同時擁有 position:absolute 的頁首、頁尾與中間可捲動區域。Android 新版本已改善(儘管仍不完美),而 Apple 一直不願把單指滑動事件開放給 div 元素。
除了舊版特性,iScroll 4 還加入:縮放(Pinch/Zoom)、拉動刷新、速度與效能提升、精準捕捉元素、自訂捲動軸。要注意它並非 iScroll 3 的簡易替代品,API 已經不同,且測試期間部分 API 仍可能微調。
iScroll 需要對要捲動的元素進行初始化,同一頁面可用個數不限(實際上限取決於你的硬體與內容複雜度)。DOM 結構應盡量簡單,移除多餘標籤、避免過度嵌套。最理想的結構是:
<div id="wrapper">
<ul>
<li></li>
.....
</ul>
</div>
這裡 ul 會被捲動,而 iScroll 必須與包在外層的 wrapper 產生關聯才會生效。
注意:只有 wrapper 的第一個子元素可以捲動。若需要多個元素一起捲動,就多包一層:
<div id="wrapper">
<div id="scroller">
<ul><li></li> ... </ul>
<ul><li></li> ... </ul>
</div>
</div>
這樣 scroller 成為唯一可捲動元素,即使它內部含兩個 ul。
(1)DOMContentLoaded——適合內容只有文字與固定尺寸圖片:
<script src="iscroll.js"></script>
<script>
var myscroll;
function loaded(){
myscroll = new iScroll("wrapper");
}
window.addEventListener("DOMContentLoaded", loaded, false);
</script>
把 myscroll 宣告為全域變數,任何地方都能取用。
(2)load 事件——因為 DOMContentLoaded 在 DOM 解析完就觸發,此時圖片尚未載入,捲動區尺寸可能算錯,改用 load 更保險:
<script src="iscroll.js"></script>
<script>
var myscroll;
function loaded(){
setTimeout(function(){
myscroll = new iScroll("wrapper");
}, 100);
}
window.addEventListener("load", loaded, false);
</script>
這會在頁面資源(含圖片)載入完成後 100 毫秒才初始化,是最安全的呼叫方式。
(3)行內初始化——在 HTML 解析到該處時立刻執行:
<script src="iscroll.js"></script>
<div id="wrapper">
<ul><li></li> ... </ul>
</div>
<script>
var myscroll = new iScroll("wrapper");
</script>
這種寫法並不推薦,不過實務上很多人這麼用。若要走這條路,建議搭配框架的 ready 方法(如 jQuery 的 ready())來確保時機安全。
第二個參數可傳入設定物件:
var myscroll = new iScroll("wrapper", {hScrollbar:false, vScrollbar:false});
· hScroll:是否允許橫向捲動,預設 true
· vScroll:是否允許垂直捲動,預設 true
· hScrollbar / vScrollbar:設為 false 可隱藏對應方向的捲動軸
· fixedScrollbar:iOS 上拖動超出邊界時捲動軸會收縮,設 true 可禁止它超出可見區域(Android 預設 true,iOS 預設 false)
· fadeScrollbar:指定無漸隱效果時隱藏捲動軸
· hideScrollbar:無使用者互動時隱藏,預設 true
· bounce:邊界反彈,預設 true
· momentum:慣性滑動,預設 true,想省資源時可關閉
· lockDirection:設 true 時拖動只能單一方向(上下或左右)
拉動刷新(Pull to refresh)
自從 Twitter 與幾個 Apple 應用帶起這個風潮後,它幾乎成了行動版清單的標配。iScroll 4 把這部分獨立成額外外掛,使用時只需自訂 pullDownAction()。若要在其中載入新內容,記得在 DOM 變更後呼叫 refresh()。官方範例刻意加了 1 秒延遲模擬網路延遲,不需要的話把 setTimeout 拿掉即可。
縮放(Pinch / Zoom)
光會捲動確實不夠新鮮,所以 iScroll 4 支援縮放。開啟方式很簡單:
var myScroll = new iScroll("wrapper", {zoom:true});
相關參數包含 zoomMax(最大倍數,預設 4)等。想要縮放順順,應把圖片放進硬體合成層——在需要縮放的 img 上使用 -webkit-transform:translate3d(0,0,0)。但硬體加速很吃資源,濫用反而會讓應用崩潰。
捕捉元素(Snap)
Snap 用來判斷內容是否滑到指定位置,可用來做跑馬燈式效果。外掛會自動分析捲動區內相同或同尺寸的元素作為捕捉點,也能手動指定:
var myscroll = new iScroll("wrapper", {
snap: true,
momentum: false,
hScrollbar: false,
vScrollbar: false
});
// 只捕捉 li 元素
var myscroll = new iScroll("wrapper", {
snap: "li",
momentum: false,
hScrollbar: false,
vScrollbar: false
});
自訂捲動軸
透過 scrollbarClass 指定 class,再用 CSS 控制外觀:
var myscroll = new iScroll("wrapper", { scrollbarClass: "myScrollbar" });
捲動軸由「容器」與「滑桿」兩個元素組成,容器高度等同 wrapper,滑桿才是實際可見的部分:
<div class="myScrollbarV"><div></div></div>
.myScrollbarV {
position: absolute;
z-index: 100;
width: 8px;
bottom: 7px;
top: 2px;
right: 1px;
}
.myScrollbarV > div {
position: absolute;
z-index: 100;
width: 100%;
background: -webkit-gradient(linear, 0 0, 100% 0, from(#f00), to(#900));
border: 1px solid #800;
-webkit-background-clip: padding-box;
-webkit-box-sizing: border-box;
-webkit-border-radius: 4px;
-webkit-box-shadow: inset 1px 1px 0 rgba(255,255,255,0.5);
}
refresh()——DOM 結構變動後必須呼叫,否則可捲動範圍會算錯:
setTimeout(function () { myScroll.refresh(); }, 0);
scrollTo(x, y, time, relative)——在指定時間內捲到絕對或相對位置:
myScroll.scrollTo(0, -100, 200); // 200ms 內 Y 軸下捲 100px myScroll.scrollTo(0, 10, 200, true); // 相對目前位置上移 10px
scrollToElement(element, time)——捲到指定元素,第一參數可用 CSS3 選擇器:
myScroll.scrollToElement('li:nth-child(10)', 100);
scrollToPage(pageX, pageY, time)——配合 snap 使用,跳到指定頁(索引從 0 起)。
destroy()——彻底銷毀實例並釋放記憶體:
myscroll.destroy(); myScroll = null;
後續發展方向
表單欄位支援、縮放效能優化、更好的桌面瀏覽器相容性、onScroll 事件優化、位址列 hash 變化,以及 DOM 變更後自動刷新。這些也正好是使用 iScroll 時最容易踩到的痛點,開發時可以特別留意。