我是做後端開發的,偶爾會拿到前端寫的靜態頁面。有些頁面裡的結構命名實在不太規範,看到就忍不住皺眉頭。這種情況多半發生在新人身上,通常我會拿一份以往寫的規範頁面給對方參考,主要是為了提高後續的開發效率。
本篇不是要談標準——標準請參考 W3C。這裡說的是一套比較通用的慣例,讓新手能更快上手。至於程式碼能力,那是另一回事,這裡只談我認為還算實用的做法。
<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<!-- 頁面編碼:以 UTF-8 居多 -->
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>無標題文檔</title>
<!-- 樣式:外部連結或內部定義 -->
<style type="text/css"></style>
<!-- 腳本:外部函式庫或內部定義 -->
<script type="text/javascript"></script>
</head>
<body>
<!-- 頭部。有的時候 header 會被包在 warp 裡,但最好給獨立標籤 -->
<div id="header">
<!-- 導航。雖然頭部與導航有時會合而為一,但別為省事混為一談 -->
<div id="nav">
<ul>
<li><a href="##">Nav1</a></li>
<li><a href="##"><span>Nav1</span></a></li>
</ul>
</div>
</div>
<!-- 頁面主體 -->
<div id="warp">
<!-- 左側內容:通常為側邊導航,後面接廣告位、聯絡資訊或快速搜尋 -->
<div id="leftContent">
<div id="leftNav">
<ul>
<li><a href="###">Jump To</a></li>
</ul>
</div>
<div id="ad"></div>
<div id="contact"></div>
</div>
<!-- 右側主體內容,自由發揮 -->
<div id="rightContent"></div>
</div>
<!-- 底部:版權、備案號、統計與推廣程式碼一律放此 -->
<div id="footer"></div>
</body>
</html>
為什麼要這樣分?頁面主要分為 head、header、warp、footer 四塊。有時 header 會被包進 warp 裡,變成三塊,可依設計稿彈性調整。重點不在分了幾塊,而在於各塊獨立成標籤、形成規律。這樣在後續開發中,header、footer、leftContent 這些區塊就能抽成共用控制項,大幅提升後端開發效率與後期維護的容易程度。

1. 按欄目建立資料夾。如上圖這是一個基本的檔案結構。NewsCenter、Product 是各欄目,一定要按欄目建資料夾,然後在其中建立頁面檔。如果所有頁面都丟在根目錄,剛開始還不覺得怎樣,等頁面數量多起來——不管是交接給別人還是自己的回頭改——眼睛都會花。
2. 頁面元素資源集中管理。把所有輔助資源(圖片、樣式、腳本)放進 skins 資料夾,再依屬性建立子資料夾分類存放。這樣要換主題或替換素材時,只需針對單一資料夾操作,不必全站翻找。
上面這套結構寫於 XHTML 的年代,有幾個地方值得更新:
改用 HTML5 語意標籤。<header>、<nav>、<main>、<aside>、<footer> 已經是標準元素,比 <div id="header"> 有意義得多,對搜尋引擎與螢幕閱讀器都更友善。
id 命名用英文小寫加連字號。上面範例中的 LeftContent、RighrContent(注意這個拼字錯誤也是常見問題)建議改為 left-content、right-content。HTML 的 id 雖然大寫小寫都吃,但統一風格能避免團隊協作時的混淆。
id 應該唯一,class 才是複用的單位。新手常犯的錯是替每個元素都取 id,導致樣式無法共用。判斷標準很簡單:這個元素在頁面中只出現一次嗎?是就用 id,否則用 class。