萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

HTML 表格縮排與程式碼排版最佳實踐:可讀性、維護性與團隊規範

為什麼要縮排?

  • **可讀性**:清楚呈現巢狀結構(table > thead > tr > th)。
  • **維護性**:快速定位欄位、行、群組,減少改錯風險。
  • **團隊協作**:統一風格降低認知負擔,Code Review 更專注邏輯。
  • **除錯**:瀏覽器 DevTools 元素面板即時反映結構,縮排一致易對照。

主流縮排風格對照

風格縮排單位適用場景範例
**2 空格**2 spacesHTML/CSS/JS 主流、Prettier 預設最推薦,節省寬度
**4 空格**4 spacesPython、Java 風格團隊視覺層級更明顯
**Tab**`\t`個人偏好、需自訂寬度需全專案一致,配合 EditorConfig

實際範例:標準語意化表格(2 空格)

<table>
  <caption>2024 季度營收</caption>
  <thead>
    <tr>
      <th scope="col">季度</th>
      <th scope="col">營收 (萬)</th>
      <th scope="col">成長率</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <th scope="row">Q1</th>
      <td>1,200</td>
      <td>+5.2%</td>
    </tr>
    <tr>
      <th scope="row">Q2</th>
      <td>1,350</td>
      <td>+12.5%</td>
    </tr>
  </tbody>
  <tfoot>
    <tr>
      <th scope="row">合計</th>
      <td>2,550</td>
      <td>+8.9%</td>
    </tr>
  </tfoot>
</table>

工具自動化:一鍵格式化

VS Code 內建格式化

  • `Shift + Alt + F` (Win/Linux) / `Shift + Option + F` (Mac)
  • 設定 `editor.formatOnSave: true` 存檔自動整理

Prettier(團隊標準化首選)

// .prettierrc
{
  "printWidth": 120,
  "tabWidth": 2,
  "useTabs": false,
  "htmlWhitespaceSensitivity": "css",
  "endOfLine": "lf"
}

安裝後全專案統一風格,CI/CD 可加入 `prettier --check .` 當守門員。

EditorConfig(跨編輯器基準)

# .editorconfig
root = true

[*]
indent_style = space
indent_size = 2
end_of_line = lf
charset = utf-8
trim_trailing_whitespace = true
insert_final_newline = true

特殊情況處理

單行簡短元素可不換行

<td>簡短內容</td> <td>另一欄</td>

長屬性值換行

<td
  class="cell cell--highlight"
  data-id="12345"
  style="width: 120px;"
>
  內容
</td>

模板引擎/框架混合時

Vue/React/Blade 等模板語法內的 HTML 同樣遵循專案縮排規範,Prettier 支援大多數框架。

常見錯誤與修正

錯誤問題修正
混用 Tab/空格不同編輯器顯示錯位統一用空格,設定 EditorConfig
巢狀層級未縮排難辨識父子關係每層 +1 級縮排
結束標籤獨立行但未對齊視覺跳躍結束標籤與開始標籤同層級
表格超過 80 欄仍不換行需水平捲動屬性換行、內容換行、或拆元件

總結

  • **專案統一 2 空格**,配合 Prettier + EditorConfig + CI 檢查。
  • 語意化標籤(thead/tbody/tfoot、th scope、caption)比縮排更重要。
  • 複雜表格拆分為元件/局部模板,避免單檔過長。
copyright © 萬盛學電腦網 all rights reserved