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