通用约定
标签
自闭合(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>
-
-
- <span class=\"avatar\">
- <img src=\"...\">
- </span>
-
-
- <img class=\"avatar\" src=\"...\">
Class 与 ID
class 应以功能或内容命名,不以表现形式命名;
class 与 id 单词字母小写,多个单词组成时,采用中划线-分隔;
使用唯一的 id 作为 Javascript hook,同时避免创建无样式信息的 class;
XML/HTML Code复制内容到剪贴板
-
- <div class=\"j-hook left contentWrapper\"></div>
-
-
- <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复制内容到剪贴板
-
- <span id=\'j-hook\' class=text>Google</span>
-
-
- <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\">
-
-
- <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\">
-
- <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复制内容到剪贴板
-
- <link rel=\"apple-touch-icon-precomposed\" href=\"/apple-touch-icon-57x57-precomposed.png\">
-
-
- <link rel=\"apple-touch-icon-precomposed\" href=\"/apple-touch-icon-72x72-precomposed.png\" sizes=\"72x72\">
-
-
- <link rel=\"apple-touch-icon-precomposed\" href=\"/apple-touch-icon-114x114-precomposed.png\" sizes=\"114x114\">
-
-
- <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\">
-
-
- <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">
-
-
- <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)
- -->