Icons
只用 Untitled UI line icon
全站 icon 只有一個來源:@untitledui/icons 的單色 line icon(1,100+ 顆)。 檔案類型用 @untitledui/file-icons。同一套線條粗細與圓角,畫面才會像同一個產品。
Home01 · Settings01 · Star01 · TrendUp01 · ChevronDown
production 的 @olab/components 也有自己的 Icon,筆畫偏粗;放在 Untitled UI icon 旁邊會打架時,不硬用,以 Untitled UI 為準(2026-09-28 裁決)。
尺寸與顏色
三個尺寸
size-416px · 行內、按鈕 sm、表格列size-520px · 按鈕 md、列表項、一般 UI 預設size-624px · 導覽、卡片標題、featured怎麼寫
- Named import,可 tree-shake:
import { Home01 } from "@untitledui/icons"; - 傳給組件 prop 時傳參照:
<Button iconLeading={ChevronDown}>;寫成 JSX 元素時一定加data-icon。 - 顏色走 semantic text token:
text-primary、text-tertiary、text-brand-main——不用 raw 色。 - 純裝飾的 icon 加
aria-hidden;有意義的 icon 旁邊要有文字或 aria-label。 - 筆畫粗細預設即可;要調用
strokeWidth,不用 CSS 偽造。
禁止事項
- 彩色 emoji 當 icon(🔥 📈 ✅)——這是「AI 做的」最明顯的痕跡,任何畫面都不用。
- 混用第二套 icon 庫(Lucide、Heroicons、Material…),即使形狀相近。
- 自己畫 SVG 取代現有 icon;真的沒有對應 icon 時先回報,不要自創。
- 用
size-3、size-7這類不在三階裡的尺寸,或用 arbitrary value 調大小。