萬盛學電腦網

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

Discuz! X 系統 CSS 編碼規範:屬性書寫順序、命名慣例與最佳實踐

核心原則

  1. 單行聲明:屬性間、屬性名值間、大括號間均保留一空格。
    .class { width: 400px; height: 300px; }
  2. 屬性分組順序(由外至內、整體到細節):
組別屬性示例說明
1. 定位position, top, right, bottom, left, z-index, float文檔流與定位
2. 盒模型display, margin, padding, width, height, box-sizing尺寸與間距
3. 邊框與背景border, border-radius, background, box-shadow視覺裝飾
4. 文字與段落font, line-height, text-align, text-indent, color, text-decoration內容呈現
5. 其他overflow, cursor, visibility, opacity, transition, transform行為與動畫

廠商前綴順序

.box {
  -webkit-box-shadow: 0 1px 3px rgba(0,0,0,.1);
  -moz-box-shadow: 0 1px 3px rgba(0,0,0,.1);
  box-shadow: 0 1px 3px rgba(0,0,0,.1);  /* 標準屬性最後 */ 
}

選擇器與命名規範

  • 謹慎新增選擇器,優先復用現有樣式,避免濫用 ID 選擇器。
  • 全小寫:選擇器、屬性、值(十六進位顏色值除外)。
  • 縮寫類名需註釋全稱:.cl /* Clearfix */
  • 避免低效選擇器:ul li a span → 改用直接類名 .nav-link。
  • 慎用 !important:僅用於第三方庫覆寫或極少數工具類。

語義化縮寫前綴規範

前綴含義示例
a-狀態 active.a-btn, .a-tab
h- / c- / f-結構 header/content/footer.h-wrap, .c-main, .f-links
mn- / sd- / nv- / mu-區域 main/side/nav/menu.mn-area, .sd-box, .nv-list, .mu-item
l- / tab- / p_樣式 list/tab/popup.l-post, .tab-nav, .p_pop

開發流程規範

  • 未定事項標記 [!],便於後續討論追蹤。
  • 避免 CSS Hack,IE 特殊樣式走條件註釋或獨立補丁檔。
  • 定期清理冗餘代碼,配合 Stylelint 自動檢查。

總結

Discuz! X CSS 規範體現了大型社區項目對代碼可維護性、團隊協作效能的嚴格要求。核心思想:統一格式、邏輯分組、語義命名、克制 Hack、持續重構。無論專案大小,建立並執行一套適合團隊的 CSS 規範,都是技術債務控制的關鍵。

copyright © 萬盛學電腦網 all rights reserved