时间：2015-06-28 00:00 来源：IT猫扑网|http://www.itmop.com/ 作者：网管联盟 我要评论(0)
总结了一下自己工作中使用到的注释书写规范，没有什么技术含量，只是用于统一制作方式，方便维护。包含了&区域注释&、&单行注释&、&注释层级&和&协助注释&四个部分。
大部分同学使用的区域注释的方法，会以&注释内容开始&或&注释内容结束&、&start&或&end&等，相比之下，以&S&或&E&开始可以更快的使用，比如只要写一次开始或结束的注释，然后复制，改下&S&或&E&就可以快速的完成区域的注释。
区域注释
在实际工作中，有时会出现分不清注释应该在标签之上还是标签之下，为了避免这种情况，注释信息统一写在区域标签开始之前和结束之后，并以&S&或&E&开始，表示区域注释的开始或结束。
例：
<!--=S 注释内容-->
<div>
...
</div>
<!--=E 注释内容-->
/*=S 注释内容*/
.class{
...
}
.class{
...
}
/*=E 注释内容*/
单行注释
注释信息应写在需注释的内容区域里
例：
<div>
<!--注释内容-->
...
</div>
.class{
/*注释内容*/
...
}
注释层级
在模块制作中，可能会出现区域中还有区域的情况，为了更好的区分区域之间的层级，引入了注释层级的概念。
区域注释前面的等号表示了当前注释的层级
例：
<!--=S 注释内容-->
...
<!--==S 注释内容-->
...
<!--===S 注释内容-->
...
<!--===E 注释内容-->
...
<!--==E 注释内容-->
...
<!--=E 注释内容-->
/*=S 注释内容*/
...
/*==S 注释内容*/
...
/*===S 注释内容*/
...
/*===E 注释内容*/
...
/*==E 注释内容*/
...
/*=E 注释内容*/
协助注释
非作者维护时所加入的表示修改时间、修改人等标识信息。
在区域注释或单行注释的基础上加上修改人和修改时间等信息。
例(区域注释)：
<!--==S 注释内容[修改人和修改时间]-->
<div>
...
</div>
<!--==E 注释内容[修改人和修改时间]-->
/*=S 注释内容[修改人和修改时间]*/
.class{
...
}
.class{
...
}
/*=E 注释内容[修改人和修改时间]*/
例(单行注释)：
<div>
<!-- 注释内容[修改人和修改时间]-->
...
</div>
.class{
/*注释内容[修改人和修改时间]*/
...
}
关键词标签：书写,规范,注释,代码
相关阅读 网页制作与CSS的UTF-8和GB2312编码问题 网页设计中常用的19个Web安全字体 网页中防止表格被撑破的方法总结 5秒后弹窗代码 网页制作过程中代码注释书写规范 网页中控制图片缩放代码
热门文章
网页设计中常用的19个Web安全字体
UCenter Home防灌水设置详解
人气排行 log4j之配置文件加载过程分析-properties文件和xml文件 提高网页打开速度的一些小技巧 网页制作与CSS的UTF-8和GB2312编码问题 关于iframe内页高度自适应 网页设计中常用的19个Web安全字体 网页设计中的各种分辨率下的标准尺寸 网页设计常用Javascript经典代码 手把手教你制作Google Sitemap 什么是html,xhtml 网页中控制图片缩放代码 大型网站架构不得不考虑的10个问题 UCenter Home防灌水设置详解
查看所有0条评论>>