html、css和js註釋的規範用法

成爲專業的前端工程師!!!javascript

html註釋:php

<!--註釋內容-->

css註釋:css

//註釋內容 單行註釋(不推薦使用,由於有的瀏覽器可能不兼容,沒有效果)
/*註釋內容*/ 多行註釋(推薦使用)

JavaScript:html

//註釋內容 單行註釋
/*註釋內容*/ 多行註釋

總結:前端

//註釋內容 (在css或javascript中插入單行註釋)
/*註釋內容*/ (在css或javascript中插入多行註釋)java

接下來是對註釋在這幾種代碼中使用的位置,如何寫註釋進行總結一下。(根據我的的習慣可能不同)瀏覽器

一、html註釋服務器

使用的位置:前端工程師

1)通常會使用在一些主要節點標籤結束的後邊,如:函數

 

1
2
3
4
5
< p  class = "wrap" >
< p  class = "main" >
...
</ p > <!--main end-->
< p > <!--wrap end-->

 

2)使用在一些循環的結束的後邊,如:

 

1
2
3
4
5
< ul  class = "list" >
     < li >111111</ li >
     < li >222222</ li >
     < li >333333</ li >
</ ul > <!--list loop-->

 

這一切都是爲了程序在嵌套的時候更加方便、明瞭。方便了他人同時也就方便了本身。程序嵌套的很亂,到時要你去修改那也是一份挺複雜的工序。

二、css註釋

通常會使用在定義某個模塊樣式的上邊,說明這段樣式是做用於哪段模塊,如:

 

1
2
3
4
5
6
7
8
/*通用 - 評論*/
.comment{...}
/*相冊*/
.photo{...}
/*分享*/
.share{...}
/*投票*/
.vote{...}

 

三、javascript註釋

通常將註釋添加在某段功能函數的上邊,說明函數的功能、做者、做者信息、修改時間。

 

 

1
2
3
4
5
6
//========================================================
//      截斷字符
//      steepvi
//      rtx:*******
//      2010-10-14
//========================================================

 

最後,註釋也是字符也是會有流量產生。所以當頁面發佈到正式地址的時候,最好加上一步優化流程。

壓縮過程爲非逆過程,保證本地是最新的並且帶有註釋的文件,壓縮後上傳服務器。服務器端的文件不可用做本地調試用。

相關文章
相關標籤/搜索