在实际工作中,有时会出现分不清注释应该在标签之上还是标签之下,为了避免这种情况,注释信息统一写在区域标签开始之前和结束之后,并以S或E开始,表示区域注释的开始或结束。
例:
!--=S 注释内容 --
div
...
/div
!--=E 注释内容 --
(本文来源于图老师网站,更多请访问https://m.tulaoshi.com/webkaifa/)
/*=S 注释内容 */
.class{
...
}
.class{
...
}
/*=E 注释内容 */
单行注释
注释信息应写在需注释的内容区域里
例:
div
!-- 注释内容 --
...
/div
(本文来源于图老师网站,更多请访问https://m.tulaoshi.com/webkaifa/)
.class{
/* 注释内容 */
...
}
注释层级
在模块制作中,可能会出现区域中还有区域的情况,为了更好的区分区域之间的层级,引入了注释层级的概念。
区域注释前面的等号表示了当前注释的层级
例:
!--=S 注释内容 --
...
!--==S 注释内容 --
...
!--===S 注释内容 --
...
!--===E 注释内容 --
...
!--==E 注释内容 --
...
!--=E 注释内容 --
(本文来源于图老师网站,更多请访问https://m.tulaoshi.com/webkaifa/)
/*=S 注释内容 */
...
/*==S 注释内容 */
...
/*===S 注释内容 */
...
/*===E 注释内容 */
...
/*==E 注释内容 */
...
/*=E 注释内容 */
协助注释
非作者维护时所加入的表示修改时间、修改人等标识信息。
在区域注释或单行注释的基础上加上修改人和修改时间等信息。
例(区域注释):
!--==S 注释内容[修改人和修改时间] --
div
...
/div
!--==E 注释内容[修改人和修改时间] --
(本文来源于图老师网站,更多请访问https://m.tulaoshi.com/webkaifa/)
/*=S 注释内容[修改人和修改时间] */
.class{
...
}
.class{
...
}
/*=E 注释内容[修改人和修改时间] */
例(单行注释):
div
!-- 注释内容[修改人和修改时间] --
...
/div
(本文来源于图老师网站,更多请访问https://m.tulaoshi.com/webkaifa/)
.class{
/* 注释内容[修改人和修改时间] */
...
}
须要注意注释标记的开始和结束(特别是样式中的单行注释)时,注释内容跟标记间应该加上空格,避免IE下出现读取不到内容的情况。