From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001
From: Peter Bengtsson <mail@peterbe.com>
Date: Tue, 8 Dec 2020 14:40:17 -0500
Subject: initial commit

---
 .../web/api/document/createcomment/index.html      | 33 ++++++++++++++++++++++
 1 file changed, 33 insertions(+)
 create mode 100644 files/zh-cn/web/api/document/createcomment/index.html

(limited to 'files/zh-cn/web/api/document/createcomment')

diff --git a/files/zh-cn/web/api/document/createcomment/index.html b/files/zh-cn/web/api/document/createcomment/index.html
new file mode 100644
index 0000000000..1959a87312
--- /dev/null
+++ b/files/zh-cn/web/api/document/createcomment/index.html
@@ -0,0 +1,33 @@
+---
+title: document.createComment
+slug: Web/API/Document/createComment
+translation_of: Web/API/Document/createComment
+---
+<p>{{ ApiRef() }}</p>
+<h3 id="Summary" name="Summary">概述</h3>
+<p><code>createComment()</code> 方法用来创建并返回一个注释节点.</p>
+<h3 id="Syntax" name="Syntax">语法</h3>
+<pre class="eval"><em>var commentNode</em> = document.createComment(data)
+</pre>
+<h3 id="Parameters" name="Parameters">参数</h3>
+<ul>
+ <li><code>commentNode</code> 是一个注释节点.</li>
+ <li><code>data</code> 是一个字符串,包含了注释的内容.</li>
+</ul>
+<h3 id="Example" name="Example">例子</h3>
+<pre>var docu = new DOMParser().parseFromString('&lt;xml&gt;&lt;/xml&gt;',  "application/xml")
+
+var comment = docu.createComment('这是注释内容');
+
+docu.getElementsByTagName('xml')[0].appendChild(comment);
+
+alert(new XMLSerializer().serializeToString(docu));
+// 弹出 &lt;xml&gt;&lt;!--这是注释内容--&gt;&lt;/xml&gt;
+</pre>
+<h3 id="Notes" name="Notes">备注</h3>
+<ul>
+ <li>如果data字符串包含了 "--" ,则会抛出 <code>NS_ERROR_DOM_INVALID_CHARACTER_ERR</code>异常,这种情况需要对"--" 字符串进行转义.</li>
+</ul>
+<h3 id="Specification" name="Specification">规范</h3>
+<p><a class="external" href="http://www.w3.org/TR/REC-DOM-Level-1/level-one-core.html#method-createComment">createComment</a></p>
+<p>{{ languages( {"en": "en/DOM/document.createComment" } ) }}</p>
-- 
cgit v1.2.3-54-g00ecf