详解XML中的代码注释书写方法

所属分类: 网页制作 / XML/XSLT 阅读数: 1626
收藏 0 赞 0 分享

XML 注释与 HTML 注释类似。注释被用来添加说明或者理解某行 XML 代码。

注释可以用来包含相关链接,信息和术语。它们只在源代码中可见,而不是 XML 代码中。注释可以出现在 XML 代码的任何地方。

语法
释以 <!-- 开始并以 --> 结束,例如 <!--catalog last updated 2016-02-14-->。
注释可以出现在文档序言中,包括文档类型定义 (DTD);文档之后;或文本内容中。 注释不能出现在属性值中。 不能出现在标记中。
分析器在遇到 > 时,就认为注释已结束;然后继续将文档作为正常的 XML 处理。 因此,字符串 > 不能出现在注释中。 除了该限制之外,任何合法的 XML 字符均可以出现在注释中,与 CDATA 节非常类似。 这样,可以从分析器看到的输出流中删除 XML 注释,同时又不会删除文档的内容。
以下注释可以用于暂时除去标记。

示例
下面是在 XML 文档中使用注释的一个演示示例:

XML/HTML Code复制内容到剪贴板
  1. <?xml version="1.0" encoding="UTF-8" ?>  
  2. <!---Students grades are uploaded by months---->  
  3. <class_list>  
  4.     <student>  
  5.         <name>Tanmay</name>  
  6.         <grade>A</grade>  
  7.     </student>  
  8. </class_list>  

注意

字符之间的文本都被视为注释。 ## XML 注释规则 下面是 XML 注释需要遵循的规则:
- 注释不能出现在 XML 声明之前。
- 注释可以出现在文档的任何位置。
- 注释不能出现在属性值中。
- 注释不能嵌套在其他注释中。

在 HTML 中,可以使用注释来隐藏脚本和样式表。 若要在 XML 中使用此方法,可能必须检索注释,提取注释的内容,检查是否有标记字符,然后再进行重新分析。 在此例中,CDATA 节是更好的选择。

更多精彩内容其他人还在看

详解XML中的标签与元素的使用

这篇文章主要介绍了XML中的标签与元素的使用,是XML入门学习中的基础知识,需要的朋友可以参考下
收藏 0 赞 0 分享

XML中的属性学习教程

这篇文章主要介绍了XML中的属性学习教程,包括使用属性将数据存储在子元素中的例子,需要的朋友可以参考下
收藏 0 赞 0 分享

详解XML中的代码注释书写方法

这篇文章主要介绍了详解XML中的代码注释书写方法,文章中总结了注释使用的一些注意点,比如XML不支持嵌套注释等,需要的朋友可以参考下
收藏 0 赞 0 分享

深入解析XML中的字符实体与字符数据

这篇文章主要介绍了XML中的字符实体与字符数据,文中所说的CDATA片段即是指字符数据即不由解析器解析的文本块,需要的朋友可以参考下
收藏 0 赞 0 分享

解析XML对代码中的空白处理

这篇文章主要介绍了XML对代码中的空白处理,文中介绍到了XML书写中的有效空白与无效空白的区分,需要的朋友可以参考下
收藏 0 赞 0 分享

简单了解XML中的处理指令

这篇文章主要介绍了XML中的处理指令,处理指令在XML中并不常用,稍作了解即可,需要的朋友可以参考下
收藏 0 赞 0 分享

浅谈XML代码编写的编码与验证问题

这篇文章主要介绍了XML代码编写的编码与验证问题,与HTML类似,XML文件的编码也能在序言部分被指定,需要的朋友可以参考下
收藏 0 赞 0 分享

深入解析XML中的DTD文档类型定义

这篇文章主要介绍了XML中的DTD文档类型定义,是XML入门学习中的基础知识,需要的朋友可以参考下
收藏 0 赞 0 分享

详解XML编程中的模式定义XSD

这篇文章主要介绍了详解XML编程中的模式定义XSD,讲解了如何在XML文档中声明模式及定义类型等内容,需要的朋友可以参考下
收藏 0 赞 0 分享

解析XML中的树形结构与DOM文档对象模型

这篇文章主要介绍了XML中的树形结构与DOM文档对象模型,文中举了JavaScript解析DOM对象的例子,需要的朋友可以参考下
收藏 0 赞 0 分享
查看更多