Gecko DOM 参考:Preface
From MDC
目录 |
[编辑] 关于本参考
本节描述此参考自己: 谁适合阅读此文档, 文档信息的组织方式, 和如何将文档中的例子用于你自己的DOM开发．
注意此参考正在编写中，因此并没有包含所有 Gecko 实现的 DOM 方法和属性.文档中个别的章节(例如, DOM 文档参考)已经完成, however. As reference information for the various members of the huge APIs becomes available, it is integrated into this document here.
[编辑] 谁应该阅读此指南
Gecko DOM 参考 的读者应是 web 开发人员和想了解 web 页是如何构造的人. 这分参考并不假定读者了解与DOM,与XML, 以及web服务或web标准;甚至JavaScript,它是使读者容易的使用 DOM 成为可能的语言。 但本文假定你熟悉HTML, 标记语言, 和网页基本的结构, 网页浏览器与CSS.
这里被提出的介绍材料,许多例子,和深入的解释对于初学者和老练的网开发人员都是有价值的,并且它不仅是一个“初学者”web开展指南。 一般来说，它应该是API参考手册。
[编辑] Gecko是什么?
Mozilla, Firefox, Netscape 6+, 和其它基于 Mozilla 的浏览器包含相同的DOM执行机构. 这是因为它们使用相同的技术.
Gecko 是上述浏览器的一个软件组件，它负责处理 HTML 的解析，网页的布局，文档对象模型，甚至整个应用程序界面的绘制。它是一个快速的，兼容标准的绘制引擎，在网页上下文和浏览器 (or chrome) 的程序界面中实现了 W3C DOM 标准和其它类似 DOM (非标准化的)的浏览器对象模型 (即 window 等)。
虽然程序界面和浏览器显示的内容在很多方面是不同的，但是 DOM 一律将它们当作一个节点树。
[编辑] API 参考格式
所有API参考描述包含如下格式, 输入和输出参数(在有返回类型的地方), 例子,附加的注意事项, 和到相关标准的连接.
代表性地, 只读属性只有一行, 因为不可能赋值给它们, 那些属性可能只能被访问. 例如, screen对像的只读属性availHeight 使用如下格式:
这意未着你只能把这些属性用于表达式的右边; 然而可读写的属性,你可以赋值给它, 我们使用下面的方法:
In general, the object whose member is being described is given in the syntax statement with a simple type, 例如, 所有元素element, 顶层文档模型对像document, 表格对像 TABLE , 等等. (查看重要的数据类型 获取关于数据类型的更多信息).
[编辑] 如何使用教程中的例子
教程中的多数例子是一个完整的文件, 你可以复制并粘贴到一个新文件中, 再用你的浏览器打开来执行. 其它的小片断,你可以把它放入JavaScript方法来执行. 例如, 你可以用如下的方法把window.document 属性放入JavaScript方法来测试, 他将通过按钮的单击来调用:
<html>
<script>
function testWinDoc() {
doc= window.document;
alert(doc.title);
}
</script>
<button onclick="testWinDoc();">test document property</button>
</html>
Similar functions and pages can be devised for all the object members that are not already packaged up for use. See the Testing the DOM API section in the introduction for a "test harness" that you can use to test a number of APIs all at once.