前端开发规范讲述.doc

前端开发规范 黄金定律 永远遵循同一套编码规范 -- 可以是这里列出的，也可以是你自己总结的。如果你发现本规范中有任何错误，敬请指正。通过open an issue on GitHub为本规范添加或贡献内容。不管有多少人共同参与同一项目，一定要确保每一行代码都像是同一个人编写的。/#html-attribute-order HTML代码规范 一、语法 用个空格来代替制表符（tab） -- 这是唯一能保证在所有环境下获得一致展现的方法。 嵌套元素应当缩进一次（即个空格）。 对于属性的定义，确保全部使用双引号，绝不要使用单引号。 不要在自闭合（self-closing）元素的尾部添加斜线 --HTML5 规范中明确说明这是可选的。 不要省略可选的结束标签（closing tag）（例如，/li或?/body）。!DOCTYPE html html head titlePage title/title /head body img src=images/company-logo.png alt=Company h1 class=hello-worldHello, world!/h1 /body /html 二、HTML5 doctype 为每个 HTML 页面的第一行添加标准模式（standard mode）的声明，这样能够确保在每个浏览器中拥有一致的展现。!DOCTYPE html html head /head /html 三、语言属性 根据 HTML5 规范： 强烈建议为 html 根元素指定 lang 属性，从而为文档设置正确的语言。这将有助于语音合成工具确定其所应该采用的发音，有助于翻译工具确定其翻译时所应遵守的规则等等。 更多关于?lang?属性的知识可以从?此规范?中了解。 这里列出了语言代码表。 html lang=zh-CN !-- ... -- /html IE 兼容模式 IE 支持通过特定的?meta?标签来确定绘制当前页面所应该采用的 IE 版本。除非有强烈的特殊需求，否则最好是设置为edge mode，从而通知 IE 采用其所支持的最新的模式。 阅读这篇 stack overflow 上的文章可以获得更多有用的信息。 meta http-equiv=X-UA-Compatible content=IE=Edge 字符编码 通过明确声明字符编码，能够确保浏览器快速并容易的判断页面内容的渲染方式。这样做的好处是，可以避免在 HTML 中使用字符实体标记（character entity），从而全部与文档编码一致（一般采用 UTF-8 编码）。head meta charset=UTF-8 /head 六、引入 CSS 和 JavaScript 文件 根据 HTML5 规范，在引入 CSS 和 JavaScript 文件时一般不需要指定?type?属性，因为?text/css?和?text/javascript?分别是它们的默认值。 HTML5 spec links Using link Using style Using script !-- External CSS -- link rel=stylesheet href=code-guide.css !-- In-document CSS -- style /* ... */ /style !-- JavaScript -- script src=code-guide.js/script 七、实用为王 尽量遵循 HTML 标准和语义，但是不要以牺牲实用性为代价。任何时候都要尽量使用最少的标签并保持最小的复杂度。属性顺序 HTML 属性应当按照以下给出的顺序依次排列，确保代码的易读性。 class id,?name data-* src,?for,?type,?href title,?alt aria-*,?role class 用于标识高度可复用组件，因此应该排在首位。id 用于标识具体组件，应当谨慎使用（例如，页面内的书签），因此排在第二位。 a class=... id=... data-modal=toggle href=# Example link /a input class=form-control type=text img src=... alt=... 九、布尔（boolean）型属性 布尔型属性可以在声明时不赋值。XHTML 规范要求为其赋值，但是 HTML5 规范不需要。 更多信息请参考?WhatWG section on boolean attributes： 元素的布尔型属性如果有值，就是 true，如果没有值，就是 false。 如果一定要为其赋值的话，请参考 Wha