Prototype.js 為每一類主要功能都封裝了對應的 Class,使用起來十分便捷。只需 new Class.function(<argument>) 就能獲得特定效果。本文將其常用函數整理成一份速查表,並附上簡明示例,方便開發時隨查隨用。
Element 系列函數涵蓋了日常最常用的元素操作:
Element.toggle 交替隱藏或顯示,如 Element.toggle('div1','div2');Element.hide 隱藏、Element.show 顯示、Element.remove 刪除,用法如出一轍;Element.getHeight 則用來取得元素高度,如 Element.getHeight('div1')。此外,Toggle.display 與 Element.toggle 效果相同。
Insertion 系列提供了四個方位的插入能力:Insertion.Before 在元素前插入、Insertion.After 在元素後插入、Insertion.Top 插入到元素內部最前、Insertion.Bottom 插入到元素內部最後。例如 Insertion.Bottom('div1','this is a text')。
Field 系列聚焦單個輸入控件:Field.clear 清空、Field.focus 聚焦、Field.present 判斷內容是否為空、Field.select 選中內容、Field.activate 聚焦並選中內容。
Form 系列則面向整個表單:Form.serialize 把表單內容轉化為字符串、Form.getElements 以數組形式取得表單元素、Form.disable 禁用表單、Form.focusFirstElement 聚焦第一個元素、Form.reset 重置表單。而 $F 作為 Form.Element.getValue() 的快捷引用,可用 $F('text1') 直接取得輸入框的值,十分方便。
$ 是最標誌性的函數,等同於 getElementById,如 $('div1');PeriodicalExecuter 以指定頻率(單位為秒)重複調用一段 JavaScript,如 new PeriodicalExecuter(test, 1),其中 test 是函數名,1 表示每秒執行一次。
Ajax.Request 用於向服務器發送 Ajax 請求,Ajax.Updater 則會在發送請求的同時,用返回結果更新指定的容器元素,二者是 Prototype 異步能力的基石。
由於 Prototype 為每個主要類都分配了 Class,實際調用非常直觀:
<DIV id="div1">
<a href="#" onclick="new Element.toggle('div2')">Click Me</a>
</DIV>
<DIV id="div2">Hello!</DIV>
當點擊 "Click Me" 時,div2 便會交替隱藏或顯示。值得一提的是,toggle 支持傳入任意多個參數,可一次操作多個元素。掌握這份速查表,你就能把 Prototype 的大部分日常能力信手拈來。