當採用 OOCSS(面向對象 CSS)架構時,基礎樣式(Base)與擴展樣式(Extension)常分散在不同文件。傳統註釋無法建立雙向關聯,導致維護時難以追蹤樣式依賴鏈。
/* base.css - 基礎模組 */
.foo {
padding: 1rem;
border-radius: 4px;
}
/**
* Extend `.foo` in theme.css
* @see theme.css line 42
*/
/* theme.css - 主題擴展 */
.bar {
background: var(--primary-color);
box-shadow: 0 2px 8px rgba(0,0,0,.15);
}
/**
* Extends `.foo` in base.css
* @require base.css
*/
針對 Base → Variant → Theme 三層架構:
/* base.css */
.btn { /* 基礎按鈕 */ }
/** Extend `.btn` in btn-variants.css */
/* btn-variants.css */
.btn-primary { /* 主要變體 */ }
/** Extends `.btn` in base.css */
/** Extend `.btn-primary` in themes/ */
/* themes/dark.css */
.btn-primary { /* 暗黑模式覆寫 */ }
/** Extends `.btn-primary` in btn-variants.css */
配合 Stylelint 插件 stylelint-extend-annotation 可實現:
A extends B → B extends A@see 參考路徑這套標記體系將隱性的樣式依賴顯性化,是大型 CSS 架構可維護性的基石。