標準 HTML 核取方塊並不支援「校驗」事件,因此無法在 GUI 行為發生後把它取消——而某些應用情境恰好需要這種能力。
本文要打造的控件用法可能如下:
<checkbox id="cbx_1" value="N" labelonleft="true"
label="Show Details:" onValue="Y" offValue="N" />
此外,控件還支援可取消的事件 onItemChanging 與通知事件 onItemChanged。
從結構上講,一個客製標籤就是一個副檔名為 .htc 的檔案,它在 <PUBLIC:COMPONENT> 與對應的結束標記之間描述自己的屬性、方法與事件。為了定義客製的 CHECKBOX 標籤,我們建立 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 核取方塊與 HTML 標籤。
要定義 labelonleft,我們在 PUBLIC:COMPONENT 區段加上一行:
<PROPERTY NAME="labelonleft" VALUE="true"/>
這個屬性沒有 getter 或 setter。屬性 onValue 與 offValue 則負責把核取方塊狀態對應到商業值域,同樣不需要 getter 與 setter:
<PROPERTY NAME="onValue" VALUE="true"/> <PROPERTY NAME="offValue" VALUE="false" />
相對地,checked 屬性是用一組 getter 與 setter 定義的:
<PROPERTY NAME="checked" GET="getChecked" PUT="putChecked" />
因此我們在 SCRIPT 區段建立這兩個方法。setter putChecked() 每次核取方塊狀態改變時都會被觸發,它會把 value 設為 onValue 或 offValue 其中一個:
var _value;
function putChecked(newValue) {
value = (newValue ? onValue : offValue);
}
function getChecked() {
return (_value == onValue);
}
請注意,putChecked() 不只會被宿主頁面中的腳本觸發,也能由 checkbox.htc 內部的任何赋值操作觸發。
接著看 onItemChanging 與 onItemChanged 的定義,以及它們如何在 value 屬性的 setter 內部被觸發與處理。putValue() 有幾個值得留意的細節:首先,在分析 CHECKBOX 標籤期間也可能呼叫這個方法(只要指定了 HTML 的 value 屬性),這解釋了為何要為「非建構階段」另外開一條邏輯分支,把建構過程與對使用者擊鍵的反應區分開來。其次,這裡展示了客製事件 onItemChanging 的建立與處理,它讓應用程式得以取消行為;而且無論是鍵盤操作還是程式化赋值,都能達到取消的目的。
要取消事件,應用程式應攔截該事件並把 event.returnValue 設為 false:
cbx_1::onItemChanging() {
. . .
if (canNotBeAllowed) {
event.returnValue = false;
. . .
}
}
若事件未被取消,putValue() 會把內部那個普通 HTML 核取方塊的 checked 屬性設為對應的目前值:等於 onValue 時勾選,等於 offValue 時不勾選(沒有第三種可能)。
控件的繪製由助理函式 addLabel() 與 addCheckBox() 完成,並在建構式中呼叫。這些函式把 HTML 注入元素的 innerHTML,簡化後的形式如下:
<label for="cb_{uniqueID}">Show Details:</label>
<input id="cb_{uniqueID}" type="checkbox" />
這裡的 uniqueID 是 IE 產生的、在單一頁面內唯一的字串,用來識別該 HTC 的實例。
我們的 CHECKBOX 有個缺點:依目前的做法,建構式期間注入的 HTML 屬於宿主頁面的 DOM,而 _value 這類全域 JavaScript 變數也落在所在文件的全域範圍。這很危險,因為可能發生命名衝突——最明顯的情況就是同一個組件被建立多個實例;此外,控件也可能誤引用了同名的其他物件,反之亦然。
幸好 HTC 技術提供了一個漂亮的解法:viewLink。要把控件宣告為封裝,最簡單的方式是在 PUBLIC:COMPONENT 標記之間多加一行宣告:
<PUBLIC:DEFAULTS viewLinkContent />
控件立刻變成封裝性的,並擁有自己的 HTML 文件樹,成為主文件的原子組件。每個實例都有自己的實例值集合,只有公開的方法與屬性才能從外部存取。換句話說,viewLink 機制讓我們能用真正物件導向、以組件為基礎的方式來設計與實作複雜的 Web 應用。
也因此程式碼得以簡化:既然不必再擔心命名衝突,就能把內部核取方塊與標籤定義中的 uniqueID 後綴拿掉,例如把
eval('cb_' + uniqueID).checked = (_value == onValue);
改成
cb.checked = (_value == onValue);
並相應調整 addCheckbox() 與 addLabel()。
Ajax 這場競賽才剛開始,因此還沒有什麼 Ajax 標準,也沒有現成、廣為接受的 RAD 工具可以依賴。雖然軟體供應商可能還要一段時間才能做出夠強健的開發平台,Ajax 支持者已經開始動手——用定義良好的 API 把可重複使用的程式碼塊封裝成商業組件。
本文沿著這個方向,歸納了 Ajax 語言(JavaScript)的物件導向能力,並示範一種可用的組件化策略:客戶端客製標籤技術。除了說明 IE 專屬的客製標籤之外,也另外提供了適用於 Mozilla 系瀏覽器的可擴充綁定(XBL)實作範例。