這一節來談談如何用範本(template)搭配資料來源,自動產生樹狀元件的內容。
只要使用樹狀元件,就很難避開範本。原因很單純:樹狀結構通常用來呈現數量龐大、而且本身具有階層的資料,手工逐一寫出節點根本不現實。
用範本建立樹狀元件,語法和建立其他元件相去不遠。你需要在 tree 元素上加上 datasources 與 ref 兩個屬性,分別指定資料來源和要顯示的根節點;接著可以定義多條規則,用來處理不同類型的資料。
下面這個例子使用的是網頁歷史記錄資料來源:
<tree datasources="rdf:history" ref="NC:HistoryByDate"
flags="dont-build-content">
正如前一節提到的,樹狀元件可以改用「樹狀建構器」取代一般的「內容建構器」。差別在於:使用樹狀建構器時,並不是每一筆記錄都會在 DOM 中產生一個對應元素,這在處理大量資料時效率上非常有利。
上面範例把 flags 屬性設為 dont-build-content,就是要求使用樹狀建構器;若不設這個屬性,預設仍會走內容建構器。想實際理解兩者的差異,可以用 Mozilla 的 DOM Inspector 擴充套件,分別在有設與沒設 flags 的情況下檢查樹狀元件的內容結構。
如果你堅持使用內容建構器,好消息是內容只在必要時才會產生。以階層式的樹狀元件來說,子節點只會在父節點被展開的那一刻才被建立。
在範本中,樹狀元件的每一欄對應一個 treecell 元素,每個 treecell 都應該設定 label 屬性以對應欄位內容。實務上這個屬性通常指向某個 RDF 屬性,讓值能從資料來源動態填入。
下面的例子用範本建出一個顯示系統檔案結構的樹狀元件。
例 9.3.1(原始碼):
<tree id="my-tree" flex="1"
datasources="rdf:files" ref="file:///" flags="dont-build-content">
<treecols>
<treecol id="Name" label="Name" primary="true" flex="1"/>
<splitter/>
<treecol id="Date" label="Date" flex="1"/>
</treecols>
<template>
<rule>
<treechildren>
<treeitem uri="rdf:*">
<treerow>
<treecell label="rdf:https://home.netscape.com/NC-rdf#Name"/>
<treecell label="rdf:https://home.netscape.com/WEB-rdf#LastModifiedDate"/>
</treerow>
</treeitem>
</treechildren>
</rule>
</template>
</tree>
這個例子建了一個兩欄的樹狀元件,分別顯示名稱與修改日期,內容是根目錄下的檔案清單。這裡只寫了一條規則,需要時当然可以再加更多條。和其他範本一樣,帶有 uri 屬性的元素標示了內容開始重複生成的位置;兩欄各自從資料來源取得名稱與日期,再寫進 treecell 的 label。
這個例子很能說明 uri 屬性的意義。注意 treeitem 上加了 uri 屬性,而且它並不是 rule 的直接子元素。原則是:uri 屬性只能加在需要重複循環的資源上。因為我們不希望 treechildren 反覆出現,所以它身上沒有 uri;反觀帶有 uri 的元素本身,以及它之後(內層)的元素,都會隨每一筆資料循環產生;而它之前(外層)的元素則只會產生一次。

如上圖所示,頂層節點底下的子節點會自動填滿。當範本或規則中包含 tree 或 menu 元素時,XUL 會依現有的 RDF 資料自動產生巢狀的 tree 或 menu 元素。
還有一點很有意思:RDF 資料來源裡的資源只在需要時才會被載入。也就是說,藏在階層深處的資料,只有在使用者真的展開檢視那些節點時才會被讀取。對於需要動態載入的資料來源來說,這個特性非常實用。
如果你實測過上面的例子,會發現檔案清單並沒有排序。事實上,當樹狀元件由 RDF 資料來源產生內容時,是可以指定排序的:任意欄都能升冪或降冪排列,使用者也能點擊欄位標題隨時切換排序依據。需要注意的是,若樹狀元件的內容是靜態資料,就無法排序,但你可以自己寫腳本手動實作。
排序行為由 treecol 上的三個屬性決定:
ascending(升冪)、descending(降冪)或 natural(依 RDF 資料來源中的原始順序顯示)。雖然具備上述三個屬性就足以完成排序,實務上還建議為可排序欄位加上 sortDirectionIndicator 樣式類別。加上之後,欄位標題上會顯示一個小三角形提示目前的排序方向;不加不影響功能,但使用者就無從得知現在是按哪一欄、以哪個方向排列。
下面的例子在原本的基礎上補齊了這些設定:
<treecols>
<treecol id="Name" label="Name" flex="1" primary="true"
class="sortDirectionIndicator" sortActive="true"
sortDirection="ascending"
sort="rdf:https://home.netscape.com/NC-rdf#Name"/>
<splitter/>
<treecol id="Date" label="Date" flex="1" class="sortDirectionIndicator"
sort="rdf:https://home.netscape.com/WEB-rdf#LastModifiedDate"/>
</treecols>
使用者大概會希望下次打開時,欄位的排序狀態還在,不必重新設定。要做到這件事,得為每個 treecol 加上 persist 屬性。典型的寫法會持久化五個屬性:欄寬、排序位置、顯示與否、是否為排序列,以及排序方向。
<treecol id="Date" label="Date" flex="1"
class="sortDirectionIndicator"
persist="width ordinal hidden sortActive sortDirection"
sort="rdf:https://home.netscape.com/WEB-rdf#LastModifiedDate"/>
rule 元素還有兩個用來比對特殊情况的屬性,值都是布林值。
iscontainer:設為 true 時,規則會比對所有含有子元素的資源。舉例來說,可以用它來比對書籤資料夾。這個屬性的存在很方便,資料來源就不必為此額外定義專屬屬性。
isempty:設為 true 時,規則會比對所有不含子元素的資源。
這兩個屬性的作用正好相反:一個資源可能是容器,也可能是空的。但「空」和「非容器」並不是同一件事。舉例來說,書籤資料夾是一個容器,但我們無從得知裡頭是否真的有子項目;而一個獨立的書籤或分隔線,則肯定不是容器。
把這兩個屬性與其他條件組合起來,幾乎可以判斷任何特殊情況,讓規則的撰寫更貼近資料本身的性質。