萬盛學電腦網

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

CSS 註釋進階技巧:準修飾選擇器、代碼標籤與繼承標記

基礎註釋語法

/* 單行註釋 */
/* 
  多行註釋
  詳細描述功能、用途、注意事項
*/

推薦文檔塊風格 (DocBlock),行寬 ≤ 80 字符:

/**
 * 組件名稱/功能簡述
 * 
 * 詳細說明:用途、參數、依賴、副作用等
 * 
 * @example
 * .btn { ... }
 */

進階註釋模式

1. 準修飾選擇器

避免過度修飾選擇器 (如 ul.nav 降低復用性、提高優先級),但需告知預期作用元素:

/*html*/.product-page { }  /* 預期用於 html 根元素 */
/*ol*/.breadcrumb { }       /* 預期用於 ol 元素 */
/*p*/.intro { }              /* 預期用於 p 元素 */
/*ul*/.image-thumbs { }     /* 預期用於 ul 元素 */

註釋不影響選擇器優先級,卻能傳達語義信息。

2. 代碼標籤

為功能模塊打標籤,便於搜索定位:

/* ^layout - 頁面佈局相關 */
.header { ... }
.footer { ... }

/* ^typography - 排版樣式 */
.heading-1 { ... }
.body-text { ... }

/* ^components - UI 組件 */
.btn { ... }
.card { ... }

搜索 ^layout 即可快速定位佈局相關代碼。

3. 繼承標記

關聯分離的基礎樣式與擴展樣式:

/* base.css */
/**
 * @extend .btn-primary in theme.css
 */
.btn { padding: 8px 16px; border-radius: 4px; }

/* theme.css */
/**
 * @extends .btn in base.css
 */
.btn-primary { background: #007bff; color: #fff; }

建立跨文件關聯,便於維護與重構。

最佳實踐建議

  • 每個邏輯塊前添加功能註釋
  • 複雜計算/技巧處必寫原理說明
  • 團隊統一註釋規範 (格式、標籤體系、語言)
  • 構建工具可提取註釋生成樣式指南
copyright © 萬盛學電腦網 all rights reserved