2.8　HTML網(wǎng)頁(yè)注釋

本節(jié)向讀者介紹HTML網(wǎng)頁(yè)中添加注釋的使用方法。HTML網(wǎng)頁(yè)中被注釋的內(nèi)容是不會(huì)顯示在瀏覽器中的，這樣可以有效地避免頁(yè)面中想隱藏的內(nèi)容也被顯示出來，這就是注釋的功能所在。

在HTML網(wǎng)頁(yè)中使用注釋的優(yōu)點(diǎn)有很多：比如，為代碼添加注釋，既可以方便自己后期修改維護(hù)，也可以方便其他程序員閱讀理解并完善你寫的代碼。又比如：將暫時(shí)不需要執(zhí)行的代碼先注釋起來，這樣以后想重新恢復(fù)代碼時(shí)就很簡(jiǎn)單。當(dāng)然最關(guān)鍵的一點(diǎn)，一段優(yōu)秀的代碼配上合理必要的注釋才算完美，這也是一個(gè)優(yōu)秀程序員所必備的良好習(xí)慣之一。

如果讀者想在HTML網(wǎng)頁(yè)中使用注釋，需要使用“<!-- -->”符號(hào)，并遵循下面的寫法：

下面看一段使用注釋的HTML網(wǎng)頁(yè)代碼（參見源代碼ch02/ch02-html-comment.html文件）。

【代碼2-12】

【代碼解析】

第04行代碼的注釋，說明了下面代碼是用于添加頭部?jī)?nèi)容。

第12行代碼的注釋，說明了下面一段定義CSS樣式的代碼。

第23行、第26行、第29行和第32行代碼后面的CSS注釋，使用的是“/* ... */”符號(hào)。

第37行腳本代碼后面的JavaScript注釋，使用的是“// TODO:”符號(hào)。

第48行、第50行、第52行、第54行和第56行代碼的注釋，說明了其后的代碼添加了四種不同風(fēng)格的CSS樣式字體。

但第56行代碼原本想完成與第48行、第50行、第52行和第54行代碼同樣的功能，但第56行注釋代碼中“-->”注釋結(jié)尾符號(hào)沒寫完整，結(jié)果是將第57～60行代碼全部注釋掉了。

運(yùn)行測(cè)試網(wǎng)頁(yè)，效果如圖2.15所示。由于第56行代碼的錯(cuò)誤，第57行代碼的內(nèi)容沒有顯示出來。同時(shí)，雖然第57～60行代碼也被注釋掉了，但并沒有影響HTML網(wǎng)頁(yè)的正常輸出。