diff options
Diffstat (limited to 'files/zh-cn/web/api/xmlserializer/index.html')
-rw-r--r-- | files/zh-cn/web/api/xmlserializer/index.html | 92 |
1 files changed, 92 insertions, 0 deletions
diff --git a/files/zh-cn/web/api/xmlserializer/index.html b/files/zh-cn/web/api/xmlserializer/index.html new file mode 100644 index 0000000000..5c0af6bf9f --- /dev/null +++ b/files/zh-cn/web/api/xmlserializer/index.html @@ -0,0 +1,92 @@ +--- +title: XMLSerializer +slug: XMLSerializer +tags: + - DOM Parsing + - XML + - XMLSerializer + - construct + - conversion +translation_of: Web/API/XMLSerializer +--- +<div dir="ltr" style="text-align: left;">{{APIRef("XMLSerializer")}}</div> + +<div dir="ltr" id="result_box" style="text-align: left;"><code>XMLSerializer</code>接口提供{{domxref("XMLSerializer.serializeToString", "serializeToString()")}} 方法来构建一个代表 {{Glossary("DOM")}} 树的XML字符串。</div> + +<h2 id="Methods" name="Methods">方法</h2> + +<dl> + <dt id="serializeToString">{{domxref("XMLSerializer.serializeToString", "serializeToString()")}}</dt> + <dd>返回DOM子树序列化后的字符串。</dd> + <dt id="serializeToStream">{{domxref("XMLSerializer.serializeToStream", "serializeToStream()")}} {{ non-standard_inline }}{{ deprecated_inline }}</dt> + <dd>将指定元素的每个子树按照特定的字符集序列化成字节流。</dd> +</dl> + +<h2 id="Examples" name="Examples">示例</h2> + +<h3 id="把_XML_序列化为字符串">把 XML 序列化为字符串</h3> + +<p>首先,最基本的例子是将整个 document 对象序列化为一个 XML 字符串。</p> + +<pre class="brush: js"> var s = new XMLSerializer(); + var d = document; + var str = s.serializeToString(d); + saveXML(str);</pre> + +<p>这里新建了一个 <code>XMLSerializer</code> 对象实例, 然后将待序列化的 {{domxref("Document")}} 对象实例传入返回等价 XML 的 {{domxref("XMLSerializer.serializeToString", "serializeToString()")}} 方法。</p> + +<h3 id="向一个基于_XML_的_DOM_对象中">向一个基于 XML 的 DOM 对象中</h3> + +<p>本例使用 {domxref("Element.insertAdjacentHTML()")}} 方法将一个新的 DOM {{domxref("Node")}} 插入 基于序列化 {{domxref("Document")}} 对象创建的 XML 中。</p> + +<div class="note"> +<p><strong>注意:</strong> 在真实场景下,你通常应该通过调用 {{domxref("Document.importNode", "importNode()")}} 方法将新节点加入 DOM 中, 然后通过调用以下方法将目标节点添加到 DOM 树:</p> + +<ul> + <li>{{domxref("Document")}} 和 {{domxref("Element")}} 方法 {{domxref("ParentNode.append", "append()")}} 和 {{domxref("ParentNode.prepend", "prepend()")}}</li> + <li>{{domxref("ChildNode.replaceWith", "Node.replaceWith()")}} 方法(替换现有节点)</li> + <li>{{domxref("Document.insertAdjacentElement()")}} 和 {{domxref("Element.insertAdjacentElement()")}} 方法.</li> +</ul> +</div> + +<p>因为<code>insertAdjacentHTML()</code> 的第二个参数是一个字符串而不是 <code>Node</code> 节点对象, 所以这里先要使用 <code>XMLSerializer</code> 将节点转换为字符串.</p> + +<pre class="brush: js">var inp = document.createElement('input'); +var XMLS = new XMLSerializer(); +var inp_xmls = XMLS.serializeToString(inp); // 先将一个 DOM 节点转换为字符串。 + +// 将新建的节点添加到 DOM 中。 +document.body.insertAdjacentHTML('afterbegin', inp_xmls);</pre> + +<p>以上代码通过调用 {{domxref("Document.createElement()")}} 方法新建一个 {HTMLElement("input")}} 对象 , 然后通过 {{domxref("XMLSerializer.serializeToString", "serializeToString()")}} 方法将该对象序列化为 XML.</p> + +<p>做完以上工作之后, 使用 <code>insertAdjacentHTML()</code> 方法将 <code><input></code> 元素加入 DOM.</p> + +<h2 id="规范">规范</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('DOM Parsing', '#the-xmlserializer-interface', 'XMLSerializer')}}</td> + <td>{{Spec2('DOM Parsing')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">浏览器兼容性</h2> + +<div>{{Compat("api.XMLSerializer")}}</div> + +<h2 id="参见">参见</h2> + +<ul> + <li><a href="https://developer.mozilla.org/en-US/Parsing_and_serializing_XML" title="en-US/Parsing_and_serializing_XML">Parsing and serializing XML</a></li> + <li>{{domxref("XMLHttpRequest")}}</li> + <li>{{domxref("DOMParser")}}</li> +</ul> |