通用性承诺
标识
自闭合(self-closing)标识,不用闭合 ( 比如: img input br hr 等 );
可选的闭合标识(closing tag),需闭合 ( 比如:</li> 或 </body>);
尽可能降低标识数量;
- <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 单词字母小写,好几个单词构成时,选用中划线-隔开;
应用唯1的 id 做为 Javascript hook,另外防止建立无款式信息内容的 class;
- <!-- 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
- <a id="..." class="..." data-modal="toggle" href="###"></a>
- <input class="form-control" type="text">
- <img src="..." alt="...">
引号
特性的界定,统1应用双引号。
- <!-- Not recommended -->
- <span id='j-hook' class=text>Google</span>
- <!-- Recommended -->
- <span id="j-hook" class="text">Google</span>
b嵌套循环
a 不容许嵌套循环 div 这类管束属于词义嵌套循环管束,与之差别的管束也有严苛嵌套循环管束,例如 a 不容许嵌套循环 a。
严苛嵌套循环管束在全部的访问器下都不被容许;而词义嵌套循环管束,访问器大多数会容错机制解决,转化成的文本文档树将会互相不太1样。
词义嵌套循环管束
<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 等特性无需设定值。
- <input type="text" disabled>
- <input type="checkbox" value="1" checked>
- <select>
- <option value="1" selected>1</option>
- </select>
词义化
沒有 CSS 的 HTML 是1个词义系统软件而并不是 UI 系统软件。
一般状况下,每一个标识全是有词义的,所谓词义便是你的衣服分成外套, 裤子,裙子,内裤等,各有有对应的作用和含意。因此你总不可以把内裤套在脖子上吧。-- 1丝
另外词义化的 HTML 构造,有助于设备(检索模块)了解,另外一层面多人合作时,能快速掌握开发设计者用意。
普遍标识词义
示例
将你搭建的网页页面作为1本书,将标识的词义对应的其作用和含意;
书的名字:<h1>
书的每一个章节题目: <h2>
章节内的文章内容题目: <h3>
副标题 / 副题目: <h4> <h5> <h6>
章节的段落: <p>
HEAD
文本文档种类
为每一个 HTML 网页页面的第1行加上规范方式(standard mode)的申明, 这样可以保证在每一个访问器中有着1致的主要表现。
- <!DOCTYPE html>
- 語言特性
- <!-- 汉语 -->
- <html lang="zh-Hans">
- <!-- 简体汉语 -->
- <html lang="zh-cmn-Hans">
- <!-- 繁体汉语 -->
- <html lang="zh-cmn-Hant">
- <!-- English -->
- <html lang="en">
标识符编号
以无 BOM 的 utf⑻ 编号做为文档文件格式;
特定标识符编号的 meta 务必是 head 的第1个立即子元素
- <html>
- <head>
- <meta charset="utf⑻">
- ......
- </head>
- <body>
- ......
- </body>
- </html>
IE 适配方式
优先选择应用全新版本号的 IE 和 Chrome 核心。
- <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
SEO 提升
- <head>
- <meta charset="utf⑻">
- <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: 1般指的是访问器对话框內容区的尺寸,不包括专用工具条、选项卡等內容;
width: 访问器宽度,輸出机器设备中的网页页面可见地区宽度;
device-width: 机器设备辨别率宽度,輸出机器设备的显示屏可见宽度;
initial-scale: 原始放缩占比;
maximum-scale: 最大放缩占比;
为挪动端机器设备提升,设定可见地区的宽度和原始放缩占比。
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
iOS 标志
apple-touch-icon 照片全自动解决成圆角和高光等实际效果;
apple-touch-icon-precomposed 严禁系统软件全自动加上实际效果,立即显示信息设计方案原图;
- <!-- iPhone 和 iTouch,默认设置 57x57 像素,务必有 -->
- <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon⑸7x57-precomposed.png">
- <!-- iPad,72x72 像素,能够沒有,但强烈推荐有 -->
- <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon⑺2x72-precomposed.png" sizes="72x72">
- <!-- Retina iPhone 和 Retina iTouch,114x114 像素,能够沒有,但强烈推荐有 -->
- <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon⑴14x114-precomposed.png" sizes="114x114">
- <!-- Retina iPad,144x144 像素,能够沒有,但强烈推荐有 -->
- <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon⑴44x144-precomposed.png" sizes="144x144">
favicon
在未特定 favicon 时,大多数数访问器会恳求 Web Server 根文件目录下的 favicon.ico。以便确保 favicon 可浏览,防止 404,务必遵照下列两种方式之1:
在 Web Server 根文件目录置放 favicon.ico 文档;
应用 link 特定 favicon;
- <link rel="shortcut icon" href="path/to/favicon.ico">
HEAD 模版
- <!DOCTYPE html>
- <html lang="zh-cmn-Hans">
- <head>
- <meta charset="utf⑻">
- <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">
- <!-- 为挪动机器设备加上 viewport -->
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
- <!-- iOS 标志 -->
- <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon⑸7x57-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 注解
控制模块注解
- <!-- 文章内容目录目录控制模块 -->
- <div class="article-list">
- ...
- </div>
- 区块注解
- <!--
- @name: Drop Down Menu
- @description: Style of top bar drop down menu.
- @author: Ashu(Aaaaaashu)
- -->