XML Syntax & Structure API Reference

`XML Building Blocks`

10 methods

XML 构建要素参考,涵盖声明、元素、属性、命名空间等语法单元。

<?xml ?>

XML 声明,位于文档首行,声明版本与编码。

Returns

向解析器声明 XML 版本与字符编码,不属于文档内容。

Example

xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<note>
  <to>张三</to>
</note>

<element>

元素,XML 文档的基本构建单元,可嵌套并包含文本。

Returns

在文档树中形成一个可包含属性、文本与子元素的节点。

Example

xml

<book>
  <title>XML 入门</title>
  <author>李四</author>
</book>

attribute="value"

属性,为元素附加名值对形式的元数据。

Returns

为所属元素添加属性信息,不构成文档内容。

Example

xml

<product id="P001" price="19.99" currency="CNY">
  <name>笔记本</name>
</product>

注释,在文档中添加说明性文字,被解析器忽略。

Returns

不产生任何文档节点,仅供开发者阅读。

Example

xml

<!-- 这是订单根节点 -->
<order>
  <!-- 待发货 -->
  <status>pending</status>
</order>

<![CDATA[ ]]>

CDATA 段,包含不被解析器解析的原始字符数据。

Returns

原样保留段内文本,跳过 XML 标记解析。

Example

xml

<script>
  <![CDATA[
    if (a < b && b > 0) { alert("<hi>"); }
  ]]>
</script>

xmlns

命名空间声明,为元素和属性定义 URI 标识的命名空间,避免冲突。

Returns

将前缀绑定到命名空间 URI,使同名元素可在文档中共存。

Example

xml

<root
  xmlns:html="http://www.w3.org/1999/xhtml"
  xmlns:doc="urn:doc">
  <html:p>HTML 段落</html:p>
  <doc:section>文档节</doc:section>
</root>

<!DOCTYPE>

文档类型声明(DTD),定义文档结构与合法元素。

Returns

向解析器声明文档类型与结构约束,可影响校验与解析行为。

Example

xml

<!DOCTYPE note [
  <!ELEMENT note (to,from,body)>
  <!ELEMENT to (#PCDATA)>
]>
<note>
  <to>张三</to>
  <from>李四</from>
  <body>开会</body>
</note>

&entity;

实体引用,以 & 开头 ; 结尾转义特殊字符或引用预定义实体。

Returns

在文档中插入对应字符或实体内容,避免与 XML 语法冲突。

Example

xml

<message>
  &lt;tag&gt; 表示小于大于号
  &amp; 表示 and 符号
  &apos; 单引号 &quot; 双引号
</message>

<?pi ?>

处理指令(PI),向应用程序传递处理指令,格式为 <?target ?>。

Returns

向处理该 XML 的应用程序传递指令,解析器原样保留。

Example

xml

<?xml-stylesheet type="text/xsl" href="style.xsl"?>
<catalog>
  <item id="1"/>
</catalog>

Well-formedness

良好格式规则:必须有单一根元素、标签正确闭合、属性加引号、正确嵌套、大小写一致。

Returns

符合良好格式规则的文档可被解析器成功解析,否则报错。

Example

xml

<!-- 良好格式示例 -->
<root>
  <child attr="value">文本</child>
</root>

<!-- 错误:标签未闭合、属性无引号 -->
<!-- <root><child attr=value></root> -->

All references