HTML 文件的注釋
HTML 注釋標(biāo)簽是在 HTML 源代碼中添加說明/注釋,使用該標(biāo)簽注釋的內(nèi)容將不在瀏覽器中顯示。
邊寫代碼邊寫注釋是一個好習(xí)慣,特別是代碼量很大的時候,如果不寫注釋,你寫完倒回去看可能都不知道自己寫的什么了。
如果是團(tuán)隊(duì)合作,就更應(yīng)該寫注釋了,如果不寫每人知道你寫的什么,還需要從頭到尾仔細(xì)看一遍。
團(tuán)隊(duì)可以自行約定注釋標(biāo)準(zhǔn)及規(guī)范,例如:
- 所有的注釋寫在內(nèi)容上方;
- 如果有多句注釋,每一句注釋直接換行;
- 如果是方法注釋,寫明方法作用和每個參數(shù)介紹;
- 注釋的語句簡單明了;
- 每個變量和方法標(biāo)注作用。
1. 什么是注釋
注釋指解釋字句的文字,也指用文字解釋字句。當(dāng)我們需要給代碼做批注,我們就需要注釋代碼。
注釋是我們提高代碼可讀性,代碼可維護(hù)性最簡單有效的方式,往往多寫幾個字,會給我們?nèi)蘸蟮木S護(hù),減少很大的難度。
2. 注釋的作用
代碼注釋不僅方便程序員自己回憶起以前代碼的用途,還可以幫助其他程序員很快的讀懂你的程序的功能,方便多人合作開發(fā)網(wǎng)頁代碼。
3. 如何在 HTML 文件中書寫注釋
在 HTML
文件中, 我們將注釋寫在<!-- -->
中,注釋只是起解釋作用,并不會在頁面上顯示出來。
我們?nèi)绻褂镁庉嬈骶帉懘a,如 VSCode, WebStorm 等,那么在編輯器書寫注釋的快捷方式為 ctrl
+ /
, 我們只需要先寫注釋內(nèi)容, 然后在選中注釋內(nèi)容,按 ctrl
+ /
即可。
4. 經(jīng)驗(yàn)分享
1. 注釋可以寫在 HTML 文件的任意位置。
<!DOCTYPE HTML>
<HTML lang="en">
<head>
<meta charset="UTF-8">
<!-- HTML注釋可以在head標(biāo)簽中 -->
<title>HTML注釋</title>
</head>
<body>
<!-- HTML注釋也可以在body標(biāo)簽中 -->
<h1>我是一個大標(biāo)題</h1> <!-- HTML注釋也可以在標(biāo)簽后面 -->
</body>
</HTML>
2. 注釋內(nèi)容必須寫在<!-- -->
中,否則不會生效。
<!DOCTYPE HTML>
<HTML lang="en">
<head>
<meta charset="UTF-8">
<title>HTML注釋</title>
</head>
<body>
<!-- --> HTML注釋也可以在body標(biāo)簽中(此段內(nèi)容沒有在<!-- -->中,則不為注釋,而是頁面上的內(nèi)容)
<h1>我是一個大標(biāo)題</h1> <!-- 只有寫在規(guī)定位置,才是注釋 -->
</body>
</HTML>
3. 注釋的內(nèi)容只是解釋,并不會實(shí)際的顯示在頁面上。
<!DOCTYPE HTML>
<HTML lang="en">
<head>
<meta charset="UTF-8">
<title>HTML注釋</title>
</head>
<body>
<!-- 注釋的內(nèi)容不會顯示在頁面上-->
<h1>我是一個大標(biāo)題</h1>
</body>
</HTML>
4. 編寫代碼時,盡量把注釋寫的簡單明了,通俗易懂,不僅方便自己維護(hù)代碼,也方便與他人的協(xié)同開發(fā)。
<!DOCTYPE HTML>
<HTML lang="en">
<head>
<meta charset="UTF-8">
<title>HTML注釋</title>
</head>
<body>
<!-- 這是頭部 -->
<header></header>
<!-- 這是大標(biāo)題-->
<h1>我是一個大標(biāo)題</h1>
</body>
</HTML>
5. 注釋標(biāo)簽可以自定義內(nèi)容,也可以注釋已寫的HTML標(biāo)簽。
<!DOCTYPE HTML>
<HTML lang="en">
<head>
<meta charset="UTF-8">
<title>HTML注釋</title>
</head>
<body>
<!-- 自定義注釋內(nèi)容 -->
<p>這是一段話</p>
<!-- 注釋HTML標(biāo)簽, 則該標(biāo)簽也不會在頁面上顯示 -->
<!-- <h1>我是一個大標(biāo)題</h1> -->
</body>
</HTML>
6. 開發(fā)人員一定要養(yǎng)成書寫注釋的好習(xí)慣。
5. 真實(shí)案例分享
簡書官網(wǎng)
<!-- 正常登錄登錄名輸入框 -->
<div >
<input placeholder="手機(jī)號或郵箱" type="text" />
</div>
<!-- 海外登錄登錄名輸入框 -->
<div >
<input placeholder="密碼" type="password" />
</div>
6. 小結(jié)
- 注釋只是起一個批注解釋作用,并不會在頁面上產(chǎn)生實(shí)際的內(nèi)容。
- HTML文件中注釋寫在
<!-- -->
中。