標準 HTML 的 checkbox 有幾個先天限制:值只有布林,難以對應商業上的 Y/N 或枚舉;也不支援「驗證」事件,無法在 GUI 行為發生之前把它取消——而某些應用確實需要這種把關能力。
本文示範如何用定制標籤做出一個更聰明的 checkbox。用法目標大致如下:
<checkbox id="cbx_1" value="N" labelonleft="true"
label="Show Details:" onValue="Y" offValue="N" />
這個控制項還會支援兩個事件:可取消的 onItemChanging,以及通知用的 onItemChanged。
結構上,一個定制標籤就是一個副檔名為 .htc 的檔案,在 <PUBLIC:COMPONENT> 與 </PUBLIC:COMPONENT> 之間描述它的屬性、方法與事件。checkbox.htc 的骨架如下:
<PUBLIC:COMPONENT NAME="cbx" tagName="CHECKBOX"> <PROPERTY NAME="value" GET="getValue" PUT="putValue" /> <!-- 其他屬性放在這裡 --> <METHOD NAME="show" /> <!-- 其他方法放在這裡 --> <EVENT NAME="onItemChanging" ID="onItemChanging" /> <!-- 對外觸發的其他事件放在這裡 --> <ATTACH EVENT="oncontentready" HANDLER="constructor" /> <!-- 自己處理的其他事件放在這裡 --> <SCRIPT> <!-- 方法、屬性的 getter/setter、事件處理器都放在這裡 --> </SCRIPT> </PUBLIC:COMPONENT>
HTC 檔的內容比檔名重要,但有一點必須注意:指向該 HTC 的 URL 要用 IMPORT 指令指定,而且必須在該定制標籤第一次出現之前完成。最簡單的頁面看起來像這樣(假設頁面與 HTC 位於同一個資料夾):
<html xmlns:myns> <?IMPORT namespace="myns" implementation="checkbox.htc" ?> <body> <myns:checkbox id='cbx_1' label='Hello' /> </body> </html>
定制 CHECKBOX 在 html 標籤中被映射到非預設的命名空間 myns。IMPORT 指令會把 HTC 同步載入瀏覽器記憶體,並告訴瀏覽器如何為該命名空間做名稱解析(HTC 與命名空間之間可以是多對一關係)。
初始化 HTC 最好的時機是它一被載入就處理 oncontentready 事件。於是我們定義一個處理器,為了概念清晰,稱之為建構函式:
<ATTACH EVENT="oncontentready" HANDLER="constructor" />
constructor() 的邏輯很簡單:依屬性 labelonleft 的值,按順序串接一個正規 HTML checkbox 與 label 標籤:
function constructor() {
// 把 HTML checkbox 與 label 加入元素本文
// 細節見 addLabel() 與 addCheckBox()
}
要定義 labelonleft,在 <PUBLIC:COMPONENT> 區段加一行即可:
<PROPERTY NAME="labelonleft" VALUE="true" />
這個屬性沒有 getter/setter。onValue 與 offValue 同理,它們負責把 checkbox 狀態映射到商業值域:
<PROPERTY NAME="onValue" VALUE="true" /> <PROPERTY NAME="offValue" VALUE="false" />
但 checked 屬性需要 getter 與 setter:
<PROPERTY NAME="checked" GET="getChecked" PUT="putChecked" />
於是我們在 <SCRIPT> 區段建立這兩個方法。setter putChecked() 在每次 checkbox 狀態改變時被觸發,把 value 設為 onValue 或 offValue 之一:
var _value;
function putChecked(newValue) {
value = (newValue ? onValue : offValue);
}
function getChecked() {
return (_value == onValue);
}
要注意的是,putChecked() 不只會被宿主頁面的腳本觸發,也能被 checkbox.htc 內部任何對 checked 的赋值觸發。
接著看 onItemChanging 與 onItemChanged 的定義,以及它們如何在 value 的 setter 內部被觸發與處理。putValue() 有兩個耐人尋味之處。
第一,在解析 CHECKBOX 標籤期間這個方法也會被呼叫——只要 HTML 上指定了 value 屬性。這解釋了為什麼我們要為「非建構階段」另外建立一個邏輯分支:把建構過程與「回應使用者按鍵」區分開來。
第二,這裡示範了定制事件 onItemChanging 的建立與處理,它允許應用程式取消行為。值得注意的是,不論是使用者按鍵還是程式赋值,都能達到取消的目的。
要取消事件,應用程式應該攔截該事件並把 event.returnValue 設為 false:
cbx_1::onItemChanging() {
. . .
if (canNotBeAllowed) {
event.returnValue = false;
. . .
}
若事件沒有被取消,putValue() 會把內部 HTML checkbox 的 checked 設為對應的目前值:等於 onValue 就勾選,等於 offValue(不存在第三種選擇)就不勾選。
控制項的呈現由 addLabel() 與 addCheckBox() 兩個助理函數完成,從 constructor() 內部呼叫,把 HTML 注入元素的 innerHTML。簡化後的形式如下:
<label for=cb_{uniqueID}>Show Details:</label>
<input id=cb_{uniqueID} type="checkbox" />
這裡的 uniqueID 是 IE 產生的、在單一頁面內唯一的字串,用來識別 HTC 的每個實例。
我們的 CHECKBOX 有個缺陷:constructor() 期間注入的 HTML 屬於宿主頁面的 DOM,而 _value 這類全域 JavaScript 變數也落在該文件的全域範圍。這很危險,因為命名衝突隨時可能發生——最明顯的情況就是同一個控制項被建立多個實例;此外,我們的控制項也可能誤引用到同名的其他物件,反之亦然。
要簡化這件事,需要一種機制讓物件真正模組化。幸好 HTC 技術提供了 ViewLink:
<PUBLIC:DEFAULTS viewLinkContent />
把這行放進開關的 PUBLIC:COMPONENT 標籤之間,控制項立刻變成封裝的:它擁有自己的 HTML 文件樹,成為主文件中的一個原子元件。每個實例都有自己的變數集合,只有公開的方法與屬性能從外部存取。換句話說,ViewLink 讓我們能用真正的物件導向、以元件為基礎的方式來設計複雜的 Web 應用。
具體好處是程式碼可以變乾淨:既然不再有命名衝突,就能把 uniqueID 後綴從內部 checkbox 與 label 的定義中移除。於是可以把
eval('cb_' + uniqueID).checked = (_value == onValue);
換成
cb.checked = (_value == onValue);
並相應調整 addCheckbox() 與 addLabel()。
Ajax 這場競賽才剛開始:既沒有 Ajax 標準,也沒有現成、廣為接受的 RAD 工具可以依賴。雖然軟體供應商要做出這樣強健的開發平台還需時間,Ajax 愛好者已經開始動手——透過良好定義的 API,把可重複使用的程式碼塊封裝成商業元件。
本文沿這個方向說明了 Ajax 語言的物件導向「力量」——JavaScript,並示範一種可行的元件化策略:客戶端定制標籤。我們描述的是 IE 特有的 HTC 定制標籤,同時也另附一個適合 Mozilla 瀏覽器的可擴充綁定範例。