摘要:通用格式規(guī)范縮進(jìn)一次縮進(jìn)個(gè)空格,不要使用或者混合和空格的縮進(jìn)。語(yǔ)義化根據(jù)使用場(chǎng)景選擇正確的元素有時(shí)被錯(cuò)誤的稱(chēng)為標(biāo)簽。格式規(guī)范引號(hào)屬性值用雙引號(hào)。風(fēng)格規(guī)范和命名使用有含義的和名稱(chēng)。
背景
這篇文章定義了 HTML 和 CSS 的格式和代碼規(guī)范,旨在提高代碼質(zhì)量和協(xié)作效率。
通用樣式規(guī)范協(xié)議
省略圖片、樣式、腳本以及其他媒體文件 URL 的協(xié)議部分(http:,https:),除非文件在兩種協(xié)議下都不可用。這種方案稱(chēng)為 protocol-relative URL,好處是無(wú)論你是使用 HTTPS 還是 HTTP 訪(fǎng)問(wèn)頁(yè)面,瀏覽器都會(huì)以相同的協(xié)議請(qǐng)求頁(yè)面中的資源,同時(shí)可以節(jié)省一部分字節(jié)。
/* Not recommended */ .example { background: url("https://www.google.com/images/example"); }
/* Recommended */ .example { background: url("http://www.google.com/images/example"); }通用格式規(guī)范
縮進(jìn)
一次縮進(jìn)2個(gè)空格,不要使用 tab 或者混合 tab 和空格的縮進(jìn)。
.example { color: blue; }
大小寫(xiě)
以下都應(yīng)該用小寫(xiě):HTML 元素名稱(chēng),屬性,屬性值(除非 text/CDATA),CSS 選擇器,屬性,屬性值。
Home
/* Not recommended */ color: #E5E5E5;
/* Recommended */ color: #e5e5e5;
結(jié)尾空格
結(jié)尾空格不僅多余,而且在比較代碼時(shí)會(huì)更麻煩。
What?_
通用元規(guī)范Yes please.
編碼
在 HTML 中通過(guò) 指定編碼方式,CSS 中不需要指定,因?yàn)槟J(rèn)是 UTF-8。
注釋
使用注釋來(lái)解釋代碼:包含的模塊,功能以及優(yōu)點(diǎn)。
任務(wù)項(xiàng)
用 TODO 來(lái)標(biāo)記待辦事項(xiàng),而不是用一些其他的標(biāo)記,像 @@。
文檔類(lèi)型
HTML 文檔應(yīng)使用 HTML5 的文檔類(lèi)型:。
孤立標(biāo)簽無(wú)需封閉自身,`
?不要寫(xiě)成?
。`
HTML 正確性
盡可能使用正確的 HTML。
Test This is only a test.
Test This is only a test.
語(yǔ)義化
根據(jù)使用場(chǎng)景選擇正確的 HTML 元素(有時(shí)被錯(cuò)誤的稱(chēng)為“標(biāo)簽”)。例如,使用 h1 元素創(chuàng)建標(biāo)題,p 元素創(chuàng)建段落,a 元素創(chuàng)建鏈接等等。正確的使用 HTML 元素對(duì)于可訪(fǎng)問(wèn)性、可重用性以及編碼效率都很重要。
All recommendations
All recommendations
多媒體元素降級(jí)
對(duì)于像圖片、視頻、canvas 動(dòng)畫(huà)等多媒體元素,確保提供其他可訪(fǎng)問(wèn)的內(nèi)容。圖片可以使用替代文本(alt),視頻和音頻可以使用文字版本。
關(guān)注分離
標(biāo)記、樣式和腳本分離,確保相互耦合最小化。
實(shí)體引用
如果團(tuán)隊(duì)中文件和編輯器使用同樣的編碼方式,就沒(méi)必要使用實(shí)體引用,如?—,?”,?,除了一些在 HTML 中有特殊含義的字符(如 < 和 &)以及不可見(jiàn)的字符(如空格)。
The currency symbol for the Euro is “&eur;”.
The currency symbol for the Euro is “€”.
type 屬性
在引用樣式表和腳本時(shí),不要指定 type 屬性,除非不是 CSS 或 JavaScript。因?yàn)?HTML5 中已經(jīng)默認(rèn)指定樣式變的 type 是 text/css,腳本的type 是 text/javascript。
HTML 格式規(guī)范
HTML 引號(hào)
屬性值用雙引號(hào)。
Sign in
Sign inCSS 風(fēng)格規(guī)范
ID 和 Class 命名
使用有含義的 id 和 class 名稱(chēng)。
/* Not recommended: meaningless */ #yee-1901 {} /* Not recommended: presentational */ .button-green {} .clear {}
/* Recommended: specific */ #gallery {} #login {} .video {} /* Recommended: generic */ .aux {} .alt {}
ID 和 Class 命名風(fēng)格
id 和 class 應(yīng)該盡量簡(jiǎn)短,同時(shí)要容易理解。
/* Not recommended */ #navigation {} .atr {}
/* Recommended */ #nav {} .author {}
選擇器
除非需要,否則不要在 id 或 class 前加元素名。
/* Not recommended */ ul#example {} div.error {}
/* Recommended */ #example {} .error {}
屬性簡(jiǎn)寫(xiě)
盡量使用 CSS 中可以簡(jiǎn)寫(xiě)的屬性 (如 font),可以提高編碼效率以及代碼可讀性。
/* Not recommended */ border-top-style: none; font-family: palatino, georgia, serif; font-size: 100%; line-height: 1.6; padding-bottom: 2em; padding-left: 1em; padding-right: 1em; padding-top: 0;
/* Recommended */ border-top: 0; font: 100%/1.6 palatino, georgia, serif; padding: 0 1em 2em;
0 和單位
值為 0 時(shí)不用添加單位。
margin: 0; padding: 0;
開(kāi)頭的 0
值在 -1 和 1 之間時(shí),不需要加 0。
font-size: .8em;
16進(jìn)制表示法
/* Not recommended */ color: #eebbcc;
/* Recommended */ color: #ebc;
前綴
使用帶前綴的命名空間可以防止命名沖突,同時(shí)提高代碼可維護(hù)性。
.adw-help {} /* AdWords */ #maia-note {} /* Maia */
ID 和 Class 命名分隔符
選擇器中使用連字符可以提高可讀性。
/* Not recommended: does not separate the words “demo” and “image” */ .demoimage {} /* Not recommended: uses underscore instead of hyphen */ .error_status {}
/* Recommended */ #video-id {} .ads-sample {}CSS 格式規(guī)范
書(shū)寫(xiě)順序
按照屬性首字母順序書(shū)寫(xiě) CSS 易于閱讀和維護(hù),排序時(shí)忽略帶有瀏覽器前綴的屬性。
background: fuchsia; border: 1px solid; -moz-border-radius: 4px; -webkit-border-radius: 4px; border-radius: 4px; color: black; text-align: center; text-indent: 2em;
塊級(jí)內(nèi)容縮進(jìn)
為了反映層級(jí)關(guān)系和提高可讀性,塊級(jí)內(nèi)容都應(yīng)縮進(jìn)。
@media screen, projection { html { background: #fff; color: #444; } }
聲明結(jié)束
每行 CSS 都應(yīng)以分號(hào)結(jié)尾。
/* Not recommended */ .test { display: block; height: 100px }
/* Recommended */ .test { display: block; height: 100px; }
屬性名結(jié)尾
屬性名和值之間都應(yīng)有一個(gè)空格。
/* Not recommended */ h3 { font-weight:bold; }
/* Recommended */ h3 { font-weight: bold; }
聲明樣式塊的分隔
在選擇器和 {} 之間用空格隔開(kāi)。
/* Not recommended: missing space */ #video{ margin-top: 1em; } /* Not recommended: unnecessary line break */ #video { margin-top: 1em; }
/* Recommended */ #video { margin-top: 1em; }
選擇器分隔
每個(gè)選擇器都另起一行。
/* Not recommended */ a:focus, a:active { position: relative; top: 1px; }
/* Recommended */ h1, h2, h3 { font-weight: normal; line-height: 1.2; }
規(guī)則分隔
規(guī)則之間都用空行隔開(kāi)。
html { background: #fff; } body { margin: auto; width: 50%; }
CSS 引號(hào)
屬性選擇器和屬性值用單引號(hào),URI 的值不需要引號(hào)。
/* Not recommended */ @import url("http://www.google.com/css/maia.css"); html { font-family: "open sans", arial, sans-serif; }
/* Recommended */ @import url(//www.google.com/css/maia.css); html { font-family: "open sans", arial, sans-serif; }CSS 元規(guī)則
分段注釋
用注釋把 CSS 分成各個(gè)部分。
/* Header */ #adw-header {} /* Footer */ #adw-footer {} /* Gallery */ .adw-gallery {}結(jié)語(yǔ)
堅(jiān)持遵循代碼規(guī)范。
寫(xiě)代碼前先看看周?chē)碌拇a,然后決定代碼風(fēng)格。
代碼規(guī)范的意義在于提供一個(gè)參照物。這里提供了一份全局的規(guī)范,但是你也得參照公司內(nèi)部的規(guī)范,否則閱讀你代碼的人會(huì)很痛苦。
轉(zhuǎn)載自:http://www.codeceo.com
文章版權(quán)歸作者所有,未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請(qǐng)注明本文地址:http://specialneedsforspecialkids.com/yun/115465.html
摘要:通用格式規(guī)范縮進(jìn)一次縮進(jìn)個(gè)空格,不要使用或者混合和空格的縮進(jìn)。語(yǔ)義化根據(jù)使用場(chǎng)景選擇正確的元素有時(shí)被錯(cuò)誤的稱(chēng)為標(biāo)簽。格式規(guī)范引號(hào)屬性值用雙引號(hào)。風(fēng)格規(guī)范和命名使用有含義的和名稱(chēng)。和單位值為時(shí)不用添加單位。 原文 Google HTML/CSS Style Guide 背景 這篇文章定義了 HTML 和 CSS 的格式和代碼規(guī)范,旨在提高代碼質(zhì)量和協(xié)作效率。 通用樣式規(guī)范 協(xié)議 圖片,樣...
摘要:通用格式規(guī)范縮進(jìn)一次縮進(jìn)個(gè)空格,不要使用或者混合和空格的縮進(jìn)。語(yǔ)義化根據(jù)使用場(chǎng)景選擇正確的元素有時(shí)被錯(cuò)誤的稱(chēng)為標(biāo)簽。格式規(guī)范引號(hào)屬性值用雙引號(hào)。風(fēng)格規(guī)范和命名使用有含義的和名稱(chēng)。和單位值為時(shí)不用添加單位。 原文 Google HTML/CSS Style Guide 背景 這篇文章定義了 HTML 和 CSS 的格式和代碼規(guī)范,旨在提高代碼質(zhì)量和協(xié)作效率。 通用樣式規(guī)范 協(xié)議 圖片,樣...
摘要:通用格式規(guī)范縮進(jìn)一次縮進(jìn)個(gè)空格,不要使用或者混合和空格的縮進(jìn)。語(yǔ)義化根據(jù)使用場(chǎng)景選擇正確的元素有時(shí)被錯(cuò)誤的稱(chēng)為標(biāo)簽。格式規(guī)范引號(hào)屬性值用雙引號(hào)。風(fēng)格規(guī)范和命名使用有含義的和名稱(chēng)。 背景 這篇文章定義了 HTML 和 CSS 的格式和代碼規(guī)范,旨在提高代碼質(zhì)量和協(xié)作效率。 通用樣式規(guī)范 協(xié)議 省略圖片、樣式、腳本以及其他媒體文件 URL 的協(xié)議部分(http:,https:),除非文件在...
摘要:分享一些超好用插件,打造一個(gè)不一樣的瀏覽器編輯器。一谷歌瀏覽器插件谷歌訪(fǎng)問(wèn)助手強(qiáng)烈推薦一鍵安裝,無(wú)需其他配置,即可訪(fǎng)問(wèn)谷歌。谷歌瀏覽器是很耗內(nèi)存的,該插件會(huì)自動(dòng)掛起長(zhǎng)時(shí)間未使用的網(wǎng)頁(yè),來(lái)釋放系統(tǒng)資源。 showImg(https://segmentfault.com/img/remote/1460000014011338); 分享一些超好用插件,打造一個(gè)不一樣的 GitHub、瀏覽器、...
閱讀 2899·2021-10-27 14:19
閱讀 537·2021-10-18 13:29
閱讀 1128·2021-07-29 13:56
閱讀 3547·2019-08-30 13:19
閱讀 1926·2019-08-29 12:50
閱讀 1035·2019-08-23 18:16
閱讀 3521·2019-08-22 15:37
閱讀 1897·2019-08-22 15:37