页面的注释

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了页面的注释相关的知识,希望对你有一定的参考价值。

在网页中,除了以上这些基本标签外,还包含一种不显示在页面中的元素,那就是代码的注释文字。适当的注释可以帮助用户更好地了解网页中各个模块的划分,也有助于以后对代码的检查和修改。给代码加注释,是一种很好的编程习惯。在html5文档中,注释分为三类:在文件开始标签<html></html>中的注释、在CSS层叠样式表中的注释和在JavaScirpt中的注释,JavaScirpt中的注释有两种形式。下面将对这三类注释的具体语法进行介绍
在文件开始标签<html></html>中的注释,具体语法如下:

<!--注释的文字-->

注释文字的标记很简单,只需要在语法中“注释的文字”的位置上添加需要的内容即可。
在CSS层叠样式表中的注释,具体语法如下:

/*注释的文字*/

在CSS样式中注释时,只需要在语法中“注释的文字”的位置上添加需要的内容即可。
说明:在javascript脚本语言中的注释有两种形式:单行注释和多行注释。
单行注释的具体语法如下:

//注释的文字

注释文字的标记很简单,只需要在语法中“注释的文字”的位置上添加需要的内容即可。
注意:在JavaScript中添加单行注释时,只需要在语法中“注释的文字”的位置上添加需要的内容即可。
多行注释的具体语法如下:

/*注释的文字*/

在JavaScript脚本中进行多行注释时,只需要在语法中“注释的文字”的位置上添加需要的内容即可。
注意:在JavaScript中添加多行注释时或单行注释的形式不是一成不变的,在进行多行注释时,单行注释也是有效的。运用“//注释的文字”对每一行文字进行注释达到的效果和“/注释的文字/”的效果一样。
常见错误:在HTML代码中,注释语法使用错误时,浏览器将注释视为文本内容,注释内容会显示在页面中。有时还会造成页面结构错乱等情况。例如,在谷歌浏览器上运行一个HTML5文件,下面给出该网页的关键代码:

01  <!--在这里注释可以吗?不可以!-->
02  <!DOCTYPE html>
03  <html>
04  <head>
05  <!--meta元素提供的信息是用户不可见的,它不显示在页面中,一般用来定义页面信息的名称、关键字、作者等。而在一个HTML头页面中可以有多个meta元素。meta元素的属性有两种:name和http-equiv-->
06  <meta charset="utf-8" />
07  <!--编码方式-->
08  <title><!--头部标签中不能加注释-->吉林省明日科技有限公司</title>
09  <link href="css/style.css" rel="stylesheet" type="text/css" />
10  <!--引入CSS外部样式表-->
11  <style type="text/css"  >
12  /* 在CSS中注释*/
13      /* 外层div.cen*/
14  .cen{
15        CLEAR: both;   /*清除浮动*/
16  MARGIN: 0px auto;
17        WIDTH: 947px;
18        TEXT-ALIGN: left;    /*水平对齐方式*/
19  border-left: solid 1px #D0D0D0;  /*左边框样式:宽度为1px,实线灰色框*/
20  border-right: solid 1px #D0D0D0;
21        padding: 0px 15px;
22      }
23      .err-animation {  /*‘.‘表示类样式,err-animation为样式名*/
24  color: red;
25        font-size: 24px;  /*字体*/
26  font-family: fantasy;  /*字体风格*/
27  animation-direction: alternate;   /*动画的路径*/
28  animation-fill-mode: both;
29        animation-duration: 4.75s;  /*动画持续时间*/
30  animation-iteration-count: infinite;  /*循环次数*/
31  animation-name: animations;  /*动画名*/
32  animation-play-state: running;  /*动画的状态*/
33  animation-timing-function: ease;  /*运动的速度*/
34  animation-delay: 0.15s   /*动画延时时间*/
35  }
36  </style>
37  </head>
38  <body>
39  <!--页面开始div.cen     start-->
40  <div class="cen">
41  <!--在HTML中注释语法错误的示例:-->
42  <h4 class="err-animation" style="color:red;font-family:fantasy;">注释错误 1:写在<span><</span><span>!DOCTYPE></span>标签之前</h4>
43  <h4 class="err-animation" style="   ‘内部样式中不可以注释! ‘   color: blue;font-style: oblique;font-family: -webkit-pictograph;color: maroon;">注释错误 2:注释语法不对!</h4>
44  <p>/* 明日学院网址:www.mingrisoft.com */</p>
45  
46  <!--  跳转的页面top.html    start-->
47  <div>
48  <iframeframeborder="0" height="240" id="top" name="top" scrolling="No" src="inc/top.html" width="947"></iframe>
49  <!--  跳转的页面top.html     end-->
50  </div>
51  <h4 style="color:blue;font-size: 24px;font-family:fantasy" class="err-animation">注释错误 3:注释标签没写完整</h4>
52  <p><--   明日学院网址,我来注释一下好了,哒哒哒。。。--></p>
53  <!-- 第二部分只是一张jpg图片  start-->
54  <div><imgsrc="img/o_02.jpg" width="947" height="84" /></div>
55  </body>
56  </html>
57  <!--在html 后面注释也OK-->

用谷歌浏览器打开这个完整的HTML5文件,出现如图1.4所示的显示效果,图1.4中注释了3种注释用错的情况。分别用①②③标注出来了。
技术分享图片
图1.4 HTML中注释的3种常见错误

以上是关于页面的注释的主要内容,如果未能解决你的问题,请参考以下文章

导致资产预编译在heroku部署上失败的代码片段

需要一种有效的方法来避免使用 Laravel 5 重复代码片段

vscode 用户代码片段 vue初始化模板 Snippet #新加入开头注释 自动生成文件名 开发日期时间等内容

JSP 设计教师与学生不同登陆界面(带验证码)

phpstorm 实用快捷键 和 注释

asp.net页面实用代码片段