XUL 文件可以取任何名字,但副檔名必須是 .xul。最簡單的 XUL 文件具有這樣的結構:
<?xml version="1.0"?>
<?xml-stylesheet href="chrome://global/skin/" type="text/css"?>
<window
id="findfile-window"
title="查找文件"
orient="horizontal"
xmlns="https://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
<!-- 其他元件寫在這裡 -->
</window>
這個視窗目前什麼也不做,因為裡頭還沒有任何使用者介面元素。以下逐行拆解:
宣告這是一個 XML 文件。通常每個 XUL 文件的最上面都會有這一行,作用就像 HTML 文件頂端的 <html> 標識。
這一行用來指定文件要套用的樣式表,是 XML 導入樣式表的標準語法。此例中我們從皮膚套件(skin package)的全域部分載入樣式,並未指定具體檔名,因此 Mozilla 會自行決定資料夾中要用哪一份,這裡會選中最重要的 global.css。這個檔案包含所有 XUL 元件的預設樣式宣告——因為 XML 本身并不知道元件該長什麼樣子,必須由此告知。實務上,每個 XUL 文件頂端都會有這一行;你也可以用同樣的語法載入其他樣式表,而自己的樣式表通常又要再載入全域樣式表。
這一行表示接下來要描述一個視窗。每個使用者介面視窗都在各自的文件中描述,這個標籤的角色相當於 HTML 中包住全部內容的 body。本例在 window 上設了四個屬性,為了可讀性各佔一行,但這並非必要。
horizontal 表示橫向並排;vertical 則是縱向堆疊,而且這正好是預設值,所以想用垂直排列時可以完全省略這個屬性。把註解那段換成真正要顯示在視窗裡的元件(按鈕、選單等),最後別忘了關閉 window 標籤。
寫好之後,有以下幾種開啟方式:
chrome: 協定前必須先完成套件的註冊;使用 file: 協定則可直接開啟。chrome: 的好處是能得到比一般網址更多的權限,雖然一開始用不上,仍建議先把 Chrome 環境設定好。.xul 副檔名已與 Mozilla 關聯,效果等同 file: 方式。window.open(),與開啟 HTML 文件相同,但要多帶一個 chrome 旗標,用來告知這是一個 Chrome 文件。window.open(url, windowname, flags);
// flags 中必須包含 "chrome"
window.open("chrome://navigator/content/navigator.xul", "bmarks",
"chrome,width=600,height=300");
另外也可以在命令列用 -chrome 參數,指定 Mozilla 啟動時要開啟的 XUL 文件:
mozilla -chrome chrome://findfile/content/findfile.xul
mozilla -chrome resource:/chrome/findfile/content/findfile.xul
要特別釐清的是:-chrome 參數本身並不會帶來特殊權限,真正具備特殊權限的是 Chrome URL。
套件的目錄組織並非一定要是 content/skin/locale 這種形式,簡單的測試專案完全可以自訂結構,例如把 findfile.xul 與 contents.rdf 放在同一層,再修改 installed-chrome.txt 完成註冊,然後切換到 Mozilla 目錄執行:
mozilla -chrome chrome://findfile/content/findfile.xul
如果執行後只出現一條標題列、什麼內容都沒有,那是正常的——因為我們的視窗裡還沒定義任何可視元素。接下來只要把按鈕、文字、清單等元件加進 window 標籤,畫面就會逐漸成形。