您好,登錄后才能下訂單哦!
今天就跟大家聊聊有關前端開發代碼如何注釋,可能很多人都不太了解,為了讓大家更加了解,小編給大家總結了以下內容,希望大家根據這篇文章可以有所收獲。
一、代碼注釋有什么用
1、和偽代碼一樣的作用,為接下來要實現的功能寫出一個指導性的算法思路。只是沒有偽代碼詳細。但是也指出了完成此功能的大體算法思路。
2、給看代碼的人一個解釋性說明。注意看代碼的人包括你自己。讓看你代碼的人可以快速的瀏覽你的代碼,不至于每看一行都要一行一行的看下去,才能明白你寫的什么。
二、代碼注釋規范,遵循以下原則
1、能夠幫助讀者更好的了解代碼邏輯與結構
2、特別的或不容易理解的寫法可以解釋說明
3、特殊標記注釋:如 TODO、FIXME 等有特殊含義的標記
4、文件注釋:部分規定會要求在文件頭部書寫固定格式的注釋,如注明作者、協議等信息
5、文檔類注釋:部分規定要求 API類、函數等使用文檔類注釋(如 jsdoc 風格)
6、遵循統一的風格規范,如一定的空格、空行,以保證注釋自身的可讀性
三、代碼注釋怎么寫
1、HTML代碼注釋:<!--注釋內容 -->;
<!-- html中要注釋的內容 --> 在web頁面中,最常見的注釋就是這種了。我們在布局頁面結構的時候,會添加少許的注釋方便我們查找與記憶我們的想法。 那么在頁面中除了這樣的注釋外,還有那些注釋呢,這里我列舉一些: If條件不同版本瀏覽器注釋列表: <!--[if !IE]>除IE外都可識別<![endif]--> <!--[if IE]> 所有的IE可識別 <![endif]--> <!--[if gt IE 5.0]> IE5.0以及IE5.0以上版本都可以識別 <![endif]--> <!--[if IE 6]> 僅IE6可識別 <![endif]--> <!--[if lt IE 6]> IE6以及IE6以下版本可識別 <![endif]--> <!--[if gte IE 6]> IE6以及IE6以上版本可識別 <![endif]--> <!--[if IE 7]> 僅IE7可識別 <![endif]--> <!--[if lt IE 7]> IE7以及IE7以下版本可識別 <![endif]--> <!--[if gte IE 7]> IE7以及IE7以上版本可識別 <![endif]-->
2、CSS代碼注釋 : /* 注釋內容*/
與html中的注釋形式不同,css中的注釋采取的是/*css中的注釋*/的形式。注釋的內容沒有單行多行之分。
/*.aa,.bb { height: 100px; margin: 1px; background: #ccc; }*/
3、JS代碼注釋 : //注 釋內容; 或者/* 注釋內容 */,
與html\css不同的是,js中的注釋存在單行多行的區分,也是種類比較繁多下面就一一介紹。
(1) // 兩個斜杠表示單行注釋。
(2) <!-- 或者 <!-- --> 使用<!--或者<!-- --> 作為單行注釋.
(3)/* */ 多行注釋
// function out(obj){ // obj.innerHTML = "移出了"; // obj.style.background = "#ccc"; // }
看完上述內容,你們對前端開發代碼如何注釋有進一步的了解嗎?如果還想了解更多知識或者相關內容,請關注億速云行業資訊頻道,感謝大家的支持。
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。