好得很程序员自学网

<tfoot draggable='sEl'></tfoot>

HTML代码书写规范指南

通用约定
标签

自闭合(self-closing)标签,无需闭合 ( 例如: img input br hr 等 );
可选的闭合标签(closing tag),需闭合 ( 例如:</li> 或 </body>);
尽量减少标签数量;

 

XML/HTML Code 复制内容到剪贴板

< img   src = "images/google.png"   alt = "Google" >    < input   type = "text"   name = "title" >       < ul >       < li > Style </ li >       < li > Guide </ li >    </ ul >       <!-- Not recommended -->    < span   class = "avatar" >       < img   src = "..." >    </ span >       <!-- Recommended -->    < img   class = "avatar"   src = "..." >   

Class 与 ID

class 应以功能或内容命名,不以表现形式命名;
class 与 id 单词字母小写,多个单词组成时,采用中划线-分隔;
使用唯一的 id 作为 Javascript hook,同时避免创建无样式信息的 class;

 

XML/HTML Code 复制内容到剪贴板

<!-- Not recommended -->    < div   class = "j-hook left contentWrapper" > </ div >       <!-- Recommended -->    < div   id = "j-hook"   class = "sidebar content-wrapper" > </ div >   

属性顺序

HTML 属性应该按照特定的顺序出现以保证易读性。

id
class
name
data-xxx
src, for, type, href
title, alt
aria-xxx, role

 

XML/HTML Code 复制内容到剪贴板

< a   id = "..."   class = "..."   data-modal = "toggle"   href = "###" > </ a >       < input   class = "form-control"   type = "text" >       < img   src = "..."   alt = "..." >   

引号

属性的定义,统一使用双引号。

 

XML/HTML Code 复制内容到剪贴板

<!-- Not recommended -->    < span   id = 'j-hook'   class = text > Google </ span >       <!-- Recommended -->    < span   id = "j-hook"   class = "text" > Google </ span >   

b嵌套

a 不允许嵌套 div 这种约束属于语义嵌套约束,与之区别的约束还有严格嵌套约束,比如 a 不允许嵌套 a。

严格嵌套约束在所有的浏览器下都不被允许;而语义嵌套约束,浏览器大多会容错处理,生成的文档树可能相互不太一样。

 

语义嵌套约束

<li> 用于 <ul> 或 <ol> 下;
<dd>,<dt> 用于 <dl> 下;
<thead>,<tbody>,<tfoot>,<tr>,<td> 用于<table>下;


严格嵌套约束

inline-Level 元素,仅可以包含文本或其它 inline-Level 元素;
<a> 里不可以嵌套交互式元素 <a>、<button>、<select>等;
<p>里不可以嵌套块级元素<div>、<h1>~<h6>、<p>、<ul>/<ol>/<li>、<dl>/<dt>/<dd>、<form>等。

布尔值属性

HTML5 规范中 disabled、checked、selected 等属性不用设置值。

 

XML/HTML Code 复制内容到剪贴板

< input   type = "text"  disabled >       < input   type = "checkbox"   value = "1"  checked >       < select >       < option   value = "1"  selected > 1 </ option >    </ select >   

语义化
没有 CSS 的 HTML 是一个语义系统而不是 UI 系统。

通常情况下,每个标签都是有语义的,所谓语义就是你的衣服分为外套, 裤子,裙子,内裤等,各自有对应的功能和含义。所以你总不能把内裤套在脖子上吧。-- 一丝

此外语义化的 HTML 结构,有助于机器(搜索引擎)理解,另一方面多人协作时,能迅速了解开发者意图。

常见标签语义

标签 语义 <p> 段落 <h1><h2><h3>... 标题 <ul> 无序列表 <ol> 有序列表 <blockquote> 大段引用 <cite> 一般引用 <b> 为样式加粗而加粗 <storng> 为强调内容而加粗 <i> 为样式倾斜而倾斜 <em> 为强调内容而倾斜 code 代码标识 abbr 缩写
示例

将你构建的页面当作一本书,将标签的语义对应的其功能和含义;

书的名称:<h1>
书的每个章节标题: <h2>
章节内的文章标题: <h3>
小标题 / 副标题: <h4> <h5> <h6>
章节的段落: <p>

HEAD
文档类型

为每个 HTML 页面的第一行添加标准模式(standard mode)的声明, 这样能够确保在每个浏览器中拥有一致的表现。

 

XML/HTML Code 复制内容到剪贴板

<!DOCTYPE html >    语言属性       <!-- 中文 -->    < html   lang = "zh-Hans" >       <!-- 简体中文 -->    < html   lang = "zh-cmn-Hans" >       <!-- 繁体中文 -->    < html   lang = "zh-cmn-Hant" >       <!-- English -->    < html   lang = "en" >   

字符编码

以无 BOM 的 utf-8 编码作为文件格式;
指定字符编码的 meta 必须是 head 的第一个直接子元素

 

XML/HTML Code 复制内容到剪贴板

< html >       < head >         < meta   charset = "utf-8" >        ......       </ head >       < body >        ......       </ body >    </ html >   

IE 兼容模式

优先使用最新版本的 IE 和 Chrome 内核。

 

XML/HTML Code 复制内容到剪贴板

< meta   http-equiv = "X-UA-Compatible"   content = "IE=edge,chrome=1" >   

SEO 优化

 

XML/HTML Code 复制内容到剪贴板

< head >         < meta   charset = "utf-8" >         < meta   http-equiv = "X-UA-Compatible"   content = "IE=edge,chrome=1" >         <!-- SEO -->         < title > Style Guide </ title >         < meta   name = "keywords"   content = "your keywords" >         < meta   name = "description"   content = "your description" >         < meta   name = "author"   content = "author,email address" >    </ head >   

viewport

viewport: 一般指的是浏览器窗口内容区的大小,不包含工具条、选项卡等内容;
width: 浏览器宽度,

输出设备中的页面可见区域宽度;
device-width: 设备分辨率宽度,
输出设备的屏幕可见宽度;
initial-scale: 初始缩放比例;
maximum-scale: 最大缩放比例;
为移动端设备优化,设置可见区域的宽度和初始缩放比例。

 

XML/HTML Code 复制内容到剪贴板

< meta   name = "viewport"   content = "width=device-width, initial-scale=1.0" >   

iOS 图标

apple-touch-icon 图片自动处理成圆角和高光等效果;
apple-touch-icon-precomposed 禁止系统自动添加效果,直接显示设计原图;

 

XML/HTML Code 复制内容到剪贴板

<!-- iPhone 和 iTouch,默认 57x57 像素,必须有 -->    < link   rel = "apple-touch-icon-precomposed"   href = "/apple-touch-icon-57x57-precomposed.png" >       <!-- iPad,72x72 像素,可以没有,但推荐有 -->    < link   rel = "apple-touch-icon-precomposed"   href = "/apple-touch-icon-72x72-precomposed.png"   sizes = "72x72" >       <!-- Retina iPhone 和 Retina iTouch,114x114 像素,可以没有,但推荐有 -->    < link   rel = "apple-touch-icon-precomposed"   href = "/apple-touch-icon-114x114-precomposed.png"   sizes = "114x114" >       <!-- Retina iPad,144x144 像素,可以没有,但推荐有 -->    < link   rel = "apple-touch-icon-precomposed"   href = "/apple-touch-icon-144x144-precomposed.png"   sizes = "144x144" >   

favicon

在未指定 favicon 时,大多数浏览器会请求 Web Server 根目录下的 favicon.ico。为了保证 favicon 可访问,避免 404,必须遵循以下两种方法之一:

在 Web Server 根目录放置 favicon.ico 文件;
使用 link 指定 favicon;

 

XML/HTML Code 复制内容到剪贴板

< link   rel = "shortcut icon"   href = "path/to/favicon.ico" >   

HEAD 模板

 

XML/HTML Code 复制内容到剪贴板

<!DOCTYPE html >    < html   lang = "zh-cmn-Hans" >    < head >         < meta   charset = "utf-8" >         < meta   http-equiv = "X-UA-Compatible"   content = "IE=edge,chrome=1" >         < title > Style Guide </ title >         < meta   name = "description"   content = "不超过150个字符" >         < meta   name = "keywords"   content = "" >         < meta   name = "author"   content = "name, email@gmail.com" >            <!-- 为移动设备添加 viewport -->         < meta   name = "viewport"   content = "width=device-width, initial-scale=1.0" >            <!-- iOS 图标 -->         < link   rel = "apple-touch-icon-precomposed"   href = "/apple-touch-icon-57x57-precomposed.png" >            < link   rel = "alternate"   type = "application/rss+xml"   title = "RSS"   href = "/rss.xml"   />         < link   rel = "shortcut icon"   href = "path/to/favicon.ico" >    </ head >   

HTML 注释

模块注释

 

XML/HTML Code 复制内容到剪贴板

<!-- 文章列表列表模块 -->    < div   class = "article-list" >    ...    </ div >    区块注释    <!--    @name: Drop Down Menu    @description: Style of top bar drop down menu.    @author: Ashu(Aaaaaashu@gmail.com)    -- >   

查看更多关于HTML代码书写规范指南的详细内容...

  阅读:33次