mozilla
您的搜索结果

    前言

    关于此参考文档

    本节将描述与此向导本身相关的一些内容,内容包括它是做什么的,里面的信息是如何呈现的,以及怎样在你DOM开发中如何使用这份参考文档中的示例。

    注意,这份文档尚在开发中,并没有完整包含Gecko中所有已经移植的DOM方法及其属性,但是,文档中的每一个小节(例如,DOM文件参考)中所描述的对象是完整的。今后当某个API库的成员的信息可用时,它将会被整合到此文档中。

    哪些人应该阅读这份指南

    这份Gecko DOM参考文档的读者应该是一位web开发人员或者是一位对网页制作有一定了解的熟练web用户。这份文档对读者对DOM、XML、web服务或者web标准,甚至JavaScript——DOM呈现给读者的语言——的熟练度都没有要求。但是,本文档假定读者至少对HTML、标签、网页的基本结构、浏览器以及样式表是熟悉的。

    在这里,介绍性的资料在展示的同时伴随有许多示例,并且高等级的解释对没有经验的和经验丰富的web开发者都同样有用,并且也并不仅仅针对入门开发者。然而,这是一份正在不断改进中的API参考手册。

    什么是Gecko?

    Mozilla,Firefox, Netscape 6以上版本,以及一些基于Mozilla的其他浏览器都有一个相同的对DOM的实现。这是因为它们使用的是相同的技术。

    Gecko,即在上述各种浏览器中处理HTML的解析,页面的排版,文档对象模型,以及整个应用界面的渲染的软件组件,是一个快速的、兼容多种标准的渲染引擎。它移植了W3C的DOM标准以及出现在网页页面和应用界面(或者称为chrome)中的类DOM(但尚未标准化)的浏览器对象模型(即所谓window等的)。

    尽管应用界面和页面内容在不同的浏览器里的呈现方式不一样,但是DOM期望它们统一地作为一种节点的分层结构。

    API语法

    API参考里的每个描述都包括语法、输入输出参数(包括返回类型),一个例子,额外的一些提示,以及指向对应参考文档的链接。

    只读的属性只能被读取。因为它们无法被设置,所以通常以一个单独的一行语法表示。例如screen对象的只读属性availHeight使用的语法如下:

    iAvail = window.screen.availHeight
    

    这意味着你只能把该只读属性放在等式的右边。

    可读/写的属性,既能被读取也能被写入:

    msg = window.status
    window.status = msg
    

    一般来说,描述对象的成员时,对象的格式声明通常都带有一个简单的类型描述符,例如,对所有的元素使用element,对所有的顶层文档对象使用document,对所有的表对象使用table等(详见重要的数据类型)。

    如何使用示例

    本参考文档中的许多示例都是完整的文档,你可以把他们复制粘贴到一个新的文件,然后在浏览器中打开它。

    其他的例子是一些代码片段。你可以把它们加入到JavaScript的回调函数中来执行。

    例如,这个关于window.document属性的例子能通过一个函数来测试。这里,它通过一个按钮的onclick 属性来调用。

    <html>
    <head>
    <title>Test Page</title>
    <script type="text/javascript">
    function testWinDoc() {
     
      var doc= window.document;
     
      alert(doc.title);
     
    }
    </script>
    </head>
    
    <body>
      <button onclick="testWinDoc();">test document property</button>
    </body>
    </html>
    

    其他一些尚未完整打包的对象成员也采用与此类似的函数和页面。参见测试DOM API,可以一次对各种API的做一次“无害测试”。

    文档标签和贡献者

    此页面的贡献者有: ziyunfei, ReyCG_sub, khalid32, ngoyroe
    最后编辑者: khalid32,