團隊HTML規(guī)范

HTML規(guī)范

版本號 作者 時間 版本 內(nèi)容摘要
v1.0 eleven 2018-05-16 1.0.0 文檔初始化

目錄

1.DOCTYPE聲明

HTML文件必須加上 DOCTYPE 聲明,并統(tǒng)一使用 HTML5 的文檔聲明:

    <!DOCTYPE html>

2.頁面語言LANG

推薦使用屬性值 cmn-Hans-CN(簡體, 中國大陸)费变,但是考慮瀏覽器和操作系統(tǒng)的兼容性挚歧,目前仍然使用 zh-CN 屬性值

    <html lang="zh-CN">

3.CHARSET字符編碼

因為 ISO-8859 中字符集大小是有限的吁峻,且在多語言環(huán)境中不兼容,所以 Unicode 聯(lián)盟開發(fā)了 Unicode 標準矮慕。

  • Unicode 標準覆蓋了(幾乎)所有的字符痴鳄、標點符號和符號。

  • Unicode 使文本的處理哼转、存儲和運輸壹蔓,獨立于平臺和語言猫态。

  • HTML-5 中默認的字符編碼是 UTF-8

    <meta charset="UTF-8">

4.元素及標簽閉合

HTML元素共有以下5種:

  • 空元素:area亲雪、base、br虾标、col灌砖、command基显、embed、hr库继、img宪萄、input榨惰、keygen读串、link、meta排监、param杰捂、source嫁佳、track、wbr
  • 原始文本元素:script盛垦、style
  • RCDATA元素:textarea腾夯、title
  • 外來元素:來自MathML命名空間和SVG命名空間的元素蔬充。
  • 常規(guī)元素:其他HTML允許的元素都稱為常規(guī)元素饥漫。

推薦:

<div>
    <h1>我是h1標題</h1>
    <p>我是一段文字,我有始有終积蜻,瀏覽器能正確解析</p>
</div>
<br>

不推薦:

<div>
    <h1>我是h1標題</h1>
    <p>我是一段文字浅侨,我有始無終证膨,瀏覽器亦能正確解析
</div>

<br/>

5.書寫風格

HTML標簽名央勒、類名、標簽屬性和大部分屬性值統(tǒng)一用小寫

推薦:

    <div class="demo"></div>

不推薦:

<div class="DEMO"></div>

<DIV CLASS="DEMO"></DIV>

6.類型的屬性

不需要為 CSS稳吮、JS 指定類型屬性灶似,HTML5 中默認已包含

推薦:

<link rel="stylesheet" href="" >
<script src=""></script>

不推薦:

<link rel="stylesheet" type="text/css" href="" >
<script type="text/javascript" src="" ></script>

7.元素屬性

  • 元素屬性值使用雙引號語法
  • 元素屬性值可以寫上的都寫上

推薦:

<input type="text">

<input type="radio" name="name" checked="checked" >

不推薦:

<input type=text>
<input type='text'>

<input type="radio" name="name" checked >

8.代碼縮進

統(tǒng)一使用四個空格進行代碼縮進酪惭,使得各編輯器表現(xiàn)一致(各編輯器有相關(guān)配置)

推薦:

<div class="fs">
    <a href="#"></a>
</div>

9.純數(shù)字輸入框

使用 type="tel" 而不是 type="number"

推薦:

<input type="tel">

10.代碼嵌套

元素嵌套規(guī)范春感,每個塊狀元素獨立一行,內(nèi)聯(lián)元素可選

推薦:

<div>
    <h1></h1>
    <p></p>
</div>
<p>
    <span></span>
    <span></span>
</p>

不推薦:

<div>
    <h1></h1><p></p>
</div>
<p>
    <span></span>
    <span></span>
</p>

段落元素與標題元素只能嵌套內(nèi)聯(lián)元素

推薦:

<h1>
    <span></span>
</h1>
<p>
    <span></span>
    <span></span>
</p>

不推薦:

<h1>
    <div></div>
</h1>
<p>
    <div></div>
    <div></div>
</p>

11.單行注釋

一般用于簡單的描述,如某些狀態(tài)描述窥岩、屬性描述等

注釋內(nèi)容前后各一個空格字符颂翼,注釋位于要注釋代碼的上面,單獨占一行

推薦:

<!-- Comment Text -->
<div>...</div>

不推薦:

<div>...</div><!-- Comment Text --> 
    
<div><!-- Comment Text -->
    ...
</div>

12.模塊注釋

一般用于描述模塊的名稱以及模塊開始與結(jié)束的位置

注釋內(nèi)容前后各一個空格字符锥累, 表示模塊開始桶略, 表示模塊結(jié)束际歼,模塊與模塊之間相隔一行

推薦:

<!-- S Comment Text A -->   
<div class="mod-a">
    ...
</div>
<!-- E Comment Text A -->
    
<!-- S Comment Text B -->   
<div class="mod-b">
    ...
</div>
<!-- E Comment Text B -->

不推薦:

<!-- S Comment Text A -->
<div class="mod-a">
    ...
</div>
<!-- E Comment Text A -->
<!-- S Comment Text B -->   
<div class="mod-b">
    ...
</div>
<!-- E Comment Text B -->

13.嵌套模塊注釋

當模塊注釋內(nèi)再出現(xiàn)模塊注釋的時候鹅心,為了突出主要模塊纺荧,嵌套模塊不再使用

推薦:

<!-- S Comment Text A -->
<div class="mod-a">
        
    <div class="mod-b">
        ...
    </div>
    <!-- /mod-b -->
        
    <div class="mod-c">
        ...
    </div>
    <!-- /mod-c -->
        
</div>
<!-- E Comment Text A -->

14.移動端HTML模版

推薦:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, shrink-to-fit=no" >
<!-- viewport 后面加上 minimal-ui 在safri 體現(xiàn)效果 -->
<meta name="apple-mobile-web-app-capable" content="yes">
<!-- 隱藏狀態(tài)欄/設(shè)置狀態(tài)欄顏色 -->
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
<!-- uc強制豎屏 -->
<meta name="screen-orientation" content="portrait">
<!-- UC強制全屏 -->
<meta name="full-screen" content="yes">
<!-- UC應用模式 -->
<meta name="browsermode" content="application">
<!-- QQ強制豎屏 -->
<meta name="x5-orientation" content="portrait">
<!-- QQ強制全屏 -->
<meta name="x5-fullscreen" content="true">
<!-- QQ應用模式 -->
<meta name="x5-page-mode" content="app">
<meta name="format-detection" content="telephone=no">
<title>移動端HTML模版</title>

<!-- S DNS預解析 -->
<link rel="dns-prefetch" href="">
<!-- E DNS預解析 --> 
<!-- S 線上樣式頁面片输枯,開發(fā)請直接取消注釋引用 -->
<!-- #include virtual="" -->
<!-- E 線上樣式頁面片 -->
<!-- S 本地調(diào)試占贫,根據(jù)開發(fā)模式選擇調(diào)試方式型奥,請開發(fā)刪除 --> 
<link rel="stylesheet" href="css/index.css" >
<!-- /本地調(diào)試方式 -->
<link rel="stylesheet" href="http://srcPath/index.css" >
<!-- /開發(fā)機調(diào)試方式 -->
<!-- E 本地調(diào)試 -->
</head>
<body>
</body>
</html>

15.PC端HTML模版

推薦:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="keywords" content="your keywords">
<meta name="description" content="your description">
<meta name="author" content="author,email address">
<meta name="robots" content="index,follow">
<meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1">
<meta name="renderer" content="ie-stand">
<title>PC端HTML模版</title>
<!-- S DNS預解析 --> 
<link rel="dns-prefetch" href="">
<!-- E DNS預解析 --> 
<!-- S 線上樣式頁面片,開發(fā)請直接取消注釋引用 -->
<!-- #include virtual="" -->
<!-- E 線上樣式頁面片 -->
<!-- S 本地調(diào)試谐宙,根據(jù)開發(fā)模式選擇調(diào)試方式,請開發(fā)刪除 --> 
<link rel="stylesheet" href="css/index.css" >
<!-- /本地調(diào)試方式 -->
<link rel="stylesheet" href="http://srcPath/index.css" >
<!-- /開發(fā)機調(diào)試方式 -->
<!-- E 本地調(diào)試 -->
</head>
<body>
</body>
</html>

16.script引用統(tǒng)一放在body結(jié)束標簽的前面

因為瀏覽器生成Dom樹的時候是一行一行讀HTML代碼的夹纫,script標簽放在最后面就不會影響前面的頁面的渲染设凹;

推薦:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>PC端HTML模版</title>

</head>
<body>
<script src="http://www.test.com/test.js"></script>
</body>
</html>

不推薦:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>PC端HTML模版</title>
<script src="http://www.test.com/test.js"></script>
</head>
<body>
</body>
</html>

17.defer和async的區(qū)別

<script src="script.js"></script>

沒有 defer 或 async闪朱,瀏覽器會立即加載并執(zhí)行指定的腳本奋姿,“立即”指的是在渲染該 script 標簽之下的文檔元素之前,也就是說不等待后續(xù)載入的文檔元素萍悴,讀到就加載并執(zhí)行寓免。

<script async src="script.js"></script>

有 async袜香,加載和渲染后續(xù)文檔元素的過程將和 script.js 的加載與執(zhí)行并行進行(異步)。

<script defer src="myscript.js"></script>

有 defer实抡,加載后續(xù)文檔元素的過程將和 script.js 的加載并行進行(異步)澜术,但是 script.js 的執(zhí)行要在所有元素解析完成之后猬腰,DOMContentLoaded 事件觸發(fā)之前完成姑荷。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市胯盯,隨后出現(xiàn)的幾起案子计露,更是在濱河造成了極大的恐慌博脑,老刑警劉巖,帶你破解...
    沈念sama閱讀 222,464評論 6 517
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件票罐,死亡現(xiàn)場離奇詭異叉趣,居然都是意外死亡,警方通過查閱死者的電腦和手機该押,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,033評論 3 399
  • 文/潘曉璐 我一進店門疗杉,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人蚕礼,你說我怎么就攤上這事烟具〉斓牛” “怎么了朝聋?”我有些...
    開封第一講書人閱讀 169,078評論 0 362
  • 文/不壞的土叔 我叫張陵,是天一觀的道長囤躁。 經(jīng)常有香客問我玖翅,道長,這世上最難降的妖魔是什么割以? 我笑而不...
    開封第一講書人閱讀 59,979評論 1 299
  • 正文 為了忘掉前任金度,我火速辦了婚禮,結(jié)果婚禮上严沥,老公的妹妹穿的比我還像新娘猜极。我一直安慰自己,他們只是感情好消玄,可當我...
    茶點故事閱讀 69,001評論 6 398
  • 文/花漫 我一把揭開白布跟伏。 她就那樣靜靜地躺著,像睡著了一般翩瓜。 火紅的嫁衣襯著肌膚如雪受扳。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 52,584評論 1 312
  • 那天兔跌,我揣著相機與錄音勘高,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播烁巫,決...
    沈念sama閱讀 41,085評論 3 422
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼蓬戚!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起宾抓,我...
    開封第一講書人閱讀 40,023評論 0 277
  • 序言:老撾萬榮一對情侶失蹤子漩,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后石洗,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體幢泼,經(jīng)...
    沈念sama閱讀 46,555評論 1 319
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 38,626評論 3 342
  • 正文 我和宋清朗相戀三年劲腿,在試婚紗的時候發(fā)現(xiàn)自己被綠了旭绒。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片鸟妙。...
    茶點故事閱讀 40,769評論 1 353
  • 序言:一個原本活蹦亂跳的男人離奇死亡焦人,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出重父,到底是詐尸還是另有隱情花椭,我是刑警寧澤,帶...
    沈念sama閱讀 36,439評論 5 351
  • 正文 年R本政府宣布房午,位于F島的核電站矿辽,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏郭厌。R本人自食惡果不足惜袋倔,卻給世界環(huán)境...
    茶點故事閱讀 42,115評論 3 335
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望折柠。 院中可真熱鬧宾娜,春花似錦、人聲如沸扇售。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,601評論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽承冰。三九已至华弓,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間困乒,已是汗流浹背寂屏。 一陣腳步聲響...
    開封第一講書人閱讀 33,702評論 1 274
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人凑保。 一個月前我還...
    沈念sama閱讀 49,191評論 3 378
  • 正文 我出身青樓冈爹,卻偏偏與公主長得像,于是被迫代替她去往敵國和親欧引。 傳聞我的和親對象是個殘疾皇子频伤,可洞房花燭夜當晚...
    茶點故事閱讀 45,781評論 2 361

推薦閱讀更多精彩內(nèi)容

  • 概要 64學時 3.5學分 章節(jié)安排 電子商務網(wǎng)站概況 HTML5+CSS3 JavaScript Node 電子...
    阿啊阿吖丁閱讀 9,223評論 0 3
  • 第一部分 HTML&CSS整理答案 1. 什么是HTML5? 答:HTML5是最新的HTML標準芝此。 注意:講述HT...
    kismetajun閱讀 27,519評論 1 45
  • HTML 5 HTML5概述 因特網(wǎng)上的信息是以網(wǎng)頁的形式展示給用戶的憋肖,因此網(wǎng)頁是網(wǎng)絡信息傳遞的載體。網(wǎng)頁文件是用...
    阿啊阿吖丁閱讀 3,906評論 0 0
  • 三月的的風啊婚苹, 靜悄悄地溜來岸更, 像俏皮的少女。 春風輕輕吹拂膊升, 吹過樹梢怎炊、枝頭, 吹進人們的心中廓译, 仿若那少女的回...
    廣電1701B夏珊珊閱讀 151評論 0 1
  • 十八歲離家评肆,十八歲不知憂愁。 蘭城里的人是年青的非区,從早到晚瓜挽,路上遇的人都掛著笑。蘭城里的人是暖的征绸,大冒雪的寒冬老漢...
    安子_0b8b閱讀 193評論 1 0