DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML和Xhtml
打造靈活、穩定、高品質 HTML 與 CSS 代碼的規範指南
編輯:HTML和Xhtml     

好的代碼規範,是團隊協作與長期維護的基石。以下從語法、命名到組織,整理一套完整的 HTML 與 CSS 撰寫準則。

黃金定律

無論有多少人參與同一專案,都要確保每一行代碼彷彿出自同一人之手——永遠遵循同一套編碼規範。

HTML 語法

  • 用兩個空格取代 tab 縮進,嵌套元素縮進一次。
  • 屬性值一律使用雙引號,絕不用單引號。
  • 自閉合元素結尾不加斜線(HTML5 中為可選)。
  • 不省略可選的結束標籤。
  • 每個頁面首行都加上標準模式宣告,確保各瀏覽器一致呈現。

語言屬性與編碼

建議為 HTML 根元素指定 lang 屬性,有助於語音合成與翻譯工具正確處理內容。同時應明確宣告字元編碼,讓瀏覽器快速判定渲染方式,避免混用字元實體。此外,IE 可透過特定標籤指定相容模式,除非有特殊需求,否則建議設為 edge mode 以採用最新模式。

引入檔案與實用原則

依 HTML5 規範,引入 CSS 與 JS 時一般不需指定 type 屬性,因為 text/css 與 text/javascript 已是預設值。最重要的是「實用為王」:遵循標準與語義,但別為此犧牲實用性,任何時候都要力求最少的標籤與最小的複雜度。

屬性順序

為確保易讀性,HTML 屬性建議依序排列:class、id/name、data-*、src/for/type/href、title/alt、aria/role。由於 class 用於標示高度可重用的元件,因此應排在首位。

CSS 語法要點

  • 用兩個空格縮進;選擇器分組時各自獨立一行。
  • 每條聲明獨佔一行並以分號結尾,冒號後加一個空格。
  • 逗號分隔的值,每個逗號後加空格。
  • 省略小於 1 的小數前的 0(如 .5 而非 0.5)。
  • 十六進位值用小寫並盡量簡寫(如 #fff)。
  • 屬性選擇器的值加上雙引號;0 值不加單位(如 margin:0)。

聲明順序

相關屬性應分組並依序排列:定位(positioning)、盒模型(box model)、排版(typographic)、視覺(visual)。因為定位能將元素移出文檔流並覆蓋盒模型樣式,故排首位;盒模型決定元件尺寸與位置排第二;其餘影響內部的屬性則排在後面。

其他重要建議

  • 避免 @import:它比 link 慢且易生問題,建議改用合併檔案或 CSS 預處理器。
  • 媒體查詢位置:盡量靠近相關規則,別全打包到檔案底部。
  • 廠商前綴屬性:垂直對齊排列,方便多行編輯。
  • 註釋:確保代碼能自描述、註釋良好,傳達上下文與目的,而非重申名稱。

class 命名與選擇器

class 名稱只能用小寫字母與破折號(非底線或駝峰),並以破折號串連相關命名(如 .btn 與 .btn-danger)。名稱應簡短且意義明確,避免任意簡寫與表現式命名。選擇器方面,通用元素優先用 class,避免屬性選擇器,並盡量把選擇器控制在三個元素以內。

代碼組織

以元件為單位組織代碼,採用一致的註釋與空白規範,並依元件(而非頁面)拆分多個 CSS 檔——因為頁面會重組,元件則只是被移動。遵循這套規範,就能寫出靈活、穩定且高品質的代碼。

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