添加必要的注释,对一个有责任心、有道德模范的前端必须具备的好习惯,可以大大提高代码的可维护性、可读性。
首先熟悉一下html、css、js的注释的写法:
1、HTML注释语法:
<!--注释的内容-->
2、css注释语法
/* 注释内容 */
/* ----------文字样式开始---------- */
/* ----------文字样式开始---------- */
3、javaScript注释
//注释内容
/*注释内容*/
/*注释内容*/
接下来是对注释在这几种代码中使用的位置,如何写注释进行总结一下。(根据个人的习惯可能不一样)
1、html注释
使用的位置:
1)一般会使用在一些主要节点标签结束的后边,如:
<div class="wrap">
<div class="main">
...
</div> <!--main end-->
<div> <!--wrap end-->
<div class="main">
...
</div> <!--main end-->
<div> <!--wrap end-->
2)使用在一些循环的结束的后边,如:
<ul class="list">
<li>111111 </li>
<li>222222 </li>
<li>333333 </li>
</ul> <!--list loop-->
<li>111111 </li>
<li>222222 </li>
<li>333333 </li>
</ul> <!--list loop-->
这一切都是为了程序在嵌套的时候更加方便、明了。方便了他人同时也就方便了自己。程序嵌套的很乱,到时要你去修改那也是一份挺复杂的工序。
2、css注释
一般会使用在定义某个模块样式的上边,说明这段样式是作用于哪段模块,如:
/*通用 - 评论*/
.comment {... }
/*相册*/
.photo {... }
/*分享*/
.share {... }
/*投票*/
.vote {... }
.comment {... }
/*相册*/
.photo {... }
/*分享*/
.share {... }
/*投票*/
.vote {... }
3、javascript注释
一般将注释添加在某段功能函数的上边,说明函数的功能、作者、作者信息、修改时间。
//========================================================
// 截断字符
// steepvi
// rtx:*******
// 2010-10-14
//========================================================
// 截断字符
// steepvi
// rtx:*******
// 2010-10-14
//========================================================
最后,注释也是字符也是会有流量产生。因此当页面发布到正式地址的时候,最好加上一步优化流程。
压缩过程为非逆过程,保证本地是最新的而且带有注释的文件,压缩后上传服务器。服务器端的文件不可用作本地调试用。