CSS 樣式書寫規(guī)范

Ba la la la ~ 讀者朋友們,你們好啊,又到了冷鋒時間,話不多說,發(fā)車!


編碼設置

采用 UTF-8 編碼,在 CSS 代碼頭部使用:

@charset "utf-8";

注意,必須要定義在 CSS 文件所有字符的前面(包括編碼注釋),@charset 才會生效。

例如,下面的例子都會使得 @charset 失效:

/* 字符編碼 */
@charset "utf-8";
html,
body {
height: 100%;
}

@charset "utf-8";

命名空間規(guī)范

布局:以 g 為命名空間,例如:.g-wrap 、.g-header、.g-content。
狀態(tài):以 s 為命名空間,表示動態(tài)的、具有交互性質的狀態(tài),例如:.s-current、s-selected。
工具:以 u 為命名空間,表示不耦合業(yè)務邏輯的、可復用的的工具,例如:u-clearfix、u-ellipsis。
組件:以 m 為命名空間,表示可復用、移植的組件模塊,例如:m-slider、m-dropMenu。
鉤子:以 j 為命名空間,表示特定給 JavaScript 調用的類名,例如:j-request、j-open。

命名空間思想

沒有選擇 BEM 這種命名過于嚴苛及樣式名過長過丑的規(guī)則,采取了一種比較折中的方案。

不建議使用下劃線 _ 進行連接

節(jié)省操作,輸入的時候少按一個 shift 鍵
能良好區(qū)分 JavaScript 變量命名

字符小寫

定義的選擇器名,屬性及屬性值的書寫皆為小寫。

選擇器

當一個規(guī)則包含多個選擇器時,每個選擇器獨占一行。

、+、~、> 選擇器的兩邊各保留一個空格。

.g-header > .g-header-des,
.g-content ~ .g-footer {

}

命名短且語義化良好

對于選擇器的命名,盡量簡潔且具有語義化,不應該出現 g-abc 這種語義模糊的命名。

規(guī)則聲明塊

當規(guī)則聲明塊中有多個樣式聲明時,每條樣式獨占一行。
在規(guī)則聲明塊的左大括號 { 前加一個空格。
在樣式屬性的冒號 : 后面加上一個空格,前面不加空格。
在每條樣式后面都以分號 ; 結尾。
規(guī)則聲明塊的右大括號 } 獨占一行。
每個規(guī)則聲明間用空行分隔。
所有最外層引號使用單引號 ‘ 。
當一個屬性有多個屬性值時,以逗號 , 分隔屬性值,每個逗號后添加一個空格,當單個屬性值過長時,每個屬性值獨占一行。

完整示例如下:

.g-footer,
.g-header {
position: relative;
}

.g-content {
background:
linear-gradient(135deg, deeppink 25%, transparent 25%) -50px 0,
linear-gradient(225deg, deeppink 25%, transparent 25%) -50px 0,
linear-gradient(315deg, deeppink 25%, transparent 25%),
linear-gradient(45deg, deeppink 25%, transparent 25%);
}

.g-content::before {
content: '';
}

數值與單位

當屬性值或顏色參數為 0 – 1 之間的數時,省略小數點前的 0 。color: rgba(255, 255, 255, 0.5)color: rgba(255, 255, 255, .5);
當長度值為 0 時省略單位。margin: 0px automargin: 0 auto
十六進制的顏色屬性值使用小寫和盡量簡寫。color: #ffcc00color: #fc0

樣式屬性順序

單個樣式規(guī)則下的屬性在書寫時,應按功能進行分組,并以 Positioning Model > Box Model > Typographic > Visual 的順序書寫,提高代碼的可讀性。

如果包含 content 屬性,應放在最前面;
Positioning Model 布局方式、位置,相關屬性包括:position / top / right / bottom / left / z-index / display / float / …
Box Model 盒模型,相關屬性包括:width / height / padding / margin / border / overflow / …
Typographic 文本排版,相關屬性包括:font / line-height / text-align / word-wrap / …
Visual 視覺外觀,相關屬性包括:color / background / list-style / transform / animation / transition / …

Positioning 處在第一位,因為他可以使一個元素脫離正常文本流,并且覆蓋盒模型相關的樣式。盒模型緊跟其后,因為他決定了一個組件的大小和位置。其他屬性只在組件內部起作用或者不會對前面兩種情況的結果產生影響,所以他們排在后面。

合理使用使用引號

在某些樣式中,會出現一些含有空格的關鍵字或者中文關鍵字。

font-family 內使用引號

當字體名字中間有空格,中文名字體及 Unicode 字符編碼表示的中文字體,為了保證兼容性,都建議在字體兩端添加單引號或者雙引號:

body {
font-family: 'Microsoft YaHei', '黑體-簡', '\5b8b\4f53';
}

background-image 的 url 內使用引號

如果路徑里面有空格,舊版 IE 是無法識別的,會導致路徑失效,建議不管是否存在空格,都添加上單引號或者雙引號:

div {
background-image: url('...');
}

避免使用 !important

除去某些極特殊的情況,盡量不要不要使用 !important。

!important 的存在會給后期維護以及多人協(xié)作帶來噩夢般的影響。

當存在樣式覆蓋層疊時,如果你發(fā)現新定義的一個樣式無法覆蓋一個舊的樣式,只有加上 !important 才能生效時,是因為你新定義的選擇器的優(yōu)先級不夠舊樣式選擇器的優(yōu)先級高。所以,合理的書寫新樣式選擇器,是完全可以規(guī)避一些看似需要使用 !important 的情況的。

代碼注釋

單行注釋

星號與內容之間必須保留一個空格。

/* 表格隔行變色 */

多行注釋

星號要一列對齊,星號與內容之間必須保留一個空格。

/**

  • Sometimes you need to include optional context for the entire component. Do that up here if it's important enough.
    */

規(guī)則聲明塊內注釋

使用 // 注釋,// 后面加上一個空格,注釋獨立一行。

.g-footer {
border: 0;
// ....
}

文件注釋

文件頂部必須包含文件注釋,用 @name 標識文件說明。星號要一列對齊,星號與內容之間必須保留一個空格,標識符冒號與內容之間必須保留一個空格。

/**

  • @name: 文件名或模塊名
  • @description: 文件或模塊描述
  • @author: author-name(mail-name@domain.com)
  •      author-name2(mail-name2@domain.com)
    
  • @update: 2015-04-29 00:02
    */

@description為文件或模塊描述。
@update為可選項,建議每次改動都更新一下。

當該業(yè)務項目主要由固定的一個或多個人負責時,需要添加@author標識,一方面是尊重勞動成果,另一方面方便在需要時快速定位責任人。

SASS 使用建議

嵌套層級規(guī)定

使用 SASS 、 LESS 等預處理器時,建議嵌套層級不超過 3 層。

組件/公用類的使用方法

組件/公用類使用 %placeholders 定義,使用 @extend 引用。如:

%clearfix {

overflow: auto;
zoom: 1;
}

.g-header {
@extend %clearfix;
}

組件類的思考

使用 SASS ,經常會預先定義好一些常用公用組件類,譬如清除浮動,水平垂直居中,文字 ellipsis。又或者多個元素具有同樣的樣式,我們希望能夠少寫這部分代碼,公共部分抽離出來只寫一次,達到復用。

但是復用的方式在 SASS 中有多種,那么是使用單獨使用一個類定義,給需要的標簽添加,還是使用 @include 或者 @extend在定義的類中引入一個 @mixin,或者一個 @function 呢?

基于讓 CSS 更簡潔以及代碼的復用考慮,采用上面的使用 %placeholders 定義,使用 @extend 引用的方案。

%placeholders,只是一個占位符,只要不通過 @extend 調用,編譯后不會產生任何代碼量
使用 @extend 引用,則是因為每次調用相同的 %placeholders 時,編譯出來相同的 CSS 樣式會進行合并(反之,如果使用 @include 調用定義好的 @mixin,編譯出來相同的 CSS 樣式不會進行合并)
這里的組件類特指那些不會動態(tài)改變的 CSS 樣式,注意與那些可以通過傳參生成不同數值樣式的 @mixin 方法進行區(qū)分

盡量避免使用標簽名

使用 SASS ,或者說在 CSS 里也有這種困惑。

假設我們有如下 html 結構:

<span>
<div class="g-content">
<ul class="g-content-list"><li class="item"/>
<li class="item"/>
<li class="item"/>
<li class="item"/>
</ul></div>
</span>

在給最里層的標簽命名書寫樣式的時候,我們有兩種選擇:

.g-content {
.g-content-list {
li {
...
}
}
}

或者是

.g-content {
.g-content-list {
.item {
...
}
}
}

也就是,編譯之后生成了下面這兩個,到底使用哪個好呢?

.g-content .g-content-list li { }
.g-content .g-content-list .item { }

基于 CSS 選擇器的解析規(guī)則(從右向左),建議使用上述第二種 .g-content .g-content-list .item { } ,避免使用通用標簽名作為選擇器的一環(huán)可以提高 CSS 匹配性能。

瀏覽器的排版引擎解析 CSS 是基于從右向左(right-to-left)的規(guī)則,這么做是為了使樣式規(guī)則能夠更快地與渲染樹上的節(jié)點匹配。


以上為個人意見,如有雷同,純屬巧合,歡迎大家多提意見!Bey 了 個 Bey ~

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

相關閱讀更多精彩內容

  • 文章整理了Web前端開發(fā)中的各種CSS規(guī)范,包括文件規(guī)范、注釋規(guī)范、命名規(guī)范、書寫規(guī)范、測試規(guī)范等。 一、文件規(guī)范...
    二狗子沒有夏天閱讀 1,972評論 0 35
  • Spring Cloud為開發(fā)人員提供了快速構建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務發(fā)現,斷路器,智...
    卡卡羅2017閱讀 136,569評論 19 139
  • 轉載請聲明 原文鏈接地址 關注公眾號獲取更多資訊 第一部分 HTML 第一章 職業(yè)規(guī)劃和前景 職業(yè)方向規(guī)劃定位...
    前端進階之旅閱讀 16,878評論 32 459
  • 尚未走過的路 樹林里有兩條路,朝著兩個方向 我走上那條人跡罕至的路 于是,看到了一番完全不同的景象 ...
    程意涼閱讀 434評論 4 7
  • 我每天都會看到我死去的模樣,親人的痛哭與后悔,我的不舍與眼淚。我就像會飛一樣,在他們的八點鐘方向無聲的關注...
    L里予閱讀 280評論 0 4

友情鏈接更多精彩內容