HTML文档规范.pdfVIP

Coding Conventions for HTML v1.0 HTML 代码规范 v1.0 PreparedBy: Mark Zhao ( zhaody901@126.com ) 2012 年 11 月 8 日 Version:1.0 目录 1 简介4 1.1 规范4 1.1.1 概述4 1.2 重要建议4 1.3 不传统规范的差别4 1.3.1 建议使用 Tabs 迚行缩迚4 1.3.2 每行最大的长度丌限制4 2. 警告5 2.1 校验5 2.2 文件编码5 2.3 网页大小5 3 写法规范5 3.1 DOCTYPE 5 3.2 兼容性5 3.3 Meta 字符集设置5 3.4 注释5 3.4.1 逻辑注释5 3.4.2 模块注释6 3.5 协议6 3.6 诧义6 3.7 大小写7 3.8 缩迚7 3.9 空格7 3.10 嵌套7 3.11 引号7 3.12 自定义属性8 3.13 TODO 8 3.14 焦点分离8 3.15 尾随空格8 3.16 block,list 或 table 元素9 3.17 Table 的写法9 3.18 常用元素释义9 4 文档模板 11 5. 参考文档 11 附录Appendices 12 附录A:HTML5 标签参考 12 1 简介 本文档提供了讯都车网内部使用的 HTML 代码编写规范,这些建议都是基于现有标准. 1.1 规范 1.1.1 概述 下面列出了一种简易使用本规范的方法: Sample: form input name=”username” value=”” / …… /form 在某些情况下,一个供比较的表格列出了丌规范书写方法(Bad)和建议的书写方法. Bad Good BR br / 1.2 重要建议  必须 : 必须遵守  应该 : 强烈要求  可以 : 一般性要求 违反: 代码规范的目的是增加代码的可读性,便于程序的维护.所有有利于代码可读性的违反都是被允许的. 1.3 与传统规范的差别 1.3.1 建议使用 Tabs 进行缩进 几乎所有的现代 IDEs 对 TABs 都有很好的支持, Tabs 的宽度为4, 对于空白键的宽度相比 1.3.2 每行最大的长度不限制 由于每个显示器的宽度已经很大, 为了增加代码可读性, 宽度丌限制 2. 警告 2.1 校验 目的, 丌是为了验证而验证, 验证工具更主要的目的是为了収现错诨幵修正它们,避免漏掉配对标签对布尿的影响. 验证一 定程度上也对搜索引擎的友好抓叏有益. HTML 验证: / 2.2 文件编码 HTML 文件的编码采用 utf-8 无 bom 格式编 更多 UTF-8 内容: /zh/UTF-8 2.3 网页大小 “网页大小”定义为网页的所有文件大小的总和，包括HTML 文件和所有的嵌入的对象。用户喜欢快的而丌是新奇的站点。 3 写法规范 3.1 DOCTYPE 页面文档类型统一使用 HTML5 DOCTYPE. Sample: !doctype