تخطَّ إلى المحتوى

@lh-ui/share

lh-ui 家族唯一的框架無關共享層 —— 56 個 core 元件純函式、12 個共享核心、國風主題系統、純 emitter 國際化、58 套元件樣式源。一份邏輯,餵給 Vue3 / Vue2 / React / uniapp 全端 UI 庫。

Core 純函式

56 個元件的類別名計算、狀態機、無障礙屬性包全部是零依賴純函式。框架層只管接線,邏輯單源、單測唯一份。

共享核心

popper 定位引擎、虛擬捲動、焦點圈、鍵盤導航、sx 樣式 props、數值淨化——12 個模組直接被各端複用。

國風主題

五個內建預設(青花瓷 / 松花綠 / 朱砂 / 水墨 / 藤黃),CSS 變數 + 暗色 + 花紋系統,AA 對比度腳本把守。

純 emitter 國際化

LhLocale 是純事件發射器,不攜帶任何框架響應式;各端用各自的訊號機制訂閱 version。

樣式唯一源

styles/ 是全家族元件 BEM 樣式的唯一源;過渡類別名三 mixin 收編 Vue2 / Vue3 / React 差異。

零框架依賴

external: [] 全量零依賴打包,verify:dts 門禁產物裡不許出現任何框架匯入。

  • 各端 UI 庫的開發者(lh-ui-plus / lh-ui-vue2 / lh-ui-react / lh-ui-uniapp):查每個純函式的簽名、傳回值、邊界,以及樣式令牌怎麼覆蓋。
  • 直接使用 share 的獨立開發者:專案只想要無障礙基線 + 國風主題令牌,不引任何 UI 庫。
  • 貢獻者:了解目錄職責、紅線、驗證與發版流程。
- `src/core/<元件>/` —— 純函式邏輯(logic.ts / types.ts),零框架匯入
- `src/core/shared/` —— 跨元件共享核心(popper / virtual / sx / keyboard …)
- `src/theme/` —— 主題 TS 側:類型 + 五個預設 + 執行時原語
- `styles/` —— 元件 BEM 樣式唯一源 + theme/common/*.scss 令牌
- `src/{constants,locales,types,utils}/` —— 常數 / 語言包 / 類型 / 工具

下一步:快速開始 裝套件、引樣式;或直接看包入口與子路徑搞清怎麼按需匯入。

Copyright © 2024-2026 FengMo WenXue