Merge pull request #32 from fiji-flo/unslugging-zh-cn

Unslugging zh cn

1 files changed, 53 insertions, 0 deletions

diff --git a/files/zh-cn/conflicting/web/api/document_object_model/index.html b/files/zh-cn/conflicting/web/api/document_object_model/index.html
new file mode 100644
index 0000000000..d7a4164ee9
--- /dev/null
+++ b/files/zh-cn/conflicting/web/api/document_object_model/index.html
@@ -0,0 +1,53 @@
+---
+title: 前言
+slug: conflicting/Web/API/Document_Object_Model
+translation_of: Web/API/Document_Object_Model
+translation_of_original: Web/API/Document_Object_Model/Preface
+original_slug: Web/API/Document_Object_Model/Preface
+---
+<p>{{ ApiRef() }}</p>
+<h3 id="About_This_Reference" name="About_This_Reference">关于此参考文档</h3>
+<p>本节将描述与此向导本身相关的一些内容，内容包括它是做什么的，里面的信息是如何呈现的，以及怎样在你DOM开发中如何使用这份参考文档中的示例。</p>
+<p>注意，这份文档尚在开发中，并没有完整包含Gecko中所有已经移植的DOM方法及其属性，但是，文档中的每一个小节（例如，DOM文件参考）中所描述的对象是完整的。今后当某个API库的成员的信息可用时，它将会被整合到此文档中。</p>
+<h3 id="哪些人应该阅读这份指南">哪些人应该阅读这份指南</h3>
+<p>这份Gecko DOM参考文档的读者应该是一位web开发人员或者是一位对网页制作有一定了解的熟练web用户。这份文档对读者对DOM、XML、web服务或者web标准，甚至JavaScript——DOM呈现给读者的语言——的熟练度都没有要求。但是，本文档假定读者至少对HTML、标签、网页的基本结构、浏览器以及样式表是熟悉的。</p>
+<p>在这里，介绍性的资料在展示的同时伴随有许多示例，并且高等级的解释对没有经验的和经验丰富的web开发者都同样有用，并且也并不仅仅针对入门开发者。然而，这是一份正在不断改进中的API参考手册。</p>
+<h3 id="什么是Gecko？">什么是Gecko？</h3>
+<p>Mozilla，Firefox, Netscape 6以上版本，以及一些基于Mozilla的其他浏览器都有一个相同的对DOM的实现。这是因为它们使用的是相同的技术。</p>
+<p>Gecko，即在上述各种浏览器中处理HTML的解析，页面的排版，文档对象模型，以及整个应用界面的渲染的软件组件，是一个快速的、兼容多种标准的渲染引擎。它移植了W3C的DOM标准以及出现在网页页面和应用界面（或者称为chrome）中的类DOM（但尚未标准化）的浏览器对象模型（即所谓window等的）。</p>
+<p>尽管应用界面和页面内容在不同的浏览器里的呈现方式不一样，但是DOM期望它们统一地作为一种节点的分层结构。</p>
+<h3 id="API语法">API语法</h3>
+<p>API参考里的每个描述都包括语法、输入输出参数（包括返回类型），一个例子，额外的一些提示，以及指向对应参考文档的链接。</p>
+<p>只读的属性只能被读取。因为它们无法被设置，所以通常以一个单独的一行语法表示。例如screen对象的只读属性availHeight使用的语法如下：</p>
+<pre>iAvail = window.screen.availHeight
+</pre>
+<p>这意味着你只能把该只读属性放在等式的右边。</p>
+<p>可读/写的属性，既能被读取也能被写入：</p>
+<pre>msg = window.status
+window.status = msg
+</pre>
+<p>一般来说，描述对象的成员时，对象的格式声明通常都带有一个简单的类型描述符，例如，对所有的元素使用element，对所有的顶层文档对象使用document，对所有的表对象使用table等（详见<a href="/zh-CN/Gecko_DOM_Reference/Introduction#Important_Data_Types" title="zh-CN/Gecko_DOM_Reference/Introduction#Important_Data_Types">重要的数据类型</a>）。</p>
+<h3 id="Using_the_Examples" name="Using_the_Examples">如何使用示例</h3>
+<p>本参考文档中的许多示例都是完整的文档，你可以把他们复制粘贴到一个新的文件，然后在浏览器中打开它。</p>
+<p>其他的例子是一些代码片段。你可以把它们加入到JavaScript的回调函数中来执行。</p>
+<p>例如，这个关于<a href="/zh-CN/DOM/window.document" title="zh-CN/DOM/window.document">window.document</a>属性的例子能通过一个函数来测试。这里，它通过一个按钮的<code>onclick </code>属性来调用。</p>
+<pre class="brush: html">&lt;html&gt;
+&lt;head&gt;
+&lt;title&gt;Test Page&lt;/title&gt;
+&lt;script type="text/javascript"&gt;
+function testWinDoc() {
+
+  var doc= window.document;
+
+  alert(doc.title);
+
+}
+&lt;/script&gt;
+&lt;/head&gt;
+
+&lt;body&gt;
+  &lt;button onclick="testWinDoc();"&gt;test document property&lt;/button&gt;
+&lt;/body&gt;
+&lt;/html&gt;
+</pre>
+<p>其他一些尚未完整打包的对象成员也采用与此类似的函数和页面。参见<a href="/zh-CN/Gecko_DOM_Reference/Introduction#Testing_the_DOM_API" title="zh-CN/Gecko_DOM_Reference/Introduction#Testing_the_DOM_API">测试DOM API</a>，可以一次对各种API的做一次“无害测试”。</p>