DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
XUL 教學 9.3:用範本動態產生樹狀元件
編輯:XML詳解     

這一節來談談如何用範本(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 屬性的作用

這個例子很能說明 uri 屬性的意義。注意 treeitem 上加了 uri 屬性,而且它並不是 rule 的直接子元素。原則是:uri 屬性只能加在需要重複循環的資源上。因為我們不希望 treechildren 反覆出現,所以它身上沒有 uri;反觀帶有 uri 的元素本身,以及它之後(內層)的元素,都會隨每一筆資料循環產生;而它之前(外層)的元素則只會產生一次。

如上圖所示,頂層節點底下的子節點會自動填滿。當範本或規則中包含 tree 或 menu 元素時,XUL 會依現有的 RDF 資料自動產生巢狀的 tree 或 menu 元素。

還有一點很有意思:RDF 資料來源裡的資源只在需要時才會被載入。也就是說,藏在階層深處的資料,只有在使用者真的展開檢視那些節點時才會被讀取。對於需要動態載入的資料來源來說,這個特性非常實用。

可排序的欄位

如果你實測過上面的例子,會發現檔案清單並沒有排序。事實上,當樹狀元件由 RDF 資料來源產生內容時,是可以指定排序的:任意欄都能升冪或降冪排列,使用者也能點擊欄位標題隨時切換排序依據。需要注意的是,若樹狀元件的內容是靜態資料,就無法排序,但你可以自己寫腳本手動實作。

排序行為由 treecol 上的三個屬性決定:

  • sort:設為對應排序欄位的 RDF 屬性,通常與 treecell 的 label 指向同一個屬性。設了這個屬性,資料就會依該欄排序;使用者點擊欄標題即可改變排序方向。反過來說,沒設 sort 的欄位無法排序。
  • sortDirection:決定預設排序方向,可為 ascending(升冪)、descending(降冪)或 natural(依 RDF 資料來源中的原始順序顯示)。
  • sortActive:只能在一個欄位上設為 true,用來標示預設的排序列。

雖然具備上述三個屬性就足以完成排序,實務上還建議為可排序欄位加上 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 時,規則會比對所有不含子元素的資源。

這兩個屬性的作用正好相反:一個資源可能是容器,也可能是空的。但「空」和「非容器」並不是同一件事。舉例來說,書籤資料夾是一個容器,但我們無從得知裡頭是否真的有子項目;而一個獨立的書籤或分隔線,則肯定不是容器。

把這兩個屬性與其他條件組合起來,幾乎可以判斷任何特殊情況,讓規則的撰寫更貼近資料本身的性質。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved