前端工程师纳米学位样式指南-html.pdfVIP

Udacity ​优达学城 前端工程师纳米学位样式指南 - HTML 点此查看文档英文版（​pdf​，​GitHub.io​） 介绍 该指南是你在项目进行过程中所需遵守的官方指南。优达学城的评估人员会根据该指南为你的项 目打分。在前端网页开发的世界中，有很“最佳”样式供你选择。因此，为了减少学生在项目过程 中因选择何种样式所产生的困惑，我们强烈建议所有学生在其项目中遵循这个样式指南。 一般格式规则 字母大小写 仅使用小写。 所有代码均使用小写，该规则适用于 HTML 元素名、属性和属性值 （文本/ CDATA 除外）。 不推荐： A HREF=/Home/A 推荐： a href=/Home/a 末尾空白 删除行尾​空格​。 行尾​空格​属于多余的符号，会使 diff 更加难以阅读。 不推荐： pWhat?/p__ 1 Udacity ​优达学城 推荐： pWhat?/p 如果使用 Sublime Text ，你可在用户设置（User Settings）JSON 文件（可在文本编辑器的菜单中找 到）中添加以下代码，每当你以此方法储存文件时，去除行尾​空格​操作便会自动完成： trim_trailing_white_space_on_save: true 缩进 整个文件中的缩进应保持前后一致，使用 Tab 、2个空格或4个空格都可以，但需保持前后一致。 一般元规则 编码 使用 UTF-8 （无 BOM）。 确保你的编辑器将没有字节顺序标记的 UTF-8 用作字符编码。在 HTML 模板中设置编码并用 ​meta charset=utf-8​ 记录。 注释 在可行和必要时，对代码进行注释。 用注释解释代码的覆盖范围、目的和作用以及使用和选择各解决方案的原因。 任务项 用 ​TODO:​ 标注待办事项和任务项 ： 仅用关键词 TODO 标注待办事项，不要使用 ​@@​ 等其他格式的字样。在任务项前加冒号，如： TODO: action item​。 推荐： !-- TODO: add other fruits -- ul 2 Udacity ​优达学城 liApples/li liOranges/li /ul HTML 样式规则 文件类型 使用 HTML5 。 所有 HTML 文件均应使用 HTML5 （ HTML 语法）： ​!DOCTYPE html。 不要结束自结束元素，即编写 ​br​ ，而不是​br /​。 HTML 有效性 使用有效的 HTML 。 使用有效的 HTML 是可测量的基准质量，可确保 HTML 的合理使用并有助于了解技术要求和限制。 不推荐： titlePage Title/title articleThis is an article. 推荐： !DOCTYPE html html head meta charset=utf-8 titlePage Title/title /head body articleThis is an article./article /body /html 3 Udacity ​优达学城 语义 根据目的使用 HTML 。 根据元素的预期作用使用元素。例如，针对标题使用标题元素，针对段落使用 ​p​ 元素，针对锚点使 用 ​a​ 元素等。根据目的使用HTML 对提高可访问性、再利用