Google的HTML/CSS编码规范

HTML5是W3C与WHATWG合作的结果,现在HTML5正是如火如荼的发展着,但其仍处于完善之中,然而,大部分现代浏览器已经具备了某些 HTML5 支持。前几天在网上看到Google的HTML/CSS编码规范,其中不乏很多我们很容易忽略的东西,现在就分享给大家,以便大家鉴阅。

一、协议头。建议在指向图片或其他媒体文件、样式表和脚本的URL地址中省略http:https:协议部分,除非已知相应文件不能同时兼容2个协议。

二、缩进:每次缩进使用双空格。不要使用tab制表符或制表符加空格的混合方式缩进。

三、大小写:只使用小写。所有的代码都应是小写的,包括元素名称、属性,属性值(除非text或CDATA的内容)、选择器、css属性、属性值(字符串除外)。

四、尾随空格。尾随空格是不必要的,容易搞复杂diff文件。这个绝对是经验教训的总结。

五、编码格式:使用UTF-8。请确保您的编辑器使用的字符编码??为UTF-8,没有字节顺序标记。在html模板或文档中通过 <meta charset="utf-8″>来定义编码格式。关于编码格式参考 Character Sets & Encodings in XHTML, HTML and CSS。

六、注释。根据需要解释代码,这个就不多说了,团队开发这个非常重要,尽管很多时候大家不愿意遵守,但确实重要。

七、TODO待定项。尚未实现的或待定的内容一定要标识强调出来,利用TODO辨识,而非其他诸如@@来强调;在todo项中如果有必要列明联系人,比如负责人;在TODO后追加一个冒号作为行动内容,例如 TODO:为美瑞网增加html5模板。

八、文档类型:使用HTML5。使用<!DOCTYPE html>.HTML(text/html)类型文件相对XHTML(alication/xhtml+xml)文件,在浏览器及框架支持上和优化空间上都要好很多。

九、HTML 合法性验证。合法的使用HTML,并利用w3c的工具(W3C HTML validator)进行检查。唯一例外就是因为性能原因需要压缩文件大小。原文如下:Use valid HTML code unless that is not possible due to otherwise unattainable performance goals  regarding file size. 但这个确实很难想象,省略标签节省的文件大小能有多少字节?但带来的问题可是风险居高哦。

十、语义性。根据目的来合理使用HTML,这点对于HTML5而言尤为重要。下面例子可以对比,能实现同样的结果,但效率和可读性却有很大差别。对于HTML5而言,例如header、footer、nav、section等跟p能实现的功能基本类似,但是语义性上有着天壤之别。

十一、多媒体后备:为多媒体提供备选内容。这个属于老生长谈的内容,典型就是为img添加alt内容。

十二、关注点分离。这点很重要,严格遵守将组织结构(markup)、表现样式(style)和行为动作(script)分开处理的原则,并且尽量使三者之间的关联度降到最小。这主要是基于维护性的考虑,通常,更新style文件或脚本文件比更改HTML文件的代价要小很多,试想一下,对于一个有超过10万页面的网站进行局部颜色调整,是每个html文件修改容易还是修改一个style文件容易?

十三、实体引用。假定开发团队内,文件和编辑器都是使用同样的编码格式(UTF-8),则没有必要使用实体引用的方式,例如&mdash;,&rdquo;, or &#x263a; 除非一些HTML中具有特定含义的字符,如"<",或不可见字符如空格。

十四、Type属性:省略。将样式表和脚本中的Type省略,除非你不是用的css或javascript,在HTML5中,该值默认是text/css和text/javascript。

十五、block,list或table元素。针对每个block,list或table元素另起一行,并在每个子元素前缩进,这样可读性好。

以上内容应该来说属于比较基本的规则内容,翻译整理自其他媒体文章,对于使用HTML5的朋友,还是有参考价值的。这里有Google规范的原文,大家可以参考一下。 

转载请注明:代码家园 » Google的HTML/CSS编码规范

评论列表(网友评论仅供网友表达个人看法,并不表明本站同意其观点或证实其描述)