争怎路由网:是一个主要分享无线路由器安装设置经验的网站,汇总WiFi常见问题的解决方法。

深入理解JS代码注释方法及代码注释规范

时间:2024/5/28作者:未知来源:争怎路由网人气:

网页的本质就是超级文本标记语言,通过结合使用其他的Web技术(如:脚本语言、公共网关接口、组件等),可以创造出功能强大的网页。因而,超级文本标记语言是万维网(Web)编程的基础,也就是说万维网是建立在超文本基础之上的。超级文本标记语言之所以称为超文本标记语言,是因为文本中包含了所谓“超级链接”点。
在页面布局时,为了提高代码的可读性,经常需要给代码加注释,这篇文章就和大家聊聊JS怎么注释代码以及JS代码注释的规范,感兴趣的朋友可以参考一下,希望对你有所帮助!

注释是代码必不可少的一部分,一个完整的程序必须要加注释。注释不仅有利于自己更新和修改项目,还有利于其他人拿到你的项目时知道你写的什么。

一、JavaScript代码注释方法

JavaScript不会执行注释里面的代码,JS代码注释分为单行注释和多行注释。

1、单行注释

单行注释以//开头,//后面要加一个空格,然后再写注释的内容,单行注释可用于描述当前代码的作用,解释代码等等。

代码实例:给document.write("字符串是:"+str)代码单行注释,不需要其显示在页面上

<script type="text/javascript">
  function myFunction(){
   var animal = ["dog", "cat", "elephant", "tiger"];
   var str=animal.toString();
   document.write("类型是:"+typeof(str));  
   //document.write("字符串是:"+str)
  }  
 </script>

注释前效果图:

图片5.jpg

注释后效果图:

图片6.jpg

2、多行注释

多行注释以 /* 开始,以 */ 结尾,但是工作中要尽量使用单行注释替代多行注释,即使注释需要多行,也要用单行注释来完成,但是函数的注释还是推荐使用多行注释。

代码实例:

<script>
/*
下面的这些代码会输出
一个标题和一个段落
并将代表主页的开始
*/
document.getElementById("myH1").innerHTML="欢迎来到菜鸟教程";
document.getElementById("myP").innerHTML="这是一个段落。";
</script>

二、JS代码注释的规范

一个好的代码注释要做到,如果没有必要,则不要加注释,如果需要加注释,则写详细,让别人明白你的意思,尽量提高代码的清晰性和可读性。工作中要做到以下几点:

1、在有逻辑的代码中,代码的注释要在20%以上

2、文件注释时,文件注释写入文件的头部

3、类和接口的注释时,注释需要放在class之前,using或package关键字之后

4、遇到类属性、公有和保护方法时,注释需要写在类属性、公有、保护方法上面。即用//注释,需要对齐被注释的代码

5、注释需要放在被注释的代码前面,分行写且中间不要留空行

6、不要在注释中使用缩写,如果要用缩写,需要对缩写进行必要的解释说明

7、成员变量注释内容时,成员变量的意义、目的和功能,可能被用到的地方,用//来注释,需要对齐被注释的代码

总之,每个程序员都应该养成一个写注释的好习惯,不仅方便自己阅读和修改代码,而且还方便别人理解和维护你的代码。

以上介绍了JS代码的注释方法以及JS代码的注释规范,比较简单,容易理解,更多相关教程请访问 JavaScript视频教程

以上就是深入理解JS代码注释方法及代码注释规范的详细内容,更多请关注php中文网其它相关文章!


网站建设是一个广义的术语,涵盖了许多不同的技能和学科中所使用的生产和维护的网站。



关键词:深入理解JS代码注释办法及代码注释规范




Copyright © 2012-2018 争怎路由网(http://www.zhengzen.com) .All Rights Reserved 网站地图 友情链接

免责声明:本站资源均来自互联网收集 如有侵犯到您利益的地方请及时联系管理删除,敬请见谅!

QQ:1006262270   邮箱:kfyvi376850063@126.com   手机版