2011-04-17 42 views
0

如果这个问题经常被问到,我很抱歉,但是我最近一直在做轻量级网络开发,并且在许多不同的(有点突出的)网页上注意到了这一点。为什么很少使用HTML/CSS中的注释?

我看到了“更传统的”编程语言中使用的评论(不同质量),但对我来说,在HTML或CSS中使用它们是非常非常罕见的。 (尽管我已经在JavaScript中看到了更多)。我通常可以弄清楚发生了什么,因为HTML并不是很复杂,但为什么会这样呢?

谢谢!

+3

评论是代码缩小器最喜欢的食物。空白也一样,但他们像牛奶和饼干一样走到一起。 – BoltClock 2011-04-17 21:54:24

+0

我想你回答了你自己的问题,“不是很复杂”。如果html是格式化的并且使用了include,那么真的很难将一个人与Html混淆。 – Logman 2011-04-17 21:57:35

回答

2

我认为,因为HTML(和大多数CSS)是简单的标记,很少包含任何复杂的逻辑(JavaScript的可能)。因此,标记本身是不言自明的,不需要额外的评论来解释/澄清它是什么或它做了什么。

+0

某些关键字:声明式(Microsoft在讨论XAML时使用),自我记录。 – BoltClock 2011-04-17 21:56:34

0

我会假设,这是

  1. 因为HTML不是一种编程语言,你通常没有解释为什么/什么是如何工作的..
  2. ,也因为人们要尽量减少大小的页面..
0

很简单,HTML和CSS不需要太多评论。大多数情况下,您所写的CSS和HTML完全符合其所说的内容。尽管混淆HTML和CSS(特别是CSS)当然是可能的,但它几乎不会像编程语言那样频繁发生。在编程中,您需要注释,因为代码并不总是自我解释,并且您通常会因非显而易见的原因而做出奇怪的事情。

只有在您需要解释的奇怪事情时才需要使用HTML注释。否则,它只是作为形成对代码评论说,有一个明显的行为,这样的荒谬:

<td>&nbsp;</td> <!--IE does not display borders on cells without content--> 
0

评论最好使用:

var i = 3; //Declares a variable called i and assigns its value to 3. 

为什么你可能需要在HTML注释例来解释一个文件的棘手问题,而且对于HTML或CSS来说并没有太多棘手的问题。

虽这么说,如果我做的东西,在某些特定的浏览器的工作原理,我将添加,为什么它做事情是这样的评论。我经常会使用注释来添加关于错误修复的注释(特别是如果有错误和双重错误的话 - 尤其是如果还有其他一百个人在CSS上工作的话)。但通常对于HTML来说,将HTML注释转换为服务器端语言的注释几乎是毫不费力的,从而完全隐藏了浏览器。所以代码可能被评论,没有你知道它。

3

也许注释版本在本地保存,精缩/ gzip压缩的版本是向公众展示的人。这使得加载时间比附加注释的加载时间更快。

1

我推测,因为HTML是一种标记语言,所有的内容是相当透明的 - 所以没有必要用一个程序语言,其中的逻辑可能是复杂的比较评论,并暗示可以帮助你理解它。

我也推测这是因为HTML的大部分是网页和网站之间的重复,所以不需要解释,因为它以前已经见过很多次。

你不会想这个到最后,你会:)

<h1>My great site</h1> 
<!-- heading level one - 'My great site' --> 
0

我个人因为网络的发展过程中,意见趋向于个性化,特别是那些你会投入HTML不使用它们。相反,我将它们放入HTML中以使源阅读器不可见。

至于CSS的评论,我唯一的一次是当我有超过5000行的CSS代码,并需要将它分为几个部分。即便如此,我更愿意通过文件位置和文件名制作几个小文件,而不是使用广泛的评论。

我相信HTML和CSS是简单和足够描述的,任何人都可以在没有评论帮助的情况下非常快地派生出他们的意思。

0

最重要的原因正如你所说,在HTML和CSS中没有如此巨大的评论需求。

其次,在HTML中评论与编程语言相比是非常困难的,把<!-- -->标记需要时间,而//来自里面。

+0

但是对于你需要添加另一个'//'的每一行。 ''和'/ * * /'之间的区别只有三个字符。 – BoltClock 2011-04-17 21:59:39

+1

'/ *'CSS注释是因为某种原因最让我烦恼的。 '* /' – Shaz 2011-04-17 22:00:07

+0

如果您使用/ * * /,那么难度不大,但难度参数变得没有实际意义。 – Kon 2011-04-17 22:00:59

0

CSS,特别是,是令人难以置信的自我描述。例如。

margin: 0; 

这里没有很多补充。在CSS中,当某些代码的目的不明显时,我总是尝试添加注释,例如

overflow: hidden; /* Contains descendant floats */ 

而在HTML,我尽量使类名和ID值自描述的,想好类,方法和程序设计语言的变量名。

2

你在网上看的网页只是最终产品。带宽花钱,没有人愿意支付向他们发送网站内部运作的非政策,绝大多数人永远不会查看页面源代码。

生成这些页面的后端(当生成大多数网页时)当然可以有注释。也有安全方面的担忧,您不希望泄漏关于您网站内部运作的不必要信息。

还有一些专门的工具,只是为了从页面(和CSS)中删除不必要的内容来创建较小的文件。

相关问题