Philip Walton 在 AppFolio 擔任前端工程師,曾在 Santa Barbara on Rails 聚會上分享 CSS 架構與最佳實踐,並在工作團隊中長期沿用。本文整理其核心觀點。
擅長 CSS 的開發者不只能還原視覺稿,還能用程式碼做出漂亮的呈現:少用表格、少用圖片,並快速把 media query、過渡、濾鏡、變形等新特性導入專案。但有趣的是,CSS 很少被單獨拿出來討論,也很少被當成評估開發者能力的依據。
我們對其他語言並不會這樣。Rails 開發者寫出乾淨的程式碼,只會被視為基本門檻,而不是加分項——除此之外還要看可讀性、可修改性、可擴充性。CSS 並沒有任何本質上的不同。今天的 Web 應用規模遠超以往,一個缺乏深思的樣式架構會持續拖慢開發速度,實在沒有理由把它當成「事後再說」或「設計師的事」。
CSS 社群很難對「最佳實踐」達成共識,CSS Lint 發布後的討論就是例證。所以與其背誦規則,不如先確立目標。好的架構必須同時做到四件事:
CSS Code復制內容到剪貼板
.widget {
background: yellow;
border: 1px solid black;
color: black;
width: 50%;
}
#sidebar .widget {
width: 200px;
}
body.homepage .widget {
background: white;
}
乍看無害,但 widget 的行為變得不可預期:同一個元件在不同位置會長得不一樣。它也不可重用、難以擴展,而且一旦要重新設計,你得回頭改好幾處樣式。這其實違反了軟體開發的開放/封閉原則——實體應對擴展開放、對修改封閉。
有些文章會主張完全不使用 class 或 id 選擇器,全靠標籤與組合器。但實作經驗告訴我,選擇器越複雜,與 HTML 結構的耦合就越深。
CSS Code復制內容到剪貼板
#main-nav ul li ul li div { }
#content article h1:first-child { }
#sidebar > div > h3 + p { }
這三段分別想處理下拉選單、文章主標題、側邊欄首段間距。若 HTML 永不變動,倒也無妨,但這並不現實。第一個例子若換到沒有 #main-nav 的頁面就得重寫;第三個例子只要 div 內的標記層級一改,規則立刻失效。
建立可重用元件時,用後代選擇器覆寫子元素很常見:
CSS Code復制內容到剪貼板
.widget {}
.widget .title {}
.widget .contents {}
.widget .action {}
這能避免樣式外溢到別處,但擋不住同名的其他元件吃到這些樣式。大型專案裡,.title 這種名稱被重複使用的機率極高,一旦發生,畫面就會出現難以追查的偏差。
CSS Code復制內容到剪貼板
.widget {
position: absolute;
top: 20px;
left: 20px;
background-color: red;
font-size: 1.5em;
text-transform: uppercase;
}
問題在於這個選擇器同時規定了位置與外觀。外觀可以通用,位置不行。結果團隊需要類似元件時,往往不是重寫,而是複製貼上——重複工作就這樣產生了。
這些反模式有個共通點:讓 CSS 承擔了過多責任。
內容與表現分離是好事,但「CSS 獨立於 HTML」並不等於「內容必須從表現中分離」。HTML 向來不只是內容,它也承載整體結構;container 元素的存在正是為了讓 CSS 能隔離特定元素。因此在當前技術條件下,明智地把 HTML 與 CSS 一起當作表現層,再用模板與 partials 去分離內容層,反而是更務實的做法。
核心原則是:CSS 應定義元素的視覺特徵,而不論該元素出現在何處。如果某元件在不同場合需要不同外觀,就給它不同的名稱。
例如 CSS 用 .button 定義按鈕樣式,HTML 想讓某元素看起來像按鈕就掛上這個 class;若這個按鈕需要更大更寬,就再定義一個新 class 來表達差異。CSS 賦予特徵、HTML 決定調用,讓較少的 CSS 能被更多的 HTML 結構複用。
在標記中明確宣告元素外觀,還有個附加好處:其他開發者讀標記就能預期畫面長相,不容易把「刻意設定」與「意外繼承」搞混。
常見的疑慮是「標記裡塞一堆 class 很醜、很費工」。這種擔憂可以理解,但容易誤導視角:無論你用父選擇器還是在 HTML 寫上對應 class,都同樣需要付出選擇成本。搭配模板系統,同層級的抽象可以在 HTML 中維持良好可讀性,不必反覆書寫相同 class。
避免誤傷最好的方式,就是不給機會。#main-nav ul li ul 很容易套到不該套的元素上,而 .subnav 不會。把 class 直接掛在目標元素上,最能維持可預測性。
CSS Code復制內容到剪貼板
/* 手榴彈:擴散範圍難以控制 */
#main-nav ul li ul { }
/* 狙擊槍:精準命中 */
.subnav { }
結構良好的元件層能鬆開 HTML 與 CSS 的耦合。元件本身也應模組化:知道如何呈現自己,但不要對版面、定位與周圍元素的關係做太多假設。原則上,CSS 定義外觀(background、color、font),版面與定位交給獨立的 layout class 或容器元素負責。
CSS Code復制內容到剪貼板
/* 樣式交叉污染風險高 */
.widget { }
.widget .title { }
/* 風險低 */
.widget { }
.widget-title { }
為 class 加上命名空間能維持元件的獨立性,把命名衝突降到最低。
CSS Code復制內容到剪貼板
/* 不佳 */
.widget { }
#sidebar .widget { }
/* 良好 */
.widget { }
.widget-sidebar { }
基於位置的覆寫只能在特定位置生效;修飾符類則可以在任何地方重複使用,這顯然更符合 HTML 開發者的需求。
Jonathan Snook 在《SMACSS》中把 CSS 分成四類:基礎(base,重置與元素預設值)、版面(layout,全站定位與網格系統)、模組(modules,可重用的視覺元件)、狀態(state,可由 JavaScript 開關的樣式)。
這裡有個實用區分:元件是獨立完整的視覺元素;模板則是更小的建構塊,很少單獨呈現,而是組合成元件。以互動對話框為例,漸層標頭、外圍陰影、右上角關閉鈕、水平垂直居中定位——這四個模式組成了這個模組元件,且都能被其他頁面反覆使用。
大型網站常見一種困境:某個元素掛著一個 class,沒人知道能不能刪,於是越積越多。原因是 class 在這個生態裡承擔了太多角色:樣式化、JavaScript hook、特性偵測、自動化測試。
解法是用命名慣例把用途標示出來,例如 JavaScript 用的加 .js- 前綴,Modernizr 產生的加 .supports-,沒有前綴的即為樣式用途。這樣一來,找出未使用的 class 甚至可以用腳本比對 document.styleSheets 自動完成。把功能與外觀分離,也能避免樣式與腳本互相牽制。
多數人習慣用連字號分隔詞彙,但單靠連字號無法區分類別。Nicolas Gallagher 提出的方案廣受好評,格式如下:
CSS Code復制內容到剪貼板
/* 模板規則(使用 Sass placeholder) */
%template-name
%template-name--modifier-name
%template-name__sub-object
%template-name__sub-object--modifier-name
/* 元件規則 */
.component-name
.component-name--modifier-name
.component-name__sub-object
.component-name__sub-object--modifier-name
/* 版面規則 */
.l-layout-method
.grid
/* 狀態規則 */
.is-state-type
/* 非樣式用途的 JS hook */
.js-action-name
重寫開頭那個例子:
CSS Code復制內容到剪貼板
/* 元件 */
.button-group { }
/* 元件的修飾符 */
.button--primary { }
/* 元件的子物件 */
.button__icon { }
/* 版面類別 */
.l-header { }
這樣的命名讓人一眼就能判斷 class 的層級與所處位置,同時也讓自動化測試變得可行。
預處理器能加速撰寫,但有些「功能」若用錯反而傷害架構。以下幾點建議避免:
@extend,它不是單一 class,從設計角度來看毫無意義,還會讓編譯後的 CSS 膨脹。@extend 去繼承 UI 元件,否則會失去繼承鏈。@extend 與 %placeholder 其實是兩個很好用的功能,能協助管理抽象而不引入多餘的基類。但初次使用時容易誤用在修飾符上:
CSS Code復制內容到剪貼板
.button {
/* 按鈕樣式 */
}
/* 不佳 */
.button--primary {
@extend .button;
/* 修飾樣式 */
}
這會讓 HTML 中失去繼承鏈,也很難用 JavaScript 選取所有按鈕實例。一般的原則是:很少去擴展 UI 元件。這也是區分模板與元件的關鍵——模板不參與應用邏輯,可以安全地被擴展。
CSS Code復制內容到剪貼板
.modal {
@extend %dialog;
@extend %drop-shadow;
@extend %statically-centered;
/* 其他樣式 */
}
.modal__close {
@extend %dialog__close;
/* 其他樣式 */
}
.modal__header {
@extend %background-gradient;
/* 其他樣式 */
}
由 Nicole Sullivan 與 Nicholas Zakas 開發的程式碼品質檢測工具,除了基本語法檢查,還能用一套可擴充的規則找出潛在問題。建議開啟的規則包括:
js- 開頭(除非確為 JS hook)。l- 前綴的規則中 frequent 使用版面與定位屬性時應提出警告。CSS 不只是視覺設計,寫 CSS 時也沒必要把其他語言累積的經驗全拋在腦後。OOP、DRY、開放封閉原則、職責分離,這些觀念同樣適用於樣式表。無論你採用哪一套組織方式,最終判斷標準只有一個:它是否真的讓開發更輕鬆、維護更容易。