HHG Design System

v1.18.0

HHG 內部系統的共用 UI 基礎:design token、元件樣式層與行為層。所有值 build 時從 tokens.jsonregistry/hhg/ 讀出,repo 是唯一事實來源(SSOT)

tokens.json v1.18.0select.jsx DS_VERSION v1.18.0本站同步時間 2026-08-29

現在的狀態

取用前先確認自己拿的是哪一層。

  • React 換底進行中——元件層改寫成 React + Tailwind v4,走 shadcn registry 分發;樣式與行為雙層等值驗收通過才進。
  • components.css/components.js 已凍結、逐族退役中——現有採用者不受影響,新專案不要從這裡起手。
  • registry 現有 11 個元件ds-select、ds-button、ds-input、ds-badge、ds-tabs、ds-segmented、ds-combobox、ds-table、ds-dialog、ds-appshell、ds-menu)——其餘元件族還在遷。
FoundationToken 視覺化色票、間距、控件高度、圓角、字級、疊層、斷點與觸控覆寫,全部從 tokens.json 渲染。128 顆 token · 4 階斷點打開 →Components元件展示React + Tailwind v4 registry 元件的可互動 demo,與已凍結的 vanilla CSS 型錄。registry 11 個元件 · HTML 型錄 32 節打開 →

怎麼取用

用程式從 tokens.json 生成你的 theme,不要手抄。

Token 層

tokens.json(含 pointerCoarse breakpoints 兩個獨立區塊,都不要漏);純 vanilla 專案可直接 <link> 引用 tokens.css

元件層(registry)

components.json 加一個 registry 來源,然後 npx shadcn add @hhg/ds-select。token 要跟 Yu Anting 拿。

版本資訊

版本號在 repo 有 8 處,publish.sh 每次同步檢查一致;本站顯示其中兩處。

來源本站怎麼讀
tokens.jsonversionv1.18.0build 時 import,不寫死
registry/hhg/select.jsxDS_VERSIONv1.18.0build 時從原始碼 regex 抓出
Tailwind 命名空間覆蓋率109/128其餘 19 顆寫 arbitrary value