如果这个问题经常被问到,我很抱歉,但是我最近一直在做轻量级网络开发,并且在许多不同的(有点突出的)网页上注意到了这一点。为什么很少使用HTML/CSS中的注释?
我看到了“更传统的”编程语言中使用的评论(不同质量),但对我来说,在HTML或CSS中使用它们是非常非常罕见的。 (尽管我已经在JavaScript中看到了更多)。我通常可以弄清楚发生了什么,因为HTML并不是很复杂,但为什么会这样呢?
谢谢!
如果这个问题经常被问到,我很抱歉,但是我最近一直在做轻量级网络开发,并且在许多不同的(有点突出的)网页上注意到了这一点。为什么很少使用HTML/CSS中的注释?
我看到了“更传统的”编程语言中使用的评论(不同质量),但对我来说,在HTML或CSS中使用它们是非常非常罕见的。 (尽管我已经在JavaScript中看到了更多)。我通常可以弄清楚发生了什么,因为HTML并不是很复杂,但为什么会这样呢?
谢谢!
我认为,因为HTML(和大多数CSS)是简单的标记,很少包含任何复杂的逻辑(JavaScript的可能)。因此,标记本身是不言自明的,不需要额外的评论来解释/澄清它是什么或它做了什么。
某些关键字:声明式(Microsoft在讨论XAML时使用),自我记录。 – BoltClock 2011-04-17 21:56:34
我会假设,这是
很简单,HTML和CSS不需要太多评论。大多数情况下,您所写的CSS和HTML完全符合其所说的内容。尽管混淆HTML和CSS(特别是CSS)当然是可能的,但它几乎不会像编程语言那样频繁发生。在编程中,您需要注释,因为代码并不总是自我解释,并且您通常会因非显而易见的原因而做出奇怪的事情。
只有在您需要解释的奇怪事情时才需要使用HTML注释。否则,它只是作为形成对代码评论说,有一个明显的行为,这样的荒谬:
<td> </td> <!--IE does not display borders on cells without content-->
评论最好使用:
var i = 3; //Declares a variable called i and assigns its value to 3.
为什么你可能需要在HTML注释例来解释一个文件的棘手问题,而且对于HTML或CSS来说并没有太多棘手的问题。
虽这么说,如果我做的东西,在某些特定的浏览器的工作原理,我将添加,为什么它做事情是这样的评论。我经常会使用注释来添加关于错误修复的注释(特别是如果有错误和双重错误的话 - 尤其是如果还有其他一百个人在CSS上工作的话)。但通常对于HTML来说,将HTML注释转换为服务器端语言的注释几乎是毫不费力的,从而完全隐藏了浏览器。所以代码可能被评论,没有你知道它。
也许注释版本在本地保存,精缩/ gzip压缩的版本是向公众展示的人。这使得加载时间比附加注释的加载时间更快。
我推测,因为HTML是一种标记语言,所有的内容是相当透明的 - 所以没有必要用一个程序语言,其中的逻辑可能是复杂的比较评论,并暗示可以帮助你理解它。
我也推测这是因为HTML的大部分是网页和网站之间的重复,所以不需要解释,因为它以前已经见过很多次。
你不会想这个到最后,你会:)
<h1>My great site</h1>
<!-- heading level one - 'My great site' -->
我个人因为网络的发展过程中,意见趋向于个性化,特别是那些你会投入HTML不使用它们。相反,我将它们放入HTML中以使源阅读器不可见。
至于CSS的评论,我唯一的一次是当我有超过5000行的CSS代码,并需要将它分为几个部分。即便如此,我更愿意通过文件位置和文件名制作几个小文件,而不是使用广泛的评论。
我相信HTML和CSS是简单和足够描述的,任何人都可以在没有评论帮助的情况下非常快地派生出他们的意思。
CSS,特别是,是令人难以置信的自我描述。例如。
margin: 0;
这里没有很多补充。在CSS中,当某些代码的目的不明显时,我总是尝试添加注释,例如
overflow: hidden; /* Contains descendant floats */
而在HTML,我尽量使类名和ID值自描述的,想好类,方法和程序设计语言的变量名。
你在网上看的网页只是最终产品。带宽花钱,没有人愿意支付向他们发送网站内部运作的非政策,绝大多数人永远不会查看页面源代码。
生成这些页面的后端(当生成大多数网页时)当然可以有注释。也有安全方面的担忧,您不希望泄漏关于您网站内部运作的不必要信息。
还有一些专门的工具,只是为了从页面(和CSS)中删除不必要的内容来创建较小的文件。
评论是代码缩小器最喜欢的食物。空白也一样,但他们像牛奶和饼干一样走到一起。 – BoltClock 2011-04-17 21:54:24
我想你回答了你自己的问题,“不是很复杂”。如果html是格式化的并且使用了include,那么真的很难将一个人与Html混淆。 – Logman 2011-04-17 21:57:35