HTML编码撰写标准指南

通用性承诺
标识

自闭合(self-closing)标识,不用闭合 ( 比如: img input br hr 等 );
可选的闭合标识(closing tag),需闭合 ( 比如:</li> 或 </body>);
尽可能降低标识数量;

XML/HTML Code拷贝內容到剪贴板
  1. <img src="images/google.png" alt="Google">  
  2. <input type="text" name="title">  
  3.   
  4. <ul>  
  5.   <li>Style</li>  
  6.   <li>Guide</li>  
  7. </ul>  
  8.   
  9. <!-- Not recommended -->  
  10. <span class="avatar">  
  11.   <img src="...">  
  12. </span>  
  13.   
  14. <!-- Recommended -->  
  15. <img class="avatar" src="...">  

Class 与 ID

class 应以作用或內容取名,不以主要表现方式取名;
class 与 id 单词字母小写,好几个单词构成时,选用中划线-隔开;
应用唯1的 id 做为 Javascript hook,另外防止建立无款式信息内容的 class;

XML/HTML Code拷贝內容到剪贴板
  1. <!-- Not recommended -->  
  2. <div class="j-hook left contentWrapper"></div>  
  3.   
  4. <!-- Recommended -->  
  5. <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拷贝內容到剪贴板
  1. <a id="..." class="..." data-modal="toggle" href="###"></a>  
  2.   
  3. <input class="form-control" type="text">  
  4.   
  5. <img src="..." alt="...">  

引号

特性的界定,统1应用双引号。

XML/HTML Code拷贝內容到剪贴板
  1. <!-- Not recommended -->  
  2. <span id='j-hook' class=text>Google</span>  
  3.   
  4. <!-- Recommended -->  
  5. <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 等特性无需设定值。

XML/HTML Code拷贝內容到剪贴板
  1. <input type="text" disabled>  
  2.   
  3. <input type="checkbox" value="1" checked>  
  4.   
  5. <select>  
  6.   <option value="1" selected>1</option>  
  7. </select>  

词义化
沒有 CSS 的 HTML 是1个词义系统软件而并不是 UI 系统软件。

一般状况下,每一个标识全是有词义的,所谓词义便是你的衣服分成外套, 裤子,裙子,内裤等,各有有对应的作用和含意。因此你总不可以把内裤套在脖子上吧。-- 1丝

另外词义化的 HTML 构造,有助于设备(检索模块)了解,另外一层面多人合作时,能快速掌握开发设计者用意。

普遍标识词义

标识 词义 <p> 段落 <h1><h2><h3>... 题目 <ul> 无编码序列表 <ol> 井然有序目录 <blockquote> 大段引入 <cite> 1般引入 <b> 为款式加粗而加粗 <storng> 为强调內容而加粗 <i> 为款式歪斜而歪斜 <em> 为强调內容而歪斜 code 编码标志 abbr 缩写
示例

将你搭建的网页页面作为1本书,将标识的词义对应的其作用和含意;

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

HEAD
文本文档种类

为每一个 HTML 网页页面的第1行加上规范方式(standard mode)的申明, 这样可以保证在每一个访问器中有着1致的主要表现。

XML/HTML Code拷贝內容到剪贴板
  1. <!DOCTYPE html>  
  2. 語言特性   
  3.   
  4. <!-- 汉语 -->  
  5. <html lang="zh-Hans">  
  6.   
  7. <!-- 简体汉语 -->  
  8. <html lang="zh-cmn-Hans">  
  9.   
  10. <!-- 繁体汉语 -->  
  11. <html lang="zh-cmn-Hant">  
  12.   
  13. <!-- English -->  
  14. <html lang="en">  

标识符编号

以无 BOM 的 utf⑻ 编号做为文档文件格式;
特定标识符编号的 meta 务必是 head 的第1个立即子元素

XML/HTML Code拷贝內容到剪贴板
  1. <html>  
  2.   <head>  
  3.     <meta charset="utf⑻">  
  4.     ......   
  5.   </head>  
  6.   <body>  
  7.     ......   
  8.   </body>  
  9. </html>  

IE 适配方式

优先选择应用全新版本号的 IE 和 Chrome 核心。

XML/HTML Code拷贝內容到剪贴板
  1. <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">  

SEO 提升

XML/HTML Code拷贝內容到剪贴板
  1. <head>  
  2.     <meta charset="utf⑻">  
  3.     <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">  
  4.     <!-- SEO -->  
  5.     <title>Style Guide</title>  
  6.     <meta name="keywords" content="your keywords">  
  7.     <meta name="description" content="your description">  
  8.     <meta name="author" content="author,email address">  
  9. </head>  

viewport

viewport: 1般指的是访问器对话框內容区的尺寸,不包括专用工具条、选项卡等內容;
width: 访问器宽度,輸出机器设备中的网页页面可见地区宽度;
device-width: 机器设备辨别率宽度,輸出机器设备的显示屏可见宽度;
initial-scale: 原始放缩占比;
maximum-scale: 最大放缩占比;
为挪动端机器设备提升,设定可见地区的宽度和原始放缩占比。

XML/HTML Code拷贝內容到剪贴板
  1. <meta name="viewport" content="width=device-width, initial-scale=1.0">  

iOS 标志

apple-touch-icon 照片全自动解决成圆角和高光等实际效果;
apple-touch-icon-precomposed 严禁系统软件全自动加上实际效果,立即显示信息设计方案原图;

XML/HTML Code拷贝內容到剪贴板
  1. <!-- iPhone 和 iTouch,默认设置 57x57 像素,务必有 -->  
  2. <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon⑸7x57-precomposed.png">  
  3.   
  4. <!-- iPad,72x72 像素,能够沒有,但强烈推荐有 -->  
  5. <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon⑺2x72-precomposed.png" sizes="72x72">  
  6.   
  7. <!-- Retina iPhone 和 Retina iTouch,114x114 像素,能够沒有,但强烈推荐有 -->  
  8. <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon⑴14x114-precomposed.png" sizes="114x114">  
  9.   
  10. <!-- Retina iPad,144x144 像素,能够沒有,但强烈推荐有 -->  
  11. <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;

XML/HTML Code拷贝內容到剪贴板
  1. <link rel="shortcut icon" href="path/to/favicon.ico">  

HEAD 模版

XML/HTML Code拷贝內容到剪贴板
  1. <!DOCTYPE html>  
  2. <html lang="zh-cmn-Hans">  
  3. <head>  
  4.     <meta charset="utf⑻">  
  5.     <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">  
  6.     <title>Style Guide</title>  
  7.     <meta name="description" content="不超出150个标识符">  
  8.     <meta name="keywords" content="">  
  9.     <meta name="author" content="name, email">  
  10.   
  11.     <!-- 为挪动机器设备加上 viewport -->  
  12.     <meta name="viewport" content="width=device-width, initial-scale=1.0">  
  13.   
  14.     <!-- iOS 标志 -->  
  15.     <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon⑸7x57-precomposed.png">  
  16.   
  17.     <link rel="alternate" type="application/rss+xml" title="RSS" href="/rss.xml" />  
  18.     <link rel="shortcut icon" href="path/to/favicon.ico">  
  19. </head>  

HTML 注解

控制模块注解

XML/HTML Code拷贝內容到剪贴板
  1. <!-- 文章内容目录目录控制模块 -->  
  2. <div class="article-list">  
  3. ...   
  4. </div>  
  5. 区块注解   
  6. <!--   
  7. @name: Drop Down Menu   
  8. @description: Style of top bar drop down menu.   
  9. @author: Ashu(Aaaaaashu)   
  10. -->