HHG Design System
v1.18.0HHG 內部系統的共用 UI 基礎:design token、元件樣式層與行為層。所有值 build 時從 tokens.json 與 registry/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)——其餘元件族還在遷。
怎麼取用
用程式從 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.json 的 version | v1.18.0 | build 時 import,不寫死 |
registry/hhg/select.jsx 的 DS_VERSION | v1.18.0 | build 時從原始碼 regex 抓出 |
| Tailwind 命名空間覆蓋率 | 109/128 | 其餘 19 顆寫 arbitrary value |