這一節要來看看 Mozilla 除了書籤之外還提供了哪些內建資料來源,以及怎麼用自己的 RDF 檔案當資料來源。
Mozilla 內建的資料來源不少,它們的運作方式和書籤資料來源幾乎一模一樣,差別只在可用的欄位不同。以下挑幾個代表性的來看。
歷史資料來源讓你能存取使用者最近造訪過的網頁清單。透過 rdf:history 就能取用其中的資料,可用的資源(欄位)如下:
| 資源 | 說明 |
|---|---|
| Date | https://home.netscape.com/NC-rdf#Date 最後造訪日期 |
| Name | https://home.netscape.com/NC-rdf#Name 網頁標題 |
| Page | https://home.netscape.com/NC-rdf#Page 網頁名稱 |
| Referrer | https://home.netscape.com/NC-rdf#Referrer 來源位址 |
| URL | https://home.netscape.com/NC-rdf#URL 網頁 URL |
| Visit Count | https://home.netscape.com/NC-rdf#VisitCount 造訪次數 |
需要的時候,把 button 或 treecell 的 label 屬性指向對應的 URL,就能取到那個值。歷史記錄通常用樹狀結構呈現,ref 屬性可以設為 NC:HistoryRoot;若改成 NC:HistoryByDate,就會改以日期排序。
下面是一個完整的例子,在樹狀結構中顯示 Name、URL 與 Date 三個欄位。
例 9.4.1(下載原始碼):
<tree flex="1" datasources="rdf:history" ref="NC:HistoryRoot">
<treecols>
<treecol id="name" label="Name" flex="1"/>
<treecol id="url" label="URL" flex="1"/>
<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/NC-rdf#URL"/>
<treecell label="rdf:https://home.netscape.com/NC-rdf#Date"/>
</treerow>
</treeitem>
</treechildren>
</rule>
</template>
</tree>
除了歷史與書籤,Mozilla 還內建了幾個資料來源,都能直接取用。
書籤(rdf:bookmarks):對應使用者的書籤清單。
| 資源 | 說明 |
|---|---|
| Added Date | https://home.netscape.com/NC-rdf#BookmarkAddDate 加入書籤的日期 |
| Description | https://home.netscape.com/NC-rdf#Description 書籤說明 |
| Last Modified | https://home.netscape.com/WEB-rdf#LastModifiedDate 最後修改日期 |
| Last Visited | https://home.netscape.com/WEB-rdf#LastVisitDate 最後造訪日期 |
| Name | https://home.netscape.com/NC-rdf#Name 書籤名稱 |
| Shortcut URL | https://home.netscape.com/NC-rdf#ShortcutURL 關鍵字 |
| URL | https://home.netscape.com/NC-rdf#URL 書籤網址 |
可搭配使用的根節點有:NC:BookmarksRoot(書籤階層最頂端)、NC:IEFavoritesRoot(對應 IE 的我的最愛)、NC:PersonalToolbarFolder(自訂工具列資料夾)。
檔案(rdf:files):對應使用者的檔案檢視。可用資源為 Name(檔案名稱)與 URL(檔案位址)。根節點方面,NC:FilesRoot 代表檔案資料來源的最上層,用來顯示磁碟機清單;若把某個目錄路徑當成 ref 的值(例如 file:///Windows 或 files:///usr/local),就會列出該目錄下的所有檔案。
檔案資料來源是個典型的「按需載入」來源:資料只在真正需要時才會被讀取。也就是說,你不需要事先載入整棵目錄樹,只有在樹狀元件實際展開顯示時,才會去取得對應的檔案清單。
在 datasources 屬性中,可以用空白分隔多個資料來源,XUL 就會從所有宣告的來源彙整資料:
<tree datasources="rdf:bookmarks rdf:history animals.rdf"
ref="NC:BookmarksRoot">
這個例子中,資料同時來自書籤、歷史記錄與 animals.rdf 三個來源,但它們被合併成一個複合資料來源,使用起來和單一來源沒有任何差別。
還有一個特殊值 rdf:null,代表不做任何事。如果你打算在腳本中動態指定資料來源,卻還不確定實際位址,或者不想設預設值,就可以先把 datasources 設成 rdf:null 當佔位。
內建來源之外,Mozilla 還有郵件清單、通訊錄、搜尋結果等其他來源。但若這些都不符合你的需求,最實際的做法還是把資料寫進自己的 RDF 檔案。這個檔案可以放在本機,也可以放在遠端伺服器上,只要在 datasources 屬性中填入對應的 URL 即可。
使用 RDF 檔案作為資料來源,功能上和內建來源完全相同。你可以用 rule 元素去比對特定類型的內容:只要 rule 上的屬性條件與資料來源檔案中的 Description 元素相符,就會取得該筆資料。RDF 檔案本身也可以建成階層結構。
下面的例子示範如何用 RDF 檔案當資料來源。RDF 檔本身相當龐大,這裡不列出,你可以從原文提供的連結查看純文字版與實際的 RDF 內容。
例 9.4.2(原始碼、預覽執行結果):
<tree flex="1" width="200" height="200"
datasources="animals.rdf"
ref="https://www.some-fictitious-zoo.com/all-animals">
<treecols>
<treecol id="name" label="Name" primary="true" flex="1"/>
<treecol id="species" label="Species" flex="1"/>
</treecols>
<template>
<rule>
<treechildren>
<treeitem uri="rdf:*">
<treerow>
<treecell label="rdf:https://www.some-fictitious-zoo.com/rdf#name"/>
<treecell label="rdf:https://www.some-fictitious-zoo.com/rdf#species"/>
</treerow>
</treeitem>
</treechildren>
</rule>
</template>
</tree>

這裡的 ref 屬性對應 RDF 檔中的 seq 元素,執行結果是一個動畫清單。只要把 ref 改成其他根元素的 about 屬性值,就能換一份資料出來——例如想只顯示爬蟲類,把 ref 設為 https://www.some-fictitious-zoo.com/reptiles 即可。
下一個例子示範:當你只需要 RDF 資料來源中的某個特定區塊時,ref 該怎麼寫。
例 9.4.3(原始碼、預覽執行結果):
<window
id="example-window"
title="History List"
xmlns:ANIMALS="https://www.some-fictitious-zoo.com/rdf#"
xmlns="https://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
<button label="Click here to see the mammals the zoo has" type="menu"
datasources="animals.rdf"
ref="https://www.some-fictitious-zoo.com/mammals">
<template>
<rule ANIMALS:specimens="0"></rule>
<rule>
<menupopup>
<menuitem uri="rdf:*"
label="rdf:https://www.some-fictitious-zoo.com/rdf#name"/>
</menupopup>
</rule>
</template>
</button>
</window>
因為只想載入哺乳動物,ref 被設為 https://www.some-fictitious-zoo.com/mammals,也就是 RDF 檔中某個 seq 元素;最終只會回傳該元素的子節點。
這裡用到了兩條規則,值得細看。第一條 <rule ANIMALS:specimens="0"></rule> 會比對所有帶有 ANIMALS:specimens 屬性且值為 0 的資源。RDF 檔中每個 description 元素都帶這個屬性,其中一部分被設為 0,這些資源就會被規則一比對中。但規則一裡頭什麼內容都沒有,所以即使比對成功也不會顯示任何東西——這是一個常用來「隱藏不想顯示的資料」的技巧。
第二條規則則負責比對剩下的資源,並在彈出式選單中建立一個項目。最終效果就是:選單裡只出現 specimens 不為 0 的哺乳動物。
譯者補充:本文是 XUL 教學第九章的第四節,內容歷史相當久遠(範例都以 Mozilla 瀏覽器為基礎,而 Mozilla 早已停止開發),但大部分概念對 Firefox 的擴充套件開發仍然適用。