DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> CSS入門知識 >> CSS詳解
CSS 命名規範與撰寫規範完整指南
編輯:CSS詳解     

樣式表寫到幾千行之後,能不能維持下去,靠的不是聰明而是規律。以下從檔案命名、class/id 命名、撰寫方法、註解、縮寫到 hack,整理一套可直接套用的慣例。

一、檔案命名規範

依職責切檔,避免所有規則塞進一個巨型檔案:

  • 全域樣式:global.css
  • 框架布局:layout.css
  • 字體樣式:font.css
  • 連結樣式:link.css
  • 列印樣式:print.css

檔案名一律小寫、以連字號分隔單字,不用空格、底線或大駝峰,這能避開 IIS 與 Unix 主機之間的大小寫與字元相容問題。

二、常用 class/id 命名對照

  • 頁眉 header/內容 content/容器 container/頁腳 footer/版權 copyright
  • 導航 menu/主導航 mainMenu/子導航 subMenu
  • 標誌 logo/標語 banner/標題 title
  • 側邊欄 sidebar/圖示 icon/註釋 note
  • 搜尋 search/按鈕 btn/登入 login/連結 link
  • 資訊框 manage

命名應以常見英文單字為準,做到通俗易懂,並在關鍵處加註釋。二級命名採組合式,後一個單字首字母大寫:搜尋框為 searchInput、搜尋圖示為 searchIcon、搜尋按鈕為 searchBtn。

幾個實務原則:語意優先於外觀(寫 warning 而不是 red-text,因為需求變了顏色可能改成橘色);避免拼音與中英混雜;同一專案內只能有一套慣例,中途混用比任何單一慣例都糟糕。

三、常規撰寫方法

1. 選擇 DOCTYPE

XHTML 1.0 提供三種 DTD 宣告:

過渡型(Transitional)——要求寬鬆,允許繼續使用 HTML4.01 的表現層標識:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

嚴格型(Strict)——禁止使用任何表現層標識與屬性:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
  "https://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">

框架型(Frameset)——頁面含框架時使用:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"
  "https://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">

理想情況當然是嚴格型,但對剛接觸標準的團隊而言,過渡型是務實的起點,因為它仍允許表現層標識,也較容易通過 W3C 校驗。而今天的正確答案很單純:新專案請直接用 <!DOCTYPE html>(HTML5)。它會觸發所有現代瀏覽器的標準模式,不必再糾結三種 DTD。

2. 指定語言與字元集

<html xmlns="https://www.w3.org/1999/xhtml" lang="zh-Hant">

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

<?xml version="1.0" encoding="utf-8"?>

<meta http-equiv="Content-Language" content="zh-Hant" />

字元集建議統一採用 UTF-8。HTML5 中可簡化為 <meta charset="utf-8">,且必須放在 <head> 的前 1024 bytes 內才保證生效。

3. 樣式表的引用方式

內部嵌入——直接寫在 head 區:

<style type="text/css"><!--
body { background: white; color: black; }
//--></style>

外部引用——獨立 .css 檔後在 head 中連結:

<link rel="stylesheet" rev="stylesheet" href="css/style.css" type="text/css" media="all" />

符合標準的實作應優先使用外部引用:不必改動 HTML 就能調整樣式;若所有頁面共用同一份樣式表,改一個檔案即可全域生效,同時也讓瀏覽器能快取該檔案。

4. 選用恰當的元素

依文件結構挑選元素,而不是依它長什麼樣子。段落用 p,而不是為了換行才用 p;找不到合適元素時才考慮通用的 div 或 span。

避免過度使用 div 與 span:少量而精準地使用能讓結構更清晰;濫用則會產生「div 湯」,語意全失。同時盡可能減少標籤與巢狀層數,這不只讓結構清楚,也能縮小檔案、加快下載、降低瀏覽器解析與重繪的成本。

5. 善用衍生選擇器

可用衍生(後代)選擇器為某元素的子元素定義樣式,既省去額外命名,也讓結構關係一目了然:

.mainMenu ul li { background: url(images/bg.gif); }

6. 輔助性圖片改用背景圖

這裡的「輔助圖片」指不屬於頁面內容、只用於裝飾/間隔/提示的圖片。改用 CSS 背景處理,日後要換圖不必動 HTML:

#logo {
  background: url(images/logo.jpg) #FEFEFE no-repeat right bottom;
}

反之,屬於內容本體的圖片(新聞配圖、產品照)應保留 img 標籤並填寫 alt,因為它有意義、需要被搜尋引擎與螢幕閱讀器理解。

7. 結構與樣式分離

HTML 只描述結構與語意,樣式全部寫在 CSS 檔中透過外部引用載入。這是「可維護性」的起點,也是更換介面主題時不必觸碰內容的前提。

8. 結構化撰寫

<div id="mainMenu">
  <ul>
    <li><a href="#">首頁</a></li>
    <li><a href="#">關於</a></li>
    <li><a href="#">服務</a></li>
  </ul>
</div>

/* ===== 主導航 ===== */
#mainMenu {
  width: 100%;
  height: 30px;
  background: url(images/mainMenu_bg.jpg) repeat-x;
}
#mainMenu ul li {
  float: left;
  line-height: 30px;
  margin-right: 1px;
  cursor: pointer;
}
/* ===== 主導航結束 ===== */

CSS 檔應採結構化寫法:以區塊註解切分功能段落、同一元件的所有規則集中在相鄰位置、宣告順序由外而內(定位 → 盒模型 → 字體 → 裝飾)。這樣三個月後回頭看,還能快速定位。

9. 游標手型

在 XHTML 標準中,hand 只有 IE 認得;需要游標變成手型時應寫 cursor: pointer;。

四、註解撰寫規範

行間註解——寫在屬性值後方,說明單一宣告的意圖:

.search {
  border: 1px solid #fff;   /* 定義搜尋輸入框邊框 */
  background: url(../images/icon.gif) no-repeat #333;  /* 定義搜尋框背景 */
}

整段註解——在區塊前後各加一行,標示範圍:

/* ===== 搜尋條 ===== */
.search {
  border: 1px solid #fff;
  background: url(../images/icon.gif) no-repeat #333;
}
/* ===== 搜尋條結束 ===== */

五、樣式屬性縮寫

1. 合併相同宣告

兩個類別有部分甚至全部相同的屬性時應予合併。多個類別共用大量宣告時,合併能顯著減少程式碼量:

#mainMenu, #subMenu {
  background: url(../images/bg.gif);
  border: 1px solid #333;
  width: 100%;
  overflow: hidden;
}
#mainMenu { height: 30px; }
#subMenu  { height: 20px; }

2. 同屬性的值縮寫

/* 冗長寫法 */
.search {
  background-color: #333;
  background-image: url(../images/icon.gif);
  background-repeat: no-repeat;
  background-position: 50% 50%;
}
/* 縮寫後 */
.search { background: #333 url(../images/icon.gif) no-repeat 50% 50%; }

3. 邊框與間距縮寫

順序固定為上、右、下、左(順時針)。四值全不同:

.btn { margin: 10px 8px 12px 5px; }

上下相同、左右相同時可寫兩值:

.btn { margin: 10px 5px; }

四值全同則寫一值:

.btn { margin: 10px; }

另有三值寫法:上、左右、下,例如 margin: 10px 5px 20px;。border 亦可縮寫,如 border: 1px solid #333;。

4. 色彩值縮寫

當 RGB 兩兩成對相同時可縮為三位:

.menu { color: #ff3333; }  →  .menu { color: #f33; }

六、Hack 撰寫規範

各家瀏覽器對標準的支援程度不同,呈現結果也就有差異(例如 IE 與 Firefox 在不少情況下存在 3px 的落差)。這些差異需要靠 hack 調整,但沒有必要時最好不要寫 hack,以免為了修一個問題而製造另一個。

IE6/IE7/Firefox 的相容寫法

寫法一:星號與 !important

規則是:IE 系列認得 *,標準瀏覽器不認;IE6 認得 * 但不認 !important;IE7 兩者皆認;Firefox 不認 * 但認 !important。

.searchInput {
  background-color: #333;               /* 三者皆可 */
  *background-color: #666 !important;   /* 僅 IE7 */
  *background-color: #999;              /* 僅 IE6 及以下 */
}

撰寫順序為 Firefox → IE7 → IE6。

寫法二:底線前綴

IE6 認得 _,IE7 與 Firefox 皆不認:

.searchInput {
  background-color: #333;   /* 通用 */
  _background-color: #666;  /* 僅 IE6 */
}

寫法三:星號 html

.searchInput         { background-color: #333; }
* html .searchInput  { background-color: #666; }  /* 僅 IE6 */
*+html .searchInput  { background-color: #555; }  /* 僅 IE7 */

針對特定瀏覽器的選擇器

*:lang(zh) select { font: 12px !important; }  /* Firefox 專用 */
select:empty       { font: 12px !important; }  /* Safari 可見 */

IE6 專用:註解切開屬性與值

在冒號前插入註解:

select { display /*IE6 不識別*/ : none; }

IE 條件註解

<!--[if IE]>            所有 IE 版本 <![endif]-->
<!--[if IE 5.0]>        僅 IE 5.0 <![endif]-->
<!--[if gt IE 5.0]>     大於 IE 5.0(含 5.5) <![endif]-->
<!--[if lt IE 6]>       IE6 及以下的 5.x <![endif]-->
<!--[if gte IE 6]>      IE6 以上 <![endif]-->
<!--[if lte IE 7]>      IE7 及以下 <![endif]-->

其中 gt/lt/gte/lte 分別是大於、小於、大於等於、小於等於。條件註解是微軟官方支援的機制,也是所有 IE hack 中最可靠、最該優先選用的一種,因為它不依賴解析 bug,且完全不会影响其他瀏覽器。

清除浮動

在 Firefox 中,當子元素全部浮動時,父元素高度無法包住它們。用這個 hack 為父層做一次定義即可解決:

select:after {
  content: ".";
  display: block;
  height: 0;
  clear: both;
  visibility: hidden;
}

(實作時把 select 換成你的選擇器;現代專案請直接用 display: flow-root。)

給今天的補充

這份規範成型於 XHTML 1.0 與 IE6/7 的時代,其中不少內容今日已有更好的答案:DOCTYPE 用 <!DOCTYPE html>;IE 相關 hack 幾乎全部可以退休(IE11 已於 2022 年終止支援);清除浮動改用 display: flow-root 或直接上 Flexbox/Grid;檔案切分可交由打包工具處理。

但真正歷久彌新的,是那份紀律:命名要表達語意而非外觀、樣式要與結構分離、宣告要能縮寫就不要冗長、註解要讓三個月後的自己看得懂、hack 能不寫就不寫。工具會換、語法會演進,這些習慣則是任何時代都成立的資產。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved