QQ+网页XML手册 QQXML手册教程第一种一、基本单词1.xml 可扩展标记语言1.1.version 版本1.2.encoding 编码2.msg 消息2.1.serviceID 服务ID2.2.brief 简介2.3.flag 标志2.4.templateID 模板ID3.item 项目3.1.layout 布局3.2.mode 模式3.3.bg 背景颜色4.picture 图片4.1.cover 覆盖5.title 标题5.1.color 颜色5.2.size 字体大小5.3.style 方式6.summary 文本7.button 按钮7.1.action 活动7.2.url 链接8.1.source 来源8.2.name 名称8.3.icon 图标二、开始写代码XML声明通常的XML声明长这样：<?xml version="1.0" encoding="utf-8"?>它定义 XML 的版本 (1.0) 和所使用的编码 (utf-8)。但根据实践得出，编码是可以不用定义的。因此我们可以把代码简化成：<?xml version="1.0"?>消息类型消息类型，在XML中叫msg，写成标签就是：<msg>这里要注意一下，msg里有很多属性。论坛里那些配置的N切什么的，大屏小屏订阅号什么的，都是由一个属性叫做serviceID定义的当serviceID值是76时，就是之前很火的透明大屏 安卓/iOS 双兼容框架然而别高兴的太早，因为1月10号那天透明框架被滥用，（不少人应该在群里见过，那个“网警正在监控本群聊天记录”）导致第二天腾讯把这个框架封杀了。其他的我不知道，我不喜欢无脑切，不实用。因此也就没去学习。msg常用属性：（中英对照看上面）serviceID——这个我只懂76是透明框架，但是被封杀了。常用的数值为6.<msg serviceID="6">brief——显示在QQ会话列表，左边是（群）头像，右上角是（群）昵称，右下角显示这个属性的数值。默认为“你有新消息”<msg brief="[QQ红包]恭喜发财"> <msg brief="机器人有新消息">flag——长按XML后的标识，当该属性值为1或3时，该XML不可转发。常用数值为3<msg flag="3">templateID（这个依然不知道有什么用，目前未发现加不加有什么区别）Tips：属性的正确写法给一个属性赋值，需要用到“=”等于号。而数值需要用英文的双引号括起来。例：上面的XML声明<?xml version="1.0"?>中，version是一个属性。数值是1.0。数值括在双引号里，给属性赋值用等于号。注意！一定要用英文的双引号！中文的双引号（新宋体）：“”英文的双引号（新宋体）：""友情小贴士：<msg actionData="AppCmd://OpenContactInfo/?uin=$QQ无空格$" a_actionData="mqqapi://card/show_pslcard?src_type=internal&source=sharecard&version=1&uin=$QQ无空格$" i_actionData="mqqapi://card/show_pslcard?src_type=internal&source=sharecard&version=1&uin=$QQ无空格$">作用：点击卡片后跳转至回复者QQ资料页面。可自行修改链接。3个属性要一起用，具体啥意思我也不知道。。。复制粘贴就行了项目布局项目布局，在XML中叫item，写成代码就是<item>同样，item里也有很多属性。item常用属性：（中英对照看上面）layout——数值有0,1,2,3,5,6如果有其他的请指出。目前没发现其他的有什么用mode——当layout值为2时有用。一般值为1bg——数值是十六进制颜色代码。（参见十六进制颜色对应表）<item layout=“0”> 与 <item layout=“1”>个人认为这俩个完全一样，并且可以省略。也就是说：<item layout=“0”>等于<item layout=“1”>等于<item>Tips：一个XML绝对拥有以下代码，绝对。具体内容写在和中间。此布局是XML中重要的一部分。虽说不加这个布局也能显示出来，但会很难看。<?xml version="1.0"?> <msg> <item> </item> </msg>为了方便起见，以下所有的布局都可以写在这个布局里面。但除了布局之外，还有俩个最基本的标签，title和summary他们是整个XML代码中最基本的，用来显示——字。<title>呵呵</title>在这俩个标签中，常见的属性有color（字体颜色）size（字体大小）style（款式，不知道能干嘛）color可以定义该行代码显示的字的颜色，参见十六进制颜色对应表，上面有链接。新手也可以去看石头的，他的比较简单，但对新手来说够用了。size可以定义该行代码显示的字的大小，本人预测无限大，只要你的手机够硬。友情小贴士：清屏代码分享原理：size=非常大。<?xml version="1.0"?><msg> <item> <summary size="99999999"> </summary> </item> </msg>注：当title跟summary的color值和size值相同时，这俩个标签的效果是一样的。我之前测试过这俩个标签的默认值，存在笔记里，然后。。。手贱删了。现在懒得测试。<item layout="2">该布局用法：<?xml version="1.0"?> <msg> <item layout="2"> <picture cover="要显示的图片链接"/> <title>第一行字</title> <summary>第二行字</summary> </item> </msg> <item layout="2" mode="1">layout=“2” mode=“1”与上面的layout=“2”的区别在：如果仅仅是layout=“2”，那么右边俩行字会换行。示例：代码封杀太严重，另外俩点已经更新好了，先发上去，这个等会如果是layout=“2” mode=“1”，则多余的字会用省略号表示。示例：代码封杀太严重，另外俩点已经更新好了，先发上去，这个等会我是这样用的：（看心情分享配置代码）<?xml version="1.0"?> <msg> <item layout="2" mode="1"> <picture cover="mqqapi://card/show_pslcard?src_type=internal&source=sharecard&version=1&uin=$QQ无空格"/> <title>$昵称$ </title> <summary>$当前等级$ ($财富总额$/$还差等级积分$)</summary> </item> </msg> <item layout="3">该布局专门为按钮而用。在<item layout="3"></item>中间，可以在一行中显示无数个按钮（button），且按钮上的文字居中单行，显示一个按钮，但文字靠左显示，不居中的代码：（注：声明和msg的标签已省略）<button>示例1</button>单行，显示一个按钮，且文字居中显示：<item layout="3"> <button>示例2</button> </item>单行，显示二个按钮，且文字居中显示：<item layout="3"> <button>示例3.1</button> <button>示例3.2</button> </item>单行，显示三个按钮，且文字居中显示：<item layout="3"> <button>示例4.1</button> <button>示例4.2</button> <button>示例4.3</button> </item>以此类推，按钮个数无限制。（牛逼）多行则要用多个item布局：<item layout="3"> <button>示例5.1</button> <button>示例5.2</button> </item> <item layout="3"> <button>示例5.3</button> <button>示例5.4</button> </item>雨道大神曰：“一个卡片中button用多了容易被封。”有待证实。button，顾名思义是按钮，没错，按钮是可以按下的，上次时间紧没更新这个。使一个按钮能够被按下并且显示一个网页，需要用到俩个属性：action（活动）url（链接）具体用法为：<button action="web" url="链接">按钮名称</button>action=“web”：意为点击这个按钮时的活动为打开一个网页。url=“链接”：上面定义好了点击时要显示网页，这里当然要定义要显示的网页的链接了，这个不难理解。<item layout="6">这个是专门为图片准备的。大屏图片。使用方法：<?xml version="1.0"?> <msg> <item lauout="6"> <picture cover="要显示的图片链接"/> </item> </msg> <item layout="5">这个跟上面的类似。大屏图片，且图片下方有一行字。使用方法：<?xml version="1.0"?> <msg> <item layout="2"> <picture cover="这里放图片链接"/> <title>第一行字</title> </item> </msg>Tips：在layout=“5”时，如果把“title”那一行去掉，则效果跟layout=6完全一样，因此一般都直接用layout=“5”，无视6.在同一个XML中。项目布局（也就是item）可以使用多个，例如：<?xml version="1.0"?> <msg> <item layout="6"> <picture cover=""/> <title></title> </item> <item layout="2" mode="1"> <picture cover=""/> <title></title> <summary></summary> </item> <item bg="#000000"> <summary></summary> </item> </msg>上面这个代码采用了3个item，XMLstyle属性style为1 加粗style为2 倾斜style为3 加粗倾斜style为4 下划线style为5 单删除线文字样式文字居中：<item layout="1" bg=""><tr><td size="" color="" align="center">QQ</td></tr></item>文字置左：<item layout="1" bg=""><tr><td size="" color="" align="left">QQ</td></tr></item>文字置右：<item layout="1" bg=""><tr><td size="" color="" align="right">QQ</td></tr></item>serviceID="70"这是大屏`serviceID="76"这是大屏透明`serviceID="83"这是小屏透明`serviceID="43"这是订阅号`全屏<msg flag='70' serviceID='6'>小屏<msg flag='19' serviceID='6'>全屏定阅<msg flag='70' serviceID='43'>小屏定阅<msg flag='6' serviceID='43'>全屏透明<msg flag='6' serviceID='76'>小屏透明<msg flag='6' serviceID='83'>全屏作业<msg flag='70' serviceID='60'>小屏作业<msg flag='1' serviceID='60'>flag="0" 转.收.删.多.回flag="1" 收.删.多.回flag="2" 转.删.多.回flag="3" 删.多.回flag="4-7" 无效flag="8" 复.转.收.删.多.回flag="9" 复..收.删.多.回flag="10" 复.转.删.多.回flag="11" 复.删.多.回复--复制链接转--转发回--回复收--收藏删--删除多--多选目前已知的种类只有8种，即0-3和8-11；虽然16-18（3种）和24-27有效，但却是重复0-3和8-11的功能，所以目测flag参数种类只有8种。教程第二种<?xml version='1.0' encoding='UTF-8' standalone='yes' ?> <msg templateID="123" serviceID="1" action="plugin" actionData="AppCmd://OpenContactInfo/?uin=" a_actionData="mqqapi://card/show_pslcard?src_type=internal&amp;source=sharecard&amp;version=1&amp;uin=这里QQ号" i_actionData="mqqapi://card/show_pslcard?src_type=internal&amp;source=sharecard&amp;version=1&amp;uin=这里QQ号" brief="[QQ红包]恭喜发财" flag="3" url=""> <item bg="0" layout="4"> <picture cover="http://s.p.qq.com/pub/get_face?img_type=3&amp;uin=这里QQ号"/> <title size="30" color="#ff0000">这里是标题</title></item> <item><hr></hr> <summary color="#ff0000">这里是内容</summary> <summary color="#A96B28"></summary> <summary color="#706C61"></summary> </item> <item><hr></hr><summary color="#CD661D">这里是内容</summary></item> <source name="尾巴" icon="" /> </msg>PS：看不到请右滑；注意此代码只能在XML格式发送下使用，记得开启群消息好友消息XML发送，里面的内容可以随意修改，只是代码<>类勿动，actionData="AppCmd://OpenContactInfo/?uin="这句后面=QQ即可链接QQ资料以下为XML教程代码；<?xml version='1.0' encoding='UTF-8' standalone='yes' ?>——代码头msg serviceID="n"—消息类型msg flag="n" serviceID="n"——消息类型<item layout="n" mode="n">...</item>——布局样式(显示效果)<title>[文本]</title>—————文本(放字符号啥的)<summary>[文本]</summary>———文本<picture cover="..." />————图片(网络图片链接)<audio cover="..." />—————图片(带按钮__接QQ音乐网络链接可放歌)<hr/>—水平分割线<hr hidden="false" />—————添加分割符source name="[文本]"—————下标文字icon="..."————下标图片(网络图片链接)</msg>`代码尾`color="..."————字体颜色(16进制颜色对应码)style="..."————字体样式size="..."————字体大小<summary style="..." size="..." color="...">[文本]</summary> <audio cover="http://i.gtimg.cn/music/photo/mid_album_300/i/w/002tbrRh4VNUiw.jpg" src="http://ws.stream.qqmusic.qq.com/103182877.m4a?vkey=&amp;guid=&amp;fromtag=7"/>_msg serviceID="1" flag=1 收藏，打开msg serviceID="1" flag=2 转发，打开msg serviceID="1" flag=3 打开msg serviceID="1" flag=4 转发，收藏，打开msg serviceID="2" flag=1 收藏 这些不一定相对应，大家可以自己尝试msg serviceID="2" flag=2 转发msg serviceID="2" flag=3 空msg serviceID="2" flag=4 转发，收藏_<item layout="2" mode="1"></item>要显示的东西必须在这俩个(布局标签)里面<除了代码头尾和小标>可多个布局标签<item layout="2" mode="1">....</item>【换行】<item layout="2" mode="1">....</item>以达到一个卡片显示多个Q号的资料等效果使用qq头像，可以用<picture cover="http://q2.qlogo.cn/headimg_dl?dst_uin=%QQ%&amp;spec=100" />或者换成其它尺寸的图片：http://q2.qlogo.cn/headimg_dl?dst_uin=%QQ%&amp;spec=5qq空间里的头像<picture cover="http://qlogo4.store.qq.com/qzone/498031401/498031401/100" /> 之类的。网页XML手册┄┄┄┄内容目录┄┄┄┄XML 基础┄┄┄┄XML 简介什么是 XML，以及它与 HTML 的区别。┄┄┄┄如何使用 XML不同的 XML 使用方式。┄┄┄┄XML 树结构XML 文档如何形成一种有逻辑的树结构。┄┄┄┄XML 语法有逻辑且非常简单的 XML 语法规则。┄┄┄┄XML 元素XML 元素、内容和命名规则、父与子元素之间的关系。┄┄┄┄XML 属性如何使用 XML 属性提供关于元素的额外信息。┄┄┄┄XML 注意事项┄┄┄┄XML 数据存储┄┄┄┄XML 编码┄┄┄┄使用 CSS 来显示 XML如何使用 CSS 来显示一个 XML 文件。┄┄┄┄使用 XSL 来显示 XML如何使用 XSL 来显示一个 XML 文件。┄┄┄┄┄┄┄┄┄┄┄┄XML简介XML 被设计用来传输和存储数据。HTML 被设计用来显示数据。应该掌握的基础知识：在您继续学习之前，需要对以下知识有基本的了解：HTML / XHTMLJavaScript如果您希望首先学习这些项目，请在我们的 首页 访问这些教程。什么是 XML?XML 指可扩展标记语言（EXtensible Markup Language）XML 是一种标记语言，很类似 HTMLXML 的设计宗旨是传输数据，而非显示数据XML 标签没有被预定义。您需要自行定义标签。XML 被设计为具有自我描述性。XML 是 W3C 的推荐标准XML 与 HTML 的主要差异XML 不是 HTML 的替代。XML 和 HTML 为不同的目的而设计：XML 被设计为传输和存储数据，其焦点是数据的内容。HTML 被设计用来显示数据，其焦点是数据的外观。HTML 旨在显示信息，而 XML 旨在传输信息。没有任何行为的 XMLXML 是不作为的。也许这有点难以理解，但是 XML 不会做任何事情。XML 被设计用来结构化、存储以及传输信息。下面是 John 写给 George 的便签，存储为 XML：<note> <to>George</to> <from>John</from> <heading>Reminder</heading> <body>Don't forget the meeting!</body> </note>上面的这条便签具有自我描述性。它拥有标题以及留言，同时包含了发送者和接受者的信息。但是，这个 XML 文档仍然没有做任何事情。它仅仅是包装在 XML 标签中的纯粹的信息。我们需要编写软件或者程序，才能传送、接收和显示出这个文档。XML 仅仅是纯文本XML 没什么特别的。它仅仅是纯文本而已。有能力处理纯文本的软件都可以处理 XML。不过，能够读懂 XML 的应用程序可以有针对性地处理 XML 的标签。标签的功能性意义依赖于应用程序的特性。通过 XML 您可以发明自己的标签上例中的标签没有在任何 XML 标准中定义过（比如 <to> 和 <from>）。这些标签是由文档的创作者发明的。这是因为 XML 没有预定义的标签。在 HTML 中使用的标签（以及 HTML 的结构）是预定义的。HTML 文档只使用在 HTML 标准中定义过的标签（比如 <p> 、<h1> 等等）。XML 允许创作者定义自己的标签和自己的文档结构。XML 不是对 HTML 的替代XML 是对 HTML 的补充。XML 不会替代 HTML，理解这一点很重要。在大多数 web 应用程序中，XML 用于传输数据，而 HTML 用于格式化并显示数据。对 XML 最好的描述是：XML 是独立于软件和硬件的信息传输工具。XML 是 W3C 的推荐标准可扩展标记语言 (XML) 于 1998 年 2 月 10 日成为 W3C 的推荐标准。XML 无所不在当我们看到 XML 标准突飞猛进的开发进度，以及大批的软件开发商采用这个标准的日新月异的速度时，真的是不禁感叹这真是令人叹为观止。目前，XML 在 Web 中起到的作用不会亚于一直作为 Web 基石的 HTML。XML 无所不在。XML 是各种应用程序之间进行数据传输的最常用的工具，并且在信息存储和描述领域变得越来越流行。┄┄┄┄XML用途XML 应用于 web 开发的许多方面，常用于简化数据的存储和共享。XML 把数据从 HTML 分离如果你需要在 HTML 文档中显示动态数据，那么每当数据改变时将花费大量的时间来编辑 HTML。通过 XML，数据能够存储在独立的 XML 文件中。这样你就可以专注于使用 HTML 进行布局和显示，并确保修改底层数据不再需要对 HTML 进行任何的改变。通过使用几行 JavaScript，你就可以读取一个外部 XML 文件，然后更新 HTML 中的数据内容。提示：您将在稍后的章节学习更多这方面的内容。XML 简化数据共享在真实的世界中，计算机系统和数据使用不兼容的格式来存储数据。XML 数据以纯文本格式进行存储，因此提供了一种独立于软件和硬件的数据存储方法。这让创建不同应用程序可以共享的数据变得更加容易。XML 简化数据传输通过 XML，可以在不兼容的系统之间轻松地交换数据。对开发人员来说，其中一项最费时的挑战一直是在因特网上的不兼容系统之间交换数据。由于可以通过各种不兼容的应用程序来读取数据，以 XML 交换数据降低了这种复杂性。XML 简化平台的变更升级到新的系统（硬件或软件平台），总是非常费时的。必须转换大量的数据，不兼容的数据经常会丢失。XML 数据以文本格式存储。这使得 XML 在不损失数据的情况下，更容易扩展或升级到新的操作系统、新应用程序或新的浏览器。XML 使您的数据更有用由于 XML 独立于硬件、软件以及应用程序，XML 使您的数据更可用，也更有用。不同的应用程序都能够访问您的数据，不仅仅在 HTML 页中，也可以从 XML 数据源中进行访问。通过 XML，您的数据可供各种阅读设备使用（手持的计算机、语音设备、新闻阅读器等），还可以供盲人或其他残障人士使用。XML 用于创建新的 Internet 语言很多新的 Internet 语言是通过 XML 创建的：其中的例子包括：XHTML - 最新的 HTML 版本WSDL - 用于描述可用的 web serviceWAP 和 WML - 用于手持设备的标记语言RSS - 用于 RSS feed 的语言RDF 和 OWL - 用于描述资源和本体SMIL - 用于描述针针对 web 的多媒体假如开发人员都是理性的假如他们都是理性的，就让未来的应用程序使用 XML 来交换数据吧。未来也许会出现某种字处理软件、电子表格程序以及数据库，它们可以使用纯文本格式读取彼此的数据，而不需要使用任何的转换程序。我们现在能做的只有祈祷微软公司和所有其他的软件开发商在这一方面取得一致了。┄┄┄┄XML树结构XML 文档形成了一种树结构，它从“根部”开始，然后扩展到“枝叶”。一个 XML 文档实例XML 使用简单的具有自我描述性的语法：<?xml version="1.0" encoding="ISO-8859-1"?> <note> <to>George</to> <from>John</from> <heading>Reminder</heading> <body>Don't forget the meeting!</body> </note>第一行是 XML 声明。它定义 XML 的版本 (1.0) 和所使用的编码 (ISO-8859-1 = Latin-1/西欧字符集)。下一行描述文档的根元素（像在说：“本文档是一个便签”）：接下来 4 行描述根的 4 个子元素（to, from, heading 以及 body）：<to>George</to> <from>John</from> <heading>Reminder</heading> <body>Don't forget the meeting!</body>最后一行定义根元素的结尾：从本例可以设想，该 XML 文档包含了 John 给 George 的一张便签。XML 具有出色的自我描述性，你同意吗？XML 文档形成一种树结构XML 文档必须包含根元素。该元素是所有其他元素的父元素。XML 文档中的元素形成了一棵文档树。这棵树从根部开始，并扩展到树的最底端。所有元素均可拥有子元素：<root> <child> <subchild>.....</subchild> </child> </root>父、子以及同胞等术语用于描述元素之间的关系。父元素拥有子元素。相同层级上的子元素成为同胞（兄弟或姐妹）。所有元素均可拥有文本内容和属性（类似 HTML 中）。实例上图表示下面的 XML 中的一本书：<bookstore> <book category="COOKING"> <title lang="en">Everyday Italian</title> <author>Giada De Laurentiis</author> <year>2005</year> <price>30.00</price> </book> <book category="CHILDREN"> <title lang="en">Harry Potter</title> <author>J K. Rowling</author> <year>2005</year> <price>29.99</price> </book> <book category="WEB"> <title lang="en">Learning XML</title> <author>Erik T. Ray</author> <year>2003</year> <price>39.95</price> </book> </bookstore>例子中的根元素是 <bookstore>。文档中的所有 <book> 元素都被包含在 <bookstore> 中。<book> 元素有 4 个子元素：<title>、<author>、<year>、<price>。┄┄┄┄XML语法XML 的语法规则很简单，且很有逻辑。这些规则很容易学习，也很容易使用。所有 XML 元素都须有关闭标签在 HTML，经常会看到没有关闭标签的元素：<p>This is a paragraph<p>This is another paragraph在 XML 中，省略关闭标签是非法的。所有元素都必须有关闭标签：<p>This is a paragraph</p><p>This is another paragraph</p> 注释：您也许已经注意到 XML 声明没有关闭标签。这不是错误。声明不属于XML本身的组成部分。它不是 XML 元素，也不需要关闭标签。XML 标签对大小写敏感XML 元素使用 XML 标签进行定义。XML 标签对大小写敏感。在 XML 中，标签 <Letter> 与标签 <letter> 是不同的。必须使用相同的大小写来编写打开标签和关闭标签：<Message>这是错误的。</message><message>这是正确的。</message> 注释：打开标签和关闭标签通常被称为开始标签和结束标签。不论您喜欢哪种术语，它们的概念都是相同的。XML 必须正确地嵌套在 HTML 中，常会看到没有正确嵌套的元素：This text is bold and italic在 XML 中，所有元素都必须彼此正确地嵌套：This text is bold and italic在上例中，正确嵌套的意思是：由于 <i> 元素是在 <b> 元素内打开的，那么它必须在 <b> 元素内关闭。XML 文档必须有根元素XML 文档必须有一个元素是所有其他元素的父元素。该元素称为根元素。<root> <child> <subchild>.....</subchild> </child> </root>XML 的属性值须加引号与 HTML 类似，XML 也可拥有属性（名称/值的对）。在 XML 中，XML 的属性值须加引号。请研究下面的两个 XML 文档。第一个是错误的，第二个是正确的：<note date=08/08/2008> <to>George</to> <from>John</from> </note> <note date="08/08/2008"> <to>George</to> <from>John</from> </note> 在第一个文档中的错误是，note 元素中的 date 属性没有加引号。实体引用在 XML 中，一些字符拥有特殊的意义。如果你把字符 "<" 放在 XML 元素中，会发生错误，这是因为解析器会把它当作新元素的开始。这样会产生 XML 错误：<message>if salary < 1000 then</message>为了避免这个错误，请用实体引用来代替 "<" 字符：<message>if salary &lt; 1000 then</message>在 XML 中，有 5 个预定义的实体引用：< < 小于> > 大于& & 和号' ' 单引号" " 引号注释：在 XML 中，只有字符 "<" 和 "&" 确实是非法的。大于号是合法的，但是用实体引用来代替它是一个好习惯。XML 中的注释在 XML 中编写注释的语法与 HTML 的语法很相似：在 XML 中，空格会被保留HTML 会把多个连续的空格字符裁减（合并）为一个：HTML: Hello my name is David.输出: Hello my name is David.在 XML 中，文档中的空格不会被删节。XML 以 LF 存储换行在 Windows 应用程序中，换行通常以一对字符来存储：回车符 (CR) 和换行符 (LF)。这对字符与打字机设置新行的动作有相似之处。在 Unix 应用程序中，新行以 LF 字符存储。而 Macintosh 应用程序使用 CR 来存储新行。┄┄┄┄XML元素XML 文档包含 XML 元素。什么是 XML 元素？XML 元素指的是从（且包括）开始标签直到（且包括）结束标签的部分。元素可包含其他元素、文本或者两者的混合物。元素也可以拥有属性。<bookstore> <book category="CHILDREN"> <title>Harry Potter</title> <author>J K. Rowling</author> <year>2005</year> <price>29.99</price> </book> <book category="WEB"> <title>Learning XML</title> <author>Erik T. Ray</author> <year>2003</year> <price>39.95</price> </book> </bookstore> 在上例中，<bookstore> 和 <book> 都拥有元素内容，因为它们包含了其他元素。<author> 只有文本内容，因为它仅包含文本。在上例中，只有 <book> 元素拥有属性 (category="CHILDREN")。XML 命名规则XML 元素必须遵循以下命名规则：名称可以含字母、数字以及其他的字符名称不能以数字或者标点符号开始名称不能以字符 “xml”（或者 XML、Xml）开始名称不能包含空格可使用任何名称，没有保留的字词。最佳命名习惯使名称具有描述性。使用下划线的名称也很不错。名称应当比较简短，比如：<book_title>，而不是：<the_title_of_the_book>。避免 "-" 字符。如果您按照这样的方式进行命名："first-name"，一些软件会认为你需要提取第一个单词。避免 "." 字符。如果您按照这样的方式进行命名："first.name"，一些软件会认为 "name" 是对象 "first" 的属性。避免 ":" 字符。冒号会被转换为命名空间来使用（稍后介绍）。XML 文档经常有一个对应的数据库，其中的字段会对应 XML 文档中的元素。有一个实用的经验，即使用数据库的名称规则来命名 XML 文档中的元素。非英语的字母比如 éòá 也是合法的 XML 元素名，不过需要留意当软件开发商不支持这些字符时可能出现的问题。XML 元素是可扩展的XML 元素是可扩展，以携带更多的信息。请看下面这个 XML 例子：<note> <to>George</to> <from>John</from> <body>Don't forget the meeting!</body> </note> 让我们设想一下，我们创建了一个应用程序，可将 <to>、<from> 以及 <body> 元素提取出来，并产生以下的输出：MESSAGETo: GeorgeFrom: JohnDon't forget the meeting!想象一下，之后这个 XML 文档作者又向这个文档添加了一些额外的信息：<note> <date>2008-08-08</date> <to>George</to> <from>John</from> <heading>Reminder</heading> <body>Don't forget the meeting!</body> </note>那么这个应用程序会中断或崩溃吗？不会。这个应用程序仍然可以找到 XML 文档中的 <to>、<from> 以及 <body> 元素，并产生同样的输出。XML 的优势之一，就是可以经常在不中断应用程序的情况进行扩展。┄┄┄┄XML属性XML 元素可以在开始标签中包含属性，类似 HTML。属性 (Attribute) 提供关于元素的额外（附加）信息。[[[[[[由于xml影响文章代码，这里的xml加了空格破坏了]]]]]]XML 属性从 HTML，你会回忆起这个：< im g s rc="computer.gif">。"src" 属性提供有关 <im g> 元素的额外信息。在 HTML 中（以及在 XML 中），属性提供有关元素的额外信息：< img s rc="computer.gif"> < a hr ef="demo.asp"> 属性通常提供不属于数据组成部分的信息。在下面的例子中，文件类型与数据无关，但是对需要处理这个元素的软件来说却很重要：< file ty pe="gif">computer.gif</fil e>XML 属性必须加引号属性值必须被引号包围，不过单引号和双引号均可使用。比如一个人的性别，person 标签可以这样写：<person sex="female">或者这样也可以：<person sex='female'>注释：如果属性值本身包含双引号，那么有必要使用单引号包围它，就像这个例子：<gangster name='George "Shotgun" Ziegler'>或者可以使用实体引用：<gangster name="George &quot;Shotgun&quot; Ziegler">XML 元素 vs. 属性请看这些例子：<person sex="female"> <firstname>Anna</firstname> <lastname>Smith</lastname> </person> <person> <sex>female</sex> <firstname>Anna</firstname> <lastname>Smith</lastname> </person> 在第一个例子中，sex 是一个属性。在第二个例子中，sex 则是一个子元素。两个例子均可提供相同的信息。没有什么规矩可以告诉我们什么时候该使用属性，而什么时候该使用子元素。我的经验是在 HTML 中，属性用起来很便利，但是在 XML 中，您应该尽量避免使用属性。如果信息感觉起来很像数据，那么请使用子元素吧。我最喜欢的方式下面的三个 XML 文档包含完全相同的信息：第一个例子中使用了 date 属性：<note date="08/08/2008"> <to>George</to> <from>John</from> <heading>Reminder</heading> <body>Don't forget the meeting!</body> </note> 第二个例子中使用了 date 元素：<note> <date>08/08/2008</date> <to>George</to> <from>John</from> <heading>Reminder</heading> <body>Don't forget the meeting!</body> </note> 第三个例子中使用了扩展的 date 元素（这是我的最爱）：<note> <date> <day>08</day> <month>08</month> <year>2008</year> </date> <to>George</to> <from>John</from> <heading>Reminder</heading> <body>Don't forget the meeting!</body> </note>避免 XML 属性？因使用属性而引起的一些问题：属性无法包含多重的值（元素可以）属性无法描述树结构（元素可以）属性不易扩展（为未来的变化）属性难以阅读和维护请尽量使用元素来描述数据。而仅仅使用属性来提供与数据无关的信息。不要做这样的蠢事（这不是 XML 应该被使用的方式）：<note day="08" month="08" year="2008" to="George" from="John" heading="Reminder" body="Don't forget the meeting!"> </note>针对元数据的 XML 属性有时候会向元素分配 ID 引用。这些 ID 索引可用于标识 XML 元素，它起作用的方式与 HTML 中 ID 属性是一样的。这个例子向我们演示了这种情况：<messages> <note id="501"> <to>George</to> <from>John</from> <heading>Reminder</heading> <body>Don't forget the meeting!</body> </note> <note id="502"> <to>John</to> <from>George</from> <heading>Re: Reminder</heading> <body>I will not</body> </note> </messages>上面的 ID 仅仅是一个标识符，用于标识不同的便签。它并不是便签数据的组成部分。在此我们极力向您传递的理念是：元数据（有关数据的数据）应当存储为属性，而数据本身应当存储为元素。┄┄┄┄XML验证拥有正确语法的 XML 被称为“形式良好”的 XML。通过 DTD 验证的 XML 是“合法”的 XML。形式良好的 XML 文档“形式良好”或“结构良好”的 XML 文档拥有正确的语法。“形式良好”（Well Formed）的 XML 文档会遵守前几章介绍过的 XML 语法规则：XML 文档必须有根元素XML 文档必须有关闭标签XML 标签对大小写敏感XML 元素必须被正确的嵌套XML 属性必须加引号<?xml version="1.0" encoding="ISO-8859-1"?> <note> <to>George</to> <from>John</from> <heading>Reminder</heading> <body>Don't forget the meeting!</body> </note>验证 XML 文档合法的 XML 文档是“形式良好”的 XML 文档，同样遵守文档类型定义 (DTD) 的语法规则：<?xml version="1.0" encoding="ISO-8859-1"?> <!DOCTYPE note SYSTEM "Note.dtd"> <note> <to>George</to> <from>John</from> <heading>Reminder</heading> <body>Don't forget the meeting!</body> </note>在上例中，DOCTYPE 声明是对外部 DTD 文件的引用。下面的段落展示了这个文件的内容。XML DTDDTD 的作用是定义 XML 文档的结构。它使用一系列合法的元素来定义文档结构：<!DOCTYPE note [ <!ELEMENT note (to,from,heading,body)> <!ELEMENT to (#PCDATA)> <!ELEMENT from (#PCDATA)> <!ELEMENT heading (#PCDATA)> <!ELEMENT body (#PCDATA)> ]> XML SchemaW3C 支持一种基于 XML 的 DTD 代替者，它名为 XML Schema：<xs:element name="note"><xs:complexType> <xs:sequence> <xs:element name="to" type="xs:string"/> <xs:element name="from" type="xs:string"/> <xs:element name="heading" type="xs:string"/> <xs:element name="body" type="xs:string"/> </xs:sequence> </xs:complexType></xs:element> 一个通用的验证器为了帮助您检查 XML 文件的语法，我们创建了这个工具，以便您对任何 XML 文件进行语法检查。请看下一节。┄┄┄┄XML验证器XML 错误会终止您的程序XML 文档中的错误会终止你的 XML 程序。W3C 的 XML 规范声明：如果 XML 文档存在错误，那么程序就不应当继续处理这个文档。理由是，XML 软件应当轻巧，快速，具有良好的兼容性。如果使用 HTML，创建包含大量错误的文档是有可能的（比如你忘记了结束标签）。其中一个主要的原因是 HTML 浏览器相当臃肿，兼容性也很差，并且它们有自己的方式来确定当发现错误时文档应该显示为什么样子。使用 XML 时，这种情况不应当存在。对您的 XML 进行语法检查为了帮助您对 XML 进行语法检查，我们创建了一个 XML 验证器。把您的 XML 粘贴到下面的文本框中，然后点击"验证"按钮来进行语法检查。验证对您的 XML 文件进行语法检查您可以通过把 XML 文件的 URL 键入下面的输入框中，然后点击"验证"按钮，来对某个在线的 XML 文件进行语法检查：文件名:验证注释：如果返回的的错误是"拒绝访问"，说明您的浏览器安全设置不允许跨域的文件访问。文件 "note_error.xml" 的作用是演示浏览器的错误处理，如果需要返回无错的消息，可以将该文件替换为其他文件，比如 "books.xml"。根据 DTD 来验证 XML只要把 DOCTYPE 声明添加到您的 XML 中，然后点击验证按钮即可：验证注释：只有在 Internet Explorer 中，可以根据 DTD 来验证 XML。Firefox, Mozilla, Netscape 以及 Opera 做不到这一点。┄┄┄┄XML浏览器几乎所有的主流浏览器均支持 XML 和 XSLT。Mozilla Firefox从 1.0.2 版本开始，Firefox 就已开始支持 XML 和 XSLT（包括 CSS）。MozillaMozilla 含有用于 XML 解析的 Expat，并支持显示 XML + CSS。Mozilla 同时拥有对 Namespaces 的某些支持。Mozilla 同样可做到对 XSLT 的执行（XSLT implementation）。Netscape自从版本 8 开始，Netscape 开始使用 Mozilla 的引擎，因此它对 XML / XSLT 的支持与 Mozilla 是相同的。Opera自从版本 9 开始，Opera 已经拥有对 XML / XSLT（以及 CSS）的支持。版本 8 仅支持 XML + CSS。Internet Explorer自从版本 6 开始，Internet Explorer 就开始支持 XML、Namespaces、CSS、XSLT 以及 XPath。注释：Internet Explorer 5 同样拥有对 XML 的支持，但是 XSL 部分与 W3C 的官方标准不兼容！┄┄┄┄XML查看在所有现代浏览器中，均能够查看原始的 XML 文件。不要指望 XML 文件会直接显示为 HTML 页面。查看 XML 文件查看这个 XML 文件：note.xml打开 XML 文件 - XML 文档将显示为代码颜色化的根以及子元素。通过点击元素左侧的加号或减号，可以展开或收起元素的结构。如需查看不带有 + 和 - 符号的源代码，请从浏览器菜单中选择“查看源代码”。注释：在 Netscape, Opera 以及 Safari 中，仅仅会显示元素文本！要查看原始的 XML，请右击页面，然后选择“查看源代码”。查看某个无效的 XML 文件如果浏览器打开了某个有错误的 XML 文件，那么它会报告这个错误。请查看这个 XML 文件：note_error.xml其他的 XML 实例请查看这些 XML 文档，这会有助于您建立对 XML 的感性认识。一个 XML 的 CD 目录这是我父亲的 CD 收藏，被存储为 XML 数据（我猜可能是很老很无聊的题目... :-)）一个 XML 的植物目录来自园艺店的植物目录，存储为 XML 数据。一个简单的菜单这是来自餐馆的早餐菜单，存储为 XML 数据。为什么 XML 会这样显示？XML 文档不会携带有关如何显示数据的信息。由于 XML 标签由 XML 文档的作者“发明”，浏览器无法确定像 <table> 这样一个标签究竟描述一个 HTML 表格还是一个餐桌。在没有任何有关如何显示数据的信息的情况下，大多数的浏览器都会仅仅把 XML 文档显示为源代码。在下面的章节，我们会了解几个有关这个显示问题的解决方案，其中会使用 CSS、XSL、JavaScript 以及 XML 数据岛。┄┄┄┄XML CSS通过使用 CSS，可为 XML 文档添加显示信息。使用 CSS 显示您的 XML？使用 CSS 来格式化 XML 文档是有可能的。下面的例子就是关于如何使用 CSS 样式表来格式化 XML 文档：这是 XML 文件：CD 目录这是样式表：CSS 文件最后，请查看效果：由 CSS 文件格式化的 CD 目录下面是此XML文件的一个片断。 第二行，<?xml-stylesheet type="text/css" href="cd_catalog.css"?>，把这个 XML 文件链接到 CSS 文件：<?xml version="1.0" encoding="ISO-8859-1"?> <?xml-stylesheet type="text/css" href="cd_catalog.css"?> <CATALOG> <CD> <TITLE>Empire Burlesque</TITLE> <ARTIST>Bob Dylan</ARTIST> <COUNTRY>USA</COUNTRY> <COMPANY>Columbia</COMPANY> <PRICE>10.90</PRICE> <YEAR>1985</YEAR> </CD> <CD> <TITLE>Hide your heart</TITLE> <ARTIST>Bonnie Tyler</ARTIST> <COUNTRY>UK</COUNTRY> <COMPANY>CBS Records</COMPANY> <PRICE>9.90</PRICE> <YEAR>1988</YEAR> </CD></CATALOG>注释：使用 CSS 格式化 XML 不是常用的方法，更不能代表 XML 文档样式化的未来。W3C 推荐使用 XSLT。┄┄┄┄XML XSLT通过使用 XSLT，您可以向 XML 文档添加显示信息。使用 XSLT 显示 XMLXSLT 是首选的 XML 样式表语言。XSLT (eXtensible Stylesheet Language Transformations) 远比 CSS 更加完善。使用 XSLT 的方法之一是在浏览器显示 XML 文件之前，先把它转换为 HTML，正如以下的这些例子演示的那样：查看 XML 文件，XSLT 样式表，查看结果。下面是此 XML 文件的一个片断。 第二行，<?xml-stylesheet type="text/xsl" href="simple.xsl"?>，把这个 XML 文件链接到 XSL 文件：<?xml version="1.0" encoding="ISO-8859-1"?> <?xml-stylesheet type="text/xsl" href="simple.xsl"?> <breakfast_menu> <food> <name>Belgian Waffles</name> <price>$5.95</price> <description> two of our famous Belgian Waffles </description> <calories>650</calories> </food> </breakfast_menu>在服务器上通过 XSLT 转换 XML在上例中，XSLT 转换是由浏览器完成的，浏览器读取的是 XML 文件。在使用 XSLT 来转换 XML 时，不同的浏览器可能会产生不同结果。为了减少这种问题，可以在服务器上进行 XSLT 转换。查看结果请注意，不论转换由服务器还是由浏览器进行，输出结果完成相同。┄┄┄┄XML注意事项本节列出了您在使用 XML 时应该尽量避免使用的技术。Internet Explorer - XML 数据岛它是什么？XML 数据岛（XML Data Islands）是嵌入 HTML 页面中的 XML 数据。为什么要避免使用它？XML 数据岛只在 Internet Explorer 浏览器中有效。用什么代替它？您应当在 HTML 中使用 JavaScript 和 XML DOM 来解析并显示 XML。如需更多有关 JavaScript 和 XML DOM 的信息，请访问 w3school 的 XML DOM 教程。XML 数据岛实例本例使用 XML 文档 "cd_catalog.xml"。把 XML 文档绑定到 HTML 文档中的一个 <xml> 标签。id 属性定义数据岛的标识符，而 src 属性指向 XML 文件： <html> <body> <xml id="cdcat" src="cd_catalog.xml"></xml> <table border="1" datasrc="#cdcat"> <tr> <td><span datafld="ARTIST"></span></td> <td><span datafld="TITLE"></span></td> </tr> </table> </body> </html><table> 标签的 datasrc 属性把 HTML 表格绑定到 XML 数据岛。<span> 标签允许 datafld 属性引用要显示的 XML 元素。在这个例子中，要引用的是 "ARTIST" 和 "TITLE"。当读取 XML 时，会为每个 <CD> 元素创建相应的表格行。如果您正在使用 Internet Explorer，可以亲自试一试。Internet Explorer - 行为它是什么？Internet Explorer 5 引入了行为（behaviors）。Behaviors 是通过使用 CSS 样式向 XML （或 HTML ）元素添加行为的一种方法。为什么要避免使用它？只有 Internet Explorer 支持 behavior 属性。使用什么代替它？使用 JavaScript 和 XML DOM （或 HTML DOM）来代替它。实例例子 1 - Mouseover Highlight下面的 HTML 文件中的 <style> 元素为 <h1> 元素定义了一个行为：<html> <head> <style type="text/css"> h1 { behavior: url(behave.htc) } </style> </head> <body> <h1>Mouse over me!!!</h1> </body> </html>以下是 XML 文档 "behave.htc"：<attach for="element" event="onmouseover" handler="hig_lite" /> <attach for="element" event="onmouseout" handler="low_lite" /> <script type="text/javascript"> function hig_lite() { element.style.color='red'; } function low_lite() { element.style.color='blue'; } </script>这个 behavior 文件包含了一段 JavaScript，以及针对元素的事件句柄。亲自试一试 （请把鼠标移到例子中的文本上）（请在 IE 浏览器中测试本例）。例子 2 - 打字机模拟下面的 HTML 文件中的 <style> 元素为 id 为 "typing" 的元素定义了一个行为：<html> <head> <style type="text/css"> #typing { behavior:url(typing.htc); font-family:'courier new'; } </style> </head> <body> <span id="typing" speed="100">IE5 introduced DHTML behaviors. Behaviors are a way to add DHTML functionality to HTML elements with the ease of CSS.<br /><br />How do behaviors work?<br /> By using XML we can link behaviors to any element in a web page and manipulate that element.</p> </span> </body> </html>以下是 XML 文档 "typing.htc"：<attach for="window" event="onload" handler="beginTyping" /> <method name="type" /> <script type="text/javascript"> var i,text1,text2,textLength,t; function beginTyping() { i=0; text1=element.innerText; textLength=text1.length; element.innerText=""; text2=""; t=window.setInterval(element.id+".type()",speed); } function type() { text2=text2+text1.substring(i,i+1); element.innerText=text2; i=i+1; if (i==textLength) { clearInterval(t); } } </script>┄┄┄┄XML数据存储通常，我们在数据库中存储数据。不过，如果希望数据的可移植性更强，我们可以把数据存储 XML 文件中。创建并保存 XML 文件如果数据要被传送到非 Windows 平台上的应用程序，那么把数据保存在 XML 文件中是有好处的。请记住，XML 有很强的跨平台可移植性，并且数据无需转换！首先，我们将学习如何创建并保存一个 XML 文件。下面的这个 XML 文件将被命名为 "test.xml"，并被保存在服务器上的 c 目录中。我们将使用 ASP 和微软的 XMLDOM 对象来创建并保存这个 XML 文件：<%Dim xmlDoc, rootEl, child1, child2, p'创建XML文档Set xmlDoc = Server.CreateObject("Microsoft.XMLDOM")'创建根元素并将之加入文档Set rootEl = xmlDoc.createElement("root")xmlDoc.appendChild rootEl'创建并加入子元素Set child1 = xmlDoc.createElement("child1")Set child2 = xmlDoc.createElement("child2")rootEl.appendChild child1rootEl.appendChild child2'创建 XML processing instruction'并把它加到根元素之前Set p=xmlDoc.createProcessingInstruction("xml","version='1.0'")xmlDoc.insertBefore p,xmlDoc.childNodes(0)把文件保存到 C 目录xmlDoc.Save "c:\test.xml"%>如果您打开这个被保存的文件，它会使这个样子 ("test.xml")：<?xml version="1.0"?> <root> <child1 /> <child2 /> </root>真实的表单例子现在，我们看一个真实的表单例子。我们首先看一下这个被用在例子中的 HTML 表单：下面的HTML表单要求用户输入他们的名字、国籍以及电子邮件地址。随后这些信息会被写到一个 XML 文件，以便存储。"customers.htm": <html> <body> <form action="saveForm.asp" method="post"> <h1>请输入您的联系信息：</h1> <label>名字: </label> <p><input type="text" id="firstName" name="firstName"></p> <label>姓氏: </label> <p><input type="text" id="lastName" name="lastName"></p> <label>国家: </label> <p><input type="text" id="country" name="country"></p> <label>邮件: </label> <p><input type="text" id="email" name="email"></p> <p> <input type="submit" id="btn_sub" name="btn_sub" value="Submit"> <input type="reset" id="btn_res" name="btn_res" value="Reset"> </p> </form> </body> </html>用于以上 HTML 表单的 action 被设置为 "saveForm.asp"。"saveForm.asp" 文件是一个 ASP 页面，可循环遍表单域，并把它们的值存储在一个 XML 文件中：<%dim xmlDocdim rootEl,fieldName,fieldValue,attIDdim p,i如果有错误发生，不允许程序终止On Error Resume NextSet xmlDoc = server.CreateObject("Microsoft.XMLDOM")xmlDoc.preserveWhiteSpace=true创建并向文档添加根元素Set rootEl = xmlDoc.createElement("customer")xmlDoc.appendChild rootEl循环遍历 Form 集 for i = 1 To Request.Form.Count 除去表单中的 button 元素 if instr(1,Request.Form.Key(i),"btn_")=0 then 创建 field 和 value 元素，以及 id 属性 Set fieldName = xmlDoc.createElement("field") Set fieldValue = xmlDoc.createElement("value") Set attID = xmlDoc.createAttribute("id") 把当前表单域的名称设置为 id 属性的值 attID.Text = Request.Form.Key(i) 把 id 属性添加到 field 元素 fieldName.setAttributeNode attID 把当前表单域的值设置为 value 元素的值 fieldValue.Text = Request.Form(i) 将 field 元素作为根元素的子元素进行添加 rootEl.appendChild fieldName 将 value 元素作为 field 元素的子元素进行添加 fieldName.appendChild fieldValue end if next添加 XML processing instruction并把它加到根元素之前Set p = xmlDoc.createProcessingInstruction("xml","version=1.0")xmlDoc.insertBefore p,xmlDoc.childNodes(0)保存 XML 文件xmlDoc.save "c:\Customer.xml"释放所有的对象引用set xmlDoc=nothingset rootEl=nothingset fieldName=nothingset fieldValue=nothingset attID=nothingset p=nothing测试是否有错误发生if err.number<>0 then response.write("Error: No information saved.")else response.write("Your information has been saved.")end if%>注释：如果指定的 XML 文件名已经存在，那个文件会被覆盖！XML 文件会由上面的代码生成，大致的样子是这样的：("Customer.xml"):<?xml version="1.0" ?> <customer> <field id="firstName"> <value>David</value> </field> <field id="lastName"> <value>Smith</value> </field> <field id="country"> <value>China</value> </field> <field id="email"> value>mymail@myaddress.com</value> /field> </customer>┄┄┄┄XML编码XML 文档可以包含非 ASCII 字符，比如法语。为了避免错误，需要规定 XML 编码，或者将 XML 文档存为 Unicode。Windows 记事本Windows 记事本默认会将文件保存为单字节的 ANSI (ASCII)。如果选取文件菜单中的“另存为”命令，就可以规定双字节 Unicode (UTF-16)。将下面的 XML 文件保存为 Unicode （注意文档不包含任何 encoding 属性）：<?xml version="1.0"?> <note> <from>John</from> <to>George</to> <message>French: êèé</message> </note>上面的文件，note_encode_none_u.xml 不会出错。但是如果规定了单字节编码就会出错。下面的编码（打开它），不会报错：<?xml version="1.0" encoding="windows-1252"?>下面的编码（打开它），不会报错：<?xml version="1.0" encoding="ISO-8859-1"?>下面的编码（打开它），不会报错：<?xml version="1.0" encoding="UTF-8"?>下面的编码（打开它），不会报错：<?xml version="1.0" encoding="UTF-16"?>错误消息如果您试图向 IE 中载入 XML 文档，可能会得到两种指示编码问题的错误：在文本内容中发现非法字符如果 XML 文档中的某个字符与编码属性不匹配，您就会得到这个错误消息。通常，当 XML 文件中含有外国字符，且当文件使用类似记事本的单字节编码编辑器保存，以及没有指定编码属性时，您就会得到这个错误消息。将当前编码切换为不被支持的指定编码如果您的文件被保存为 Unicode/UTF-16，但是编码属性被指定为单字节编码（比如 Windows-1252、ISO-8859-1 或者 UTF-8）时，那么您就会得到这个错误消息。或者当您的文档被保存为单字节编码，但编码属性被指定为双字节编码（比如 UTF-16）时，也会得到这个错误消息。结论结论是：编码属性应当被指定为文档被保存时所使用的编码。我最好的避免错误的建议是：使用支持编码的编辑器确定编辑器使用的编码在您的 XML 文档中使用相同的编码属性