因為會忘,所以要寫下來

漫畫風格設計系統

Design Guideline

以 #00aaaa 為核心的 Teal 配色 × 粗黑漫畫線條

🎨 色彩系統

保持品牌 DNA (#00aaaa),延伸完整色階與互補色系 + 漫畫風格視覺

Primary Colors (Teal)

核心品牌色 - 互動元素、連結、按鈕(切換暗黑模式查看變化)

50
最淺背景
100
淺背景
200
淺色裝飾
300
中淺色
400
中等強調
primary-500
✨ 核心主色 (#00aaaa → 暗黑模式 #007777)
600
稍深
700
Hover 狀態
800
深色強調
900
最深(陰影)

Semantic Colors (語意化顏色)

完整的語意化顏色系統,支援 50-950 色階

Success (成功/綠色)

50

100

200

300

400

✓ 500

主色

600

700

800

900

950

成功狀態 完成

Warning (警告/黃色)

50

100

200

300

400

⚠ 500

主色

600

700

800

900

950

注意事項 待處理

Error (錯誤/紅色)

50

100

200

300

400

✕ 500

主色

600

700

800

900

950

錯誤 失敗

Info (資訊/藍色)

50

100

200

300

400

ⓘ 500

主色

600

700

800

900

950

提示 資訊

Accent (強調/橘色)

50

100

200

300

400

🔥 500

主色

600

700

800

900

950

CTA 按鈕 日期

Neutral Colors

灰階系統 - 文字、背景、邊框(符合 WCAG AA 標準)

主背景
--color-background
卡片背景
--color-light-background
邊框色
--color-border

(看邊框顏色)

主文字
text-default

對比度 7.4:1 ✅ AAA

次要文字
text-light

對比度 4.6:1 ✅ AA

強調文字
text-dark

🎨 Comic 風格樣式系統

日本漫畫風格:細線條 + 柔和陰影 + 留白

陰影系統 (Shadows)

使用柔和漸層陰影,提升層次感

Small

comic-shadow-sm

0 1px 4px rgba(0,0,0,0.08)

Default

comic-shadow

0 2px 8px + 0 4px 12px

Large

comic-shadow-lg

0 4px 16px + 0 8px 24px

Extra Large

comic-shadow-xl

0 8px 32px + 0 12px 48px

邊框系統 (Borders)

細邊框設計,符合 Manga 風格

Default Border

1px 細邊框

comic-border

border border-gray-300

Thick Border

2px 中等邊框

comic-border-thick

border-2 border-gray-400

圓角系統 (Border Radius)

統一的圓角規範 - 漸進式圓角設計

6px
--comic-border-radius-sm (6px)

用於:Badge、小組件、Tag

8px
--comic-border-radius (8px)

用於:Button、Input、Alert

12px
--comic-border-radius-lg (12px)

用於:Card、Panel

16px
--comic-border-radius-xl (16px)

用於:Hero、Modal、大型容器

間距系統 (Spacing)

統一的間距尺度

xs / 4px
sm / 8px
md / 16px
lg / 24px
xl / 32px
2xl / 48px

🔘 按鈕系統

統一的互動元素樣式 - 使用 Button 組件

Button 組件 (新)

variant="primary" (3D 陰影效果)

<Button variant="primary">Default</Button>

variant="accent" (橘色 CTA)

<Button variant="accent">立即查看</Button>

variant="outline"

<Button variant="outline">了解更多</Button>

variant="ghost"

<Button variant="ghost">取消</Button>

variant="link"

<Button variant="link" href="#">查看更多</Button>

尺寸:size="sm|md|lg"

<Button size="sm|md|lg">...</Button>

🎴 卡片系統

統一的內容容器設計 - 使用 Card 組件

Variant: Project

精典小遊戲

AngularTailwind
2025
<Card variant="project" title="..." year="2025" />

Variant: Post

<Card variant="post" title="..." date={new Date()}/>

Variant: Default

預設卡片樣式

這是一個標準的卡片組件,可用於各種內容展示場景。

<Card variant="default" title="..." description="..." />

📏 間距與排版

統一的空間節奏

Section Spacing

4rem (md:6rem)

Card Spacing

1.5rem (md:2rem)

Element Spacing

1rem

📱 響應式網格

斷點:sm(640px) / md(768px) / lg(1024px) / xl(1280px)

2 Columns (mobile: 1, desktop: 2)

Column 1
Column 2

3 Columns (mobile: 1, tablet: 2, desktop: 3)

Column 1
Column 2
Column 3

🏷️ Tag vs Badge 標籤系統

兩種不同用途的標籤組件

Tags(標籤)組件

用於文章分類、導航的標籤

<Tags tags=JavaScriptAstroTailwindCSS />

Badge(徽章)組件

用於狀態指示、技能標記的徽章

顏色變體

Primary Accent Success Warning Error Info Neutral
<Badge color="primary|accent|success|...">...</Badge>

外框樣式

Primary Accent Success
<Badge outline=true>...</Badge>

尺寸

Small Medium Large
<Badge size="sm|md|lg">...</Badge>

📝 Input 表單組件

統一的表單輸入元素

我們不會分享您的電子郵件

密碼長度至少需要 8 個字元

<Input label="..." type="text" placeholder="..." required=true />

💬 Alert 提示組件

訊息提示與通知

<Alert variant="info|success|warning|error" title="..." dismissible=true>
  訊息內容
</Alert>

🎭 Hero 區塊組件

頁面英雄區塊

歡迎來到 Mandy's Web

前端工程師的技術筆記與實作分享

Gradient Hero

漸層背景樣式

淺色背景樣式

適用於內頁區塊

<Hero variant="primary|gradient|default" size="sm|md|lg" title="..." align="left|center|right">
  <Button>...</Button>
</Hero>

➖ Divider 分隔線組件

內容分隔線

實線分隔 (variant="solid")


帶文字分隔

OR

虛線分隔 (variant="dashed")


漸層分隔 (variant="gradient")


間距設定 (spacing="sm|md|lg")

Small Spacing

Medium Spacing

Large Spacing

End
<Divider variant="solid|dashed|dotted|gradient" text="OR" spacing="sm|md|lg" />

💭 Tooltip 提示框組件

滑鼠懸停提示

位置設定 (position="top|bottom|left|right")

顏色設定 (color="primary|accent|neutral")

<Tooltip text="提示文字" position="top|bottom|left|right" color="primary|accent|neutral">
  <Button>Hover me</Button>
</Tooltip>

⏳ Loading 載入組件

載入指示器

樣式變體 (variant="spinner|dots|ring|bars")

spinner
dots
ring
bars

尺寸設定 (size="sm|md|lg")

small
medium
large

顏色設定 (color="primary|accent|neutral")

Primary

Accent

Neutral

帶文字

載入中...

<Loading variant="spinner|dots|ring|bars" size="sm|md|lg" color="primary|accent|neutral" text="載入中..." />

📅 Timeline 時間軸組件

時間軸展示

2025-01-01

專案啟動

開始規劃與設計階段

2025-01-10

開發階段

核心功能開發與測試

2025-01-15

測試優化

完整測試與效能優化

2025-01-20

正式上線

部署至生產環境

<Timeline
  items={[
    {
      title: '標題',
      description: '描述',
      date: '2025-01-01',
      icon: 'ic:outline-check',
      color: 'primary|accent|success|warning|error|info|neutral'
    }
  ]}
/>

✅ 完整組件清單

  • Card.astro - 卡片組件
  • Button.astro - 按鈕組件
  • Badge.astro - 徽章組件
  • Hero.astro - 英雄區塊
  • Input.astro - 輸入框組件
  • Alert.astro - 提示組件
  • Divider.astro - 分隔線
  • Tooltip.astro - 提示框
  • Loading.astro - 載入指示器
  • Dropdown.astro - 下拉選單
  • Modal.astro - 彈窗
  • Timeline.astro - 時間軸
  • Breadcrumbs.astro - 麵包屑
  • • Header.astro - 頁首
  • • Footer.astro - 頁尾
  • • Tags.astro - 標籤列表
  • • FormattedDate.astro - 日期格式化
  • • Pagination.astro - 分頁
  • • SearchWidget.astro - 搜尋小工具
  • • ThemeSwitcher.astro - 主題切換
  • • Toc.astro - 目錄

Copyright © 2026 Mandy. All rights reserved. Build with Astro