WinLab UI
WinLab 設計系統,以 shadcn registry 發佈。
開始使用
npx create-next-app@latest my-app cd my-app npx shadcn@latest init https://ui.winlab.tw/r/base.json npx shadcn@latest add @winlab/button
基礎
版面
區塊
- 確認對話框執行前先確認,執行中鎖住按鈕,完成才關閉。
- 表單對話框短表單叫出在頁面上方,送出中鎖住欄位,完成才關閉。
- 空狀態清單沒有資料或搜尋沒有結果時,統一的一句話與下一步。
- 焦點每頁一個大聲的地方,其他都安靜:標籤、標題與重點、一列資訊。
- 頭像疊多個人放在一個人的位置,指到時展開。
- 倒數距離某個時間還有多久,到分鐘,數字會滾動。
- 單週行事曆一週七天並排,時間往下排,行程從開始畫到結束。
- Markdown成員或模型寫的文字:粗體、連結、清單、表格,圖片改成連結。
- 展開列清單的一列原地展開細節,不換頁也不開對話框。
- 區塊分組頁面上的一組內容:上方一條分隔線與標題,不用卡片。
- 頁首頁面標題與這頁的動作按鈕。
- 清單載入清單和表格第一次載入時的佔位列。
- 選擇成員用姓名或信箱搜尋實驗室成員,可單選或多選。
- 明細清單一筆資料的欄位與值,名稱在左、內容在右。
- 狀態頁找不到、出錯、沒有權限時的標題與下一步。
- 授權頁讓其他程式代替成員操作前的允許與取消。
- 日期選擇外觀跟其他欄位一樣,點開是月曆,選了就關。
- 單一動作整頁只做一件事,例如開門:一顆大按鈕,執行中鎖住,成功後短暫變色。
- Claude Code示範與安裝說明用的 Claude Code 畫面:歡迎區、提問、MCP 呼叫、權限詢問、/plugins 與 /mcp 選單。
- 上傳檔案拖放、貼上或點選檔案,送出前可以檢查和移除。
- 簽名板手寫或上傳簽名,任何主題都是白紙黑字,存成裁好邊的透明 PNG。
元件
- 按鈕4 種變體,文字與圖示按鈕都是 40px 高。
- 徽章狀態標籤,含成功、警告、錯誤 3 種狀態色。
- 輸入框單行輸入,跟按鈕同高,可並排。
- 多行輸入框隨內容長高的多行輸入。
- 欄位名稱表單欄位的名稱,點了會聚焦對應的欄位。
- 下拉選單從固定選項中選一個。
- 下拉搜尋選單選項很多時可以搜尋,單選或多選都行。
- 月曆從月曆選一天,週一開頭。
- 附件一個檔案的圖示、檔名與狀態,可以移除或重試。
- 勾選框圓形勾選框,可以多選。
- 開關立即生效的開或關。
- 切換按鈕按下去就維持開或關的圖示按鈕。
- 表格資料列表,數字欄靠右對齊。
- 對話框短表單或細節,叫出在頁面上方。
- 警示對話框確認對話框的底層元件:標題、說明、取消與一個動作。
- 浮動面板錨定在按鈕旁的小面板。
- 工具列浮在畫面上的工具列,面板從工具列本身展開。
- 指令清單可搜尋的清單,下拉搜尋選單的內容。
- 動作選單一列動作,可以分組和放子選單。
- 分頁同一頁內切換幾個區塊。
- 瀏覽器瀏覽器視窗:網址列加網頁畫面,外框和終端機一樣。
- 終端機終端機視窗:等寬列、中文佔兩格,兩種主題都用深色配色。
- 程式碼區塊可以複製的指令、請求或設定檔。
- 頭像成員頭像,沒有圖時顯示名字的第一個字。
- 數字滾動整數變動時,每一位數字滾到新的值。
- 進度條已用多少占全部多少,例如額度。
- 圖表主要數列用主色,對照用灰色,有意義的數列(收入、支出)用狀態色,同一個總量的組成用主色深淺。
- 提示滑過圖示時補充說明。
- 分隔線水平或垂直的細線。
- 摺疊區塊可以展開和收合的內容。
- 載入骨架資料載入前的佔位形狀。
- 通知從角落跳出、幾秒後消失的通知。