HTML代碼書(shū)寫(xiě)規(guī)范指南
通用約定
標(biāo)簽
自閉合(self-closing)標(biāo)簽,無(wú)需閉合 ( 例如: img input br hr 等 );
可選的閉合標(biāo)簽(closing tag),需閉合 ( 例如:</li> 或 </body>);
盡量減少標(biāo)簽數(shù)量;
- <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 應(yīng)以功能或內(nèi)容命名,不以表現(xiàn)形式命名;
class 與 id 單詞字母小寫(xiě),多個(gè)單詞組成時(shí),采用中劃線-分隔;
使用唯一的 id 作為 Javascript hook,同時(shí)避免創(chuàng)建無(wú)樣式信息的 class;
- <!-- Not recommended -->
- <div class="j-hook left contentWrapper"></div>
- <!-- Recommended -->
- <div id="j-hook" class="sidebar content-wrapper"></div>
屬性順序
HTML 屬性應(yīng)該按照特定的順序出現(xiàn)以保證易讀性。
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="...">
引號(hào)
屬性的定義,統(tǒng)一使用雙引號(hào)。
- <!-- Not recommended -->
- <span id='j-hook' class=text>Google</span>
- <!-- Recommended -->
- <span id="j-hook" class="text">Google</span>
b嵌套
a 不允許嵌套 div 這種約束屬于語(yǔ)義嵌套約束,與之區(qū)別的約束還有嚴(yán)格嵌套約束,比如 a 不允許嵌套 a。
嚴(yán)格嵌套約束在所有的瀏覽器下都不被允許;而語(yǔ)義嵌套約束,瀏覽器大多會(huì)容錯(cuò)處理,生成的文檔樹(shù)可能相互不太一樣。
語(yǔ)義嵌套約束
<li> 用于 <ul> 或 <ol> 下;
<dd>,<dt> 用于 <dl> 下;
<thead>,<tbody>,<tfoot>,<tr>,<td> 用于<table>下;
嚴(yán)格嵌套約束
inline-Level 元素,僅可以包含文本或其它 inline-Level 元素;
<a> 里不可以嵌套交互式元素 <a>、<button>、<select>等;
<p>里不可以嵌套塊級(jí)元素<div>、<h1>~<h6>、<p>、<ul>/<ol>/<li>、<dl>/<dt>/<dd>、<form>等。
布爾值屬性
HTML5 規(guī)范中 disabled、checked、selected 等屬性不用設(shè)置值。
- <input type="text" disabled>
- <input type="checkbox" value="1" checked>
- <select>
- <option value="1" selected>1</option>
- </select>
語(yǔ)義化
沒(méi)有 CSS 的 HTML 是一個(gè)語(yǔ)義系統(tǒng)而不是 UI 系統(tǒng)。
通常情況下,每個(gè)標(biāo)簽都是有語(yǔ)義的,所謂語(yǔ)義就是你的衣服分為外套, 褲子,裙子,內(nèi)褲等,各自有對(duì)應(yīng)的功能和含義。所以你總不能把內(nèi)褲套在脖子上吧。-- 一絲
此外語(yǔ)義化的 HTML 結(jié)構(gòu),有助于機(jī)器(搜索引擎)理解,另一方面多人協(xié)作時(shí),能迅速了解開(kāi)發(fā)者意圖。
常見(jiàn)標(biāo)簽語(yǔ)義
標(biāo)簽 | 語(yǔ)義 |
<p> | 段落 |
<h1><h2><h3>... | 標(biāo)題 |
<ul> | 無(wú)序列表 |
<ol> | 有序列表 |
<blockquote> | 大段引用 |
<cite> | 一般引用 |
為樣式加粗而加粗 | |
<storng> | 為強(qiáng)調(diào)內(nèi)容而加粗 |
<i> | 為樣式傾斜而傾斜 |
<em> | 為強(qiáng)調(diào)內(nèi)容而傾斜 |
code | 代碼標(biāo)識(shí) |
abbr | 縮寫(xiě) |
示例
將你構(gòu)建的頁(yè)面當(dāng)作一本書(shū),將標(biāo)簽的語(yǔ)義對(duì)應(yīng)的其功能和含義;
書(shū)的名稱:<h1>
書(shū)的每個(gè)章節(jié)標(biāo)題: <h2>
章節(jié)內(nèi)的文章標(biāo)題: <h3>
小標(biāo)題 / 副標(biāo)題: <h4> <h5> <h6>
章節(jié)的段落: <p>
HEAD
文檔類型
為每個(gè) HTML 頁(yè)面的第一行添加標(biāo)準(zhǔn)模式(standard mode)的聲明, 這樣能夠確保在每個(gè)瀏覽器中擁有一致的表現(xiàn)。
- <!DOCTYPE html>
- 語(yǔ)言屬性
- <!-- 中文 -->
- <html lang="zh-Hans">
- <!-- 簡(jiǎn)體中文 -->
- <html lang="zh-cmn-Hans">
- <!-- 繁體中文 -->
- <html lang="zh-cmn-Hant">
- <!-- English -->
- <html lang="en">
字符編碼
以無(wú) BOM 的 utf-8 編碼作為文件格式;
指定字符編碼的 meta 必須是 head 的第一個(gè)直接子元素
- <html>
- <head>
- <meta charset="utf-8">
- ......
- </head>
- <body>
- ......
- </body>
- </html>
IE 兼容模式
優(yōu)先使用最新版本的 IE 和 Chrome 內(nèi)核。
- <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
SEO 優(yōu)化
- <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: 一般指的是瀏覽器窗口內(nèi)容區(qū)的大小,不包含工具條、選項(xiàng)卡等內(nèi)容;
width: 瀏覽器寬度,輸出設(shè)備中的頁(yè)面可見(jiàn)區(qū)域?qū)挾龋?br />device-width: 設(shè)備分辨率寬度,輸出設(shè)備的屏幕可見(jiàn)寬度;
initial-scale: 初始縮放比例;
maximum-scale: 最大縮放比例;
為移動(dòng)端設(shè)備優(yōu)化,設(shè)置可見(jiàn)區(qū)域的寬度和初始縮放比例。
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
iOS 圖標(biāo)
apple-touch-icon 圖片自動(dòng)處理成圓角和高光等效果;
apple-touch-icon-precomposed 禁止系統(tǒng)自動(dòng)添加效果,直接顯示設(shè)計(jì)原圖;
- <!-- iPhone 和 iTouch,默認(rèn) 57x57 像素,必須有 -->
- <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-57x57-precomposed.png">
- <!-- iPad,72x72 像素,可以沒(méi)有,但推薦有 -->
- <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-72x72-precomposed.png" sizes="72x72">
- <!-- Retina iPhone 和 Retina iTouch,114x114 像素,可以沒(méi)有,但推薦有 -->
- <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-114x114-precomposed.png" sizes="114x114">
- <!-- Retina iPad,144x144 像素,可以沒(méi)有,但推薦有 -->
- <link rel="apple-touch-icon-precomposed" href="/apple-touch-icon-144x144-precomposed.png" sizes="144x144">
favicon
在未指定 favicon 時(shí),大多數(shù)瀏覽器會(huì)請(qǐng)求 Web Server 根目錄下的 favicon.ico。為了保證 favicon 可訪問(wèn),避免 404,必須遵循以下兩種方法之一:
在 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-8">
- <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
- <title>Style Guide</title>
- <meta name="description" content="不超過(guò)150個(gè)字符">
- <meta name="keywords" content="">
- <meta name="author" content="name, email@gmail.com">
- <!-- 為移動(dòng)設(shè)備添加 viewport -->
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
- <!-- iOS 圖標(biāo) -->
- <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 注釋
模塊注釋
- <!-- 文章列表列表模塊 -->
- <div class="article-list">
- ...
- </div>
- 區(qū)塊注釋
- <!--
- @name: Drop Down Menu
- @description: Style of top bar drop down menu.
- @author: Ashu(Aaaaaashu@gmail.com)
- -->
上一篇:舉例講解HTML中iframe和frame的區(qū)別
欄 目:CSS/HTML
下一篇:HTML實(shí)現(xiàn)頁(yè)面自動(dòng)跳轉(zhuǎn)的五種方法
本文標(biāo)題:HTML代碼書(shū)寫(xiě)規(guī)范指南
本文地址:http://mengdiqiu.com.cn/a1/CSS_HTML/9661.html
您可能感興趣的文章
- 04-02表格樣式css樣式,css樣式表單
- 04-02好看的字體樣式css,好看的字體樣式圖片
- 04-02html中加入css樣式的簡(jiǎn)單介紹
- 01-10通過(guò)html為FLASH加鏈接的實(shí)現(xiàn)代碼(div層)
- 01-10IE瀏覽器HTML Hack標(biāo)簽總結(jié)
- 01-10html用style添加屬性示例
- 01-10HTML中rel屬性分析
- 01-10HTML元素設(shè)置焦點(diǎn)的方法
- 01-10在html文件里include文件內(nèi)容的方法小結(jié)
- 01-10常用HTML meta 標(biāo)簽屬性(網(wǎng)站兼容與優(yōu)化需要)


閱讀排行
- 1C語(yǔ)言 while語(yǔ)句的用法詳解
- 2java 實(shí)現(xiàn)簡(jiǎn)單圣誕樹(shù)的示例代碼(圣誕
- 3利用C語(yǔ)言實(shí)現(xiàn)“百馬百擔(dān)”問(wèn)題方法
- 4C語(yǔ)言中計(jì)算正弦的相關(guān)函數(shù)總結(jié)
- 5c語(yǔ)言計(jì)算三角形面積代碼
- 6什么是 WSH(腳本宿主)的詳細(xì)解釋
- 7C++ 中隨機(jī)函數(shù)random函數(shù)的使用方法
- 8正則表達(dá)式匹配各種特殊字符
- 9C語(yǔ)言十進(jìn)制轉(zhuǎn)二進(jìn)制代碼實(shí)例
- 10C語(yǔ)言查找數(shù)組里數(shù)字重復(fù)次數(shù)的方法
本欄相關(guān)
- 04-02表格樣式css樣式,css樣式表單
- 04-02好看的字體樣式css,好看的字體樣式圖
- 04-02分頁(yè)樣式css,分頁(yè)樣式j(luò)q
- 04-02分頁(yè)樣式css,分頁(yè)樣式欄里用來(lái)定義首
- 04-02css樣式的引入,css樣式怎么引入
- 04-02css滾動(dòng)條樣式,css滾動(dòng)條的樣式
- 04-02css樣式引入方式有幾種,網(wǎng)頁(yè)引入css樣
- 04-02html中加入css樣式的簡(jiǎn)單介紹
- 04-02vue中的css樣式布局,vue添加css樣式
- 04-02內(nèi)嵌樣式css,內(nèi)嵌樣式表,內(nèi)部樣式表
隨機(jī)閱讀
- 08-05織夢(mèng)dedecms首頁(yè)調(diào)用縮略圖為背景
- 01-10bat批處理徹底隱藏文件的方法(使用
- 01-10vue實(shí)現(xiàn)分頁(yè)加載效果
- 08-05dedecms織夢(mèng)模板全站調(diào)用收藏?cái)?shù)的方法
- 01-11常用的HTML富文本編譯器UEditor、CKEdi
- 01-10C++ 類訪問(wèn)控制的條件總結(jié)
- 08-05dedecms織夢(mèng)模板編輯文檔的同時(shí)自動(dòng)更
- 08-05DEDECMS點(diǎn)擊主欄目默認(rèn)顯示第一個(gè)子欄
- 01-10C++實(shí)現(xiàn)將數(shù)組中的值反轉(zhuǎn)
- 01-10C語(yǔ)言打印楊輝三角示例匯總