Figma to Code 工作流程分享
我會如何整理 Figma 的色票、字體、元件與互動狀態,再對應到 Vue、TypeScript 和 Tailwind,並和設計師同步修改。
本篇目錄
切版時,我會先整理 Figma 裡的 Design System 和 User Flow,再用 Vue + TypeScript + Tailwind 把設計稿做成網頁。這樣比較容易讓元件、樣式和互動跟設計對得上,後續也能持續維護。
我常用的 Figma 功能
Figma 是業界常用的設計工具,對前端工程師來說,這幾個功能很方便:
- 瀏覽器就能開:不用裝軟體,收到連結就能看設計稿
- 即時同步:設計師改了什麼馬上就能看到
- Dev Mode:專門給工程師看的模式,可以看到尺寸、間距、顏色等資訊
- 匯出資源方便:圖片、icon 可以直接匯出需要的格式和尺寸
- Design System 支援:可以建立共用的 Component 和 Variable
Design System 的建立與維護
把共用樣式和元件整理進 Design System,設計與開發就能用同一套規則。在 Figma 裡,我會確認這些內容:
Color Styles
把專案用到的顏色都定義成 Color Styles,用有意義的命名:
primary/500、primary/600:主色系gray/100、gray/200:中性色success、error、warning:語意色
這樣設計師和工程師都用同一套命名,溝通起來比較順。
Typography Styles
字體樣式也要統一定義:
heading/h1、heading/h2:標題層級body/regular、body/small:內文caption:輔助文字
每個 style 包含 font-family、font-size、line-height、font-weight、letter-spacing。
Component Library
常用的 UI 元件做成 Figma Component:
- Button(各種 variant:primary、secondary、outline)
- Input、Select、Checkbox
- Card、Modal、Toast
- Navigation、Breadcrumb
用 Variant 功能來管理不同狀態(default、hover、disabled 等)。
Spacing 和 Grid
間距規則用 4px 為基底的倍數系統比較好管理:4px、8px、16px、24px、32px…
Grid 系統定義好欄數和 gutter,方便對齊。
User Flow 的規劃
User Flow 是用來描述使用者在網站上的操作路徑。在 Figma 裡面,我通常會這樣處理:
頁面關係圖
用 FigJam 或在 Figma 裡面畫出頁面之間的關係:
- 哪些頁面可以互相跳轉
- 主要的使用流程是什麼
- 有沒有需要登入才能看的頁面
狀態標註
每個頁面可能有多種狀態:
- 載入中
- 資料為空
- 有資料
- 錯誤狀態
這些都要標註清楚,工程師才知道每種情況要怎麼處理。
互動行為標註
Hover、Click 會發生什麼事,用註解標註:
- 這個按鈕點下去會跳到哪裡
- 表單送出後的反饋是什麼
- 動畫效果的細節
從 Figma 落地到 Vue + TypeScript + Tailwind
有了 Design System,接下來就是把它轉成程式碼。我習慣的技術組合是 Vue 3 + TypeScript + Tailwind CSS。
建立對應的 Tailwind Config
把 Figma 的 Design Token 轉成 Tailwind 的設定:
// tailwind.config.js
module.exports = {
theme: {
extend: {
colors: {
primary: {
// primary 是全新的色票名稱,沒有預設值可繼承,用到哪一階就要定義哪一階;
// 少定義 50,下面 outline 樣式的 hover:enabled:bg-primary-50 就不會生成任何 CSS。
// (在 extend 底下擴充「既有」色票如下面的 gray 則是深層合併,
// 預設的 gray-300~900 仍然可用,所以後面才能寫 text-gray-800。)
50: "#EFF6FF",
500: "#2563EB",
600: "#1D4ED8",
},
gray: {
100: "#F3F4F6",
200: "#E5E7EB",
},
},
fontSize: {
"heading-h1": ["2.25rem", { lineHeight: "2.5rem", fontWeight: "700" }],
"heading-h2": ["1.5rem", { lineHeight: "2rem", fontWeight: "600" }],
"body-regular": ["1rem", { lineHeight: "1.5rem" }],
},
spacing: {
18: "4.5rem",
},
},
},
};
這樣 Tailwind 的 class 和 Figma 的 Design Token 就能對應起來。
色票也要和使用情境一起確認。這裡的 primary 按鈕用白字配 #2563EB,文字對比約 5.17:1,符合一般文字的 WCAG AA 4.5:1 門檻;hover 的 #1D4ED8 更深。較亮的藍色仍可用在裝飾上,但若是小字按鈕,不能只看設計稿覺得顏色好看。可用文字對比要求檢查預設、hover 與其他狀態。
後記(2026 更新):上面是 Tailwind v3 的寫法。v4 起改用 CSS 端的
@theme區塊定義變數,不再需要tailwind.config.js(舊檔仍可透過@config沿用)。同一套 Design Token 在 v4 的寫法可以參考〈Tailwind CSS v4 升級指南〉。
建立 TypeScript 元件
把 Figma 的 Component 轉成 Vue 元件,用 TypeScript 定義好 props:
<!-- components/Button.vue -->
<script setup lang="ts">
import { computed } from "vue";
interface Props {
variant?: "primary" | "secondary" | "outline";
size?: "sm" | "md" | "lg";
disabled?: boolean;
}
const props = withDefaults(defineProps<Props>(), {
variant: "primary",
size: "md",
disabled: false,
});
const buttonClasses = computed(() => {
const base =
"font-medium rounded-lg transition-colors disabled:cursor-not-allowed disabled:opacity-50";
const variants = {
primary: "bg-primary-500 text-white hover:enabled:bg-primary-600",
secondary: "bg-gray-100 text-gray-800 hover:enabled:bg-gray-200",
outline:
"border border-primary-500 text-primary-500 hover:enabled:bg-primary-50",
};
const sizes = {
sm: "px-3 py-1.5 text-sm",
md: "px-4 py-2 text-base",
lg: "px-6 py-3 text-lg",
};
return [base, variants[props.variant], sizes[props.size]];
});
</script>
<template>
<button :class="buttonClasses" :disabled="props.disabled">
<slot />
</button>
</template>
Figma 裡的 disabled 狀態也要對應到程式碼:disabled: 讓停用的按鈕變淡、游標換成禁止符號;hover 樣式寫成 hover:enabled:,只在按鈕可用時套用,停用時滑過去就不會變色(enabled 變體需要 Tailwind v3.1 以上)。
TypeScript 會在型別檢查時提醒 variant 和 size 是否符合定義。不過,API 或使用者輸入的資料仍需要執行時驗證,型別宣告本身不會擋下錯誤資料。
元件文件化
每個元件的使用方式要記錄下來,可以用 Storybook 或簡單的 Markdown 文件。內容至少包含:
- 支援哪些 props
- 每個 variant 長什麼樣子
- 使用範例
這樣團隊其他人也能正確使用這些元件。
確保一致性的做法
命名對齊
Figma 的 Component 名稱和程式碼的元件名稱保持一致,例如 Figma 端是 Button/Primary/Large,程式碼端就對應寫成 <Button variant="primary" size="lg" />,這樣溝通時不會搞混。
定期同步
Design System 會不斷更新,要有機制讓設計和程式碼保持同步:
- 設計師更新 Figma 的 Component
- 通知工程師有什麼改動
- 工程師更新對應的程式碼
- 最後再更新文件,確保兩邊不會脫節
Code Review 檢查
Code Review 時確認新做的 UI 有使用共用元件,不是自己從頭寫。如果有新的樣式需求,討論是不是應該加到 Design System 裡面。
Figma 常用操作技巧
Dev Mode 怎麼用
Figma 的 Dev Mode 是專門給工程師的檢視模式。切換到 Dev Mode 後,點選任何元素都可以看到:
- 尺寸(寬、高)
- 間距(padding、margin)
- 顏色值
- 字體資訊
- CSS 屬性(雖然不一定直接能用,但可以參考)
如果設計師有用 Auto Layout,還可以看到 Flexbox 的設定。
取得準確的尺寸
選取元素後,右側面板會顯示尺寸資訊。要注意的是:
- 固定尺寸還是彈性尺寸
- 最大寬度、最小寬度有沒有定義
- 間距是固定值還是要自適應
匯出圖片資源
在 Figma 裡面,選取要匯出的元素,在右側 Export 區塊可以設定:
- 格式(PNG、JPG、SVG、PDF)
- 倍率(1x、2x、3x)
- 尺寸
Icon 通常用 SVG,照片可以匯出成 JPG 或 PNG,再視需要轉成 WebP。如果需要響應式圖片,可以準備多個尺寸。
實務上的經驗
Mobile First
如果是手機使用者較多的網站,我通常先看手機版設計,完成小螢幕的版面,再用 Media Query 往大螢幕擴展。後台或桌面操作為主的產品,則會依主要使用情境安排。
先做結構再做樣式
我的習慣是先把 HTML 結構寫出來,確認架構正確,再來處理 CSS。不要一邊寫結構一邊調樣式,這樣很容易改來改去。
和設計師協作
跟設計師溝通的時候,要先建立共同語言,用雙方都懂的詞彙:Padding、Margin、Flexbox、Hover 狀態、Breakpoint。
定期同步進度,不要等到全部做完才給設計師看。做完一個區塊就先同步,有問題可以早點發現早點改。
有些設計效果做起來成本很高,或是瀏覽器支援度不好。遇到這種情況要主動跟設計師討論,找出可行的替代方案。
站內相關文章: