一直忙到現在才有空好好研究 Prototype,如今它已更新到 1.5 pre1,強大的功能實在值得一學,可說是提升 JS 能力的又一條捷徑。
或許你還沒用過它。prototype.js 是由 Sam Stephenson 撰寫的 JavaScript 套件,這段構思巧妙、編寫精良且高度相容於標準的程式碼,肩負起打造「肥客戶端」、高互動性 Web 應用的重責,輕鬆為網站加入 Web 2.0 特性。
遺憾的是,它的文件並不算它的強項。和許多前人一樣,我只能一头紮進 prototype.js 的原始碼裡,逐段試驗。於是我一邊學一邊做筆記,順便分享給大家,也一併整理了這個套件的物件、類別、方法與擴充的非官方參考。
套件內建許多預定義物件與通用方法,目的很明顯——減少你大量重複的編碼與慣用寫法。從 Prototype 1.5.x 起,操作 DOM 變得更方便了:
var ele = $("myelement");
ele.hide(); //隱藏 DOM 物件
對比起舊版的 Element.hide(ele),這樣的改動有兩大好處:一是更物件導向,二是便於日後在 IDE 中獲得程式碼提示。
$() 是 DOM 中頻繁使用的 document.getElementById() 的便利簡寫,同樣回傳指定 id 的元素。它更勝一籌的地方在於:你可以一次傳入多個 id,它就回傳一個包含所有對應元素的陣列。此外,它既能接受 id 字串,也能接受元素物件本身,在打造能接收各種參數的方法時非常好用。
$F() 是另一個受歡迎的簡寫,能回傳任何表單控件(如文字框、下拉選單)的值,同樣可傳入元素的 id 或元素本身。
Try.these() 讓「依序嘗試多個方法直到其中一個成功」的需求變得輕鬆:它把一系列方法作為參數,逐一執行,直到有一個成功,便回傳該方法的返回值。例如在跨瀏覽器讀取 XML 節點文字時,xmlNode.text 在某些瀏覽器有效,xmlNode.textContent 則在另一些瀏覽器有效,用 Try.these() 就能取到真正可用的那個。
共通方法雖好用,卻談不上最高階——你很可能早自己寫過類似的东西。真正吸引人投入 Prototype 的,往往是它的 Ajax 能力。Ajax 物件封裝並簡化了撰寫 Ajax 時那些繁瑣細節,內部包含一系列封装 Ajax 邏輯的類別。
若不借助任何工具,你得親手建立 XMLHttpRequest、非同步追蹤進度、解析並處理回應,還得傷腦筋處理多瀏覽器相容。Ajax.Request 正是為了解決這些而存在。它接受目標 url 與一個匿名設定物件,例如 {method:'get', parameters:pars, onComplete:showResponse}:method 指定請求方式,parameters 為查詢字串,onComplete 則是你希望在完成時呼叫的函式。此外還能用 asynchronous 決定是否非同步(預設 true)。
XMLHttpRequest 在請求過程會回報四個階段:Loading、Loaded、Interactive、Complete。你可以透過 onXXXXX 這樣的屬性,在任一階段掛上自訂方法,其中 Complete 最常用;也可分別用 onSuccess 與 onFailure 處理成功與失敗兩種結果。
如果後端回傳的已經是 HTML,那麼 Ajax.Updater 會讓一切更省事——只要告訴它哪個元素要被回傳的 HTML 填入即可。它的第一個參數可以是單純的元素 id,也可以改成帶有 success 與 failure 兩個屬性的物件,藉此分別指定成功與失敗時要更新的容器;搭配 onFailure 就能優雅地處理伺服器端錯誤。若後端回傳的是 JavaScript 而非純 HTML,只要在最後的設定中加入 evalScripts: true,Updater 便會執行那段程式碼。
本文整理的 Prototype 學習資料還包含:prototype 1.4 參考、prototype 1.3 原始碼解讀、prototype 1.5 參考圖,以及 prototype 1.5pre1.js、prototype 1.4.js 等版本檔案,點擊即可下載。