Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

 

前面提到: 我们要在本教程中创建一个简单的查找文件工具。不过开始之前,我们得先看看XUL文件的基本语法。

 

创建一个 XUL 文件

一个 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">
<!-- Other elements go here --> 
</window>

这个窗口不会做任何事情,因为它没有包含任何用户界面元素。那些元素会在下面的部分中添加。这里对上面的代码进行逐行断开解释:

  1. <?xml version="1.0"?>
    这一行只是简单声明这是一个 XML 文件。你通常在每一个 xul 文件的顶端都会添加这一行,非常像在一个 HTML 文件的顶端添加 HTML 的标识。
  2. <?xml-stylesheet href="chrome://global/skin/" type="text/css"?>
    这一行是用来指定文件使用的样式表的。这是 XML 文件用以导入样式表的语法。在这种情况下,我们从一个皮肤包的全局部分导入样式。我们没有指定特定的文件,所以 Mozilla 会确定使用文件夹中的哪一个文件。在这种情况下,会选中最重要的 global.css 文件。这个文件包括了所有 XUL 元件的默认声明。因为 XML 并不知道如何显示元件,因此这个文件指出怎样去做。通常,你会将这一行放在每一个 XUL 文件的顶部。你也可以采用类似语法导入其他的样式表。需要注意的是你一般都会在你的样式表文件中导入全局样式表。
  3. <window
    这一行说明你在描述一个 window 。每一个用户界面窗口都在一个单独的文件中进行描述。这个标记非常类似 HTML 中包围全部内容的 BODY 标记。 一些属性可以放到 window 标记中——在本例中有四个属性。在本例中,每一个属性都占一个单独的行,但并不是必须这样做。
  4. id="findfile-window"
    id 属性用作标识以便窗口被脚本所引用。你通常会为所有的软件放上 id 属性。虽然名字可由你任起,但应该是有一定关联的。
  5. title="查找文件"
    The title Attribute 属性描述显示时将在窗口的标题栏上显现的文本。在本例中将显示'查找文件'。
  6. orient="horizontal"
    orient 属性确定窗口中元件的排布。值 horizontal 意味着元件应该横过窗口水平放置。你也可以使用值 vertical,这表示元件将成一列放置。这是默认值,所以如果你希望使用垂直方向的话可以将这个属性完全关闭。
  7. xmlns="https://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
    这一行声名了 XUL 的名空间,你应该将它放到窗口元件以表示它的所有子元件都是 XUL。注意这个 URL 实际上不需要下载的。Mozilla 内部会识别这个 URL。
  8. <!-- 其他元件写到这里 -->
    将这个注释块替换成其他显示在窗口中的元件(按钮、菜单以及其他用户界面组件)。我们在接下面的部分将添加一些元件。
  9. </window>
    最后,我们需要在文件的结尾关闭 window 标记。

打开窗口

声明完一个窗口,如果打开它呢?这里有几种方法:

  • 如果是进行开发,你可以直接在浏览器的定位栏(location bar)中输入URL(chrome:、file:或其它形式的URL)。如果使用chrome则要按前面所讲的注册包。如果使用file:协议,可以直接打开。chrome的好处是可以获得比一般URL更多的权限。不过,现在还用不上。但建议还是把chrome配好。
  • 如果.xul文件已经与Mozilla作了关联,在资源管理器上双击即可。这种方式与file:方式效果一样。

不过,因为我们的XUL中没有定义其它元素,因此使用Mozilla打开时,什么也看不到。并且在浏览器中打开时,窗口会显示在浏览器中,这不是一个真正的应用,不过进行测试没有关系。

  • 正确的方法是使用Javascript来打开。使用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这种形式。象我的测试就是:

d:\project\test\xul\findfile

现在目录下有两个文件:

findfile.xul和contents.rdf

然后修改installed-chrome.txt文件。

切换到Mozilla目录,然后在命令行下输入:

mozilla -chrome chrome://findfile/content/filefile.xul

不过执行完后,什么都没有,就一个标题条。

(英文原文: XUL_Tutorial:Creating_a_Window ) 本篇wiki基于limodou的学习记录: XUL学习:XUL Tutorial(五) -- Creating a Window

 

文档标签和贡献者

 此页面的贡献者: zhu91aizhu, ziyunfei, 宋晓光, Duwei, GalaxySong, Bamanzi, Techie, Eckelcn
 最后编辑者: zhu91aizhu,