《HTML5开发人员编码规范.docx》由会员分享，可在线阅读，更多相关《HTML5开发人员编码规范.docx（6页珍藏版）》请在三一办公上搜索。
1、HTML5开发人员编码规范HTML5开发人员编码规范 前言 HTML5作为移动端网页结构的超文本标记语言，本文档的目标是使HTML5代码风格保持一致，容易被理解、维护和升级。 目录 一、 HTML5规范 . 2 1. 代码风格. 2 1.1 1.2 1.3 1.4 缩进与换行 . 2 命名规则 . 2 标签 . 2 属性 . 2 2. 页面头部. 3 2.1 2.2 2.3 2.4 DOCTYPE . 3 语言编码 . 3 CSS和JavaScript引入 . 3 Head内容 . 3 3. 图片. 3 4. 表单. 3 4.1 4.2 4.3 控件标题 . 3 按钮 . 3 可访问性 . 3
2、 5. 多媒体. 3 6. 注释. 4 二、 三、 CSS规范 . 4 JAVASCRIPT规范 . 4 一、 HTML5规范 1. 代码风格 1.1 缩进与换行 建议使用4个空格作为一个缩进层级。 建议模板代码的缩进优先保证 HTML 代码的缩进规则。 1.2 命名规则 强制class：必须单词全字母小写，单词间以-分隔，且必须代表相应的模块或部件的内容或功能，不得以html内置样式进行命名，命名应该具有明确的语义。 强制id：必须保持在页面中的唯一性，命名应该具有明确的语义。 1.3 标签 强制Html中的标签名必须使用小写字母。 强制标签的闭合要符合html5的规定。 强制标签的使用必须
3、符合标签的嵌套规则，例：div不得置于p中，tbody必须置于table中。 建议标签的使用必须遵循标签的语义，例： p - 段落 h1,h2,h3,h4,h5,h6 - 层级标题 strong,em - 强调 ins - 插入 del - 删除 abbr - 缩写 code - 代码标识 cite - 引述来源作品的标题 q - 引用 blockquote - 一段或长篇引用 ul - 无序列表 ol - 有序列表 dl,dt,dd - 定义列表 建议在CSS可以实现相同需求的情况下不得使用表格进行布局。 1.4 属性 强制属性必须使用小写字母，其属性值必须用双引号包围。 建议布尔类型的建议
4、不添加属性值。自定义属性建议以 xxx- 为前缀，推荐使用data- 2. 页面头部 2.1 DOCTYPE 强制使用doctype 来启用标准模式，建议使用大写的 DOCTYPE 2.2 语言编码 建议有助于提高页面的可访问性，必须设置正确的lang属性，例： 强制页面必须指定字符编码的meta，且必须是 head 的第一个直接子元素，例：。 2.3 CSS和JavaScript引入 强制引入css时必须指明rel=stylesheet，在引入css和javascript时必须指明type属性。 建议Javascript代码必须放在页面末尾或采用异步加载。 2.4 Head内容 强制Titl
5、e标签必须设置为head的直接子元素，并紧随charset声明之后。 强制Favicon保证可访问，例： 强制Viewport属性必须指定。 3. 图片 强制禁止 img 的 src 取值为空，延迟加载的图片也要增加默认的 src属性值。 建议重要图片添加 alt 属性值。 建议添加 width 和 height 属性以避免页面抖动。 4. 表单 4.1 控件标题 强制文本标题的控件必须使用 label 标签将其与其标题相关联，例： 我已确认上述条款或用户： 4.2 按钮 强制使用 button 元素时必须指明 type 属性值 4.3 可访问性 建议当使用 JavaScript 进行表单提交时，应使原生提交功能正常工作。 建议 根据内容类型指定输入框的 type 属性，例： 5. 多媒体 建议使用 audio 以及 video 标签来播放音频、视频时，应当注意格式： 音频格式：MP3、WAV、Ogg 视频格式：MP4、WebM、Ogg 6. 注释 强制针对页面或模块的CSS、javascript代码必须进行详细的注释 二、 三、 JAVASCRIPT规范 CSS规范
