DIV CSS 佈局教程網

iScroll.js 使用指南:從結構要求到進階效果
編輯:關於JavaScript     

概要

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 時最容易踩到的痛點,開發時可以特別留意。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved