pkupuk
e9897388dc
Establish baseline for project documentation including BMAD specs, PRD, and system architecture notes.
390 lines
7.7 KiB
Markdown
390 lines
7.7 KiB
Markdown
# Story 1-9 Blog System - UX Pixel-Perfect Specifications
|
||
|
||
> **UX Expert Review Document**
|
||
> 參考來源: `research/www.enchun.tw/news.html`
|
||
> 設計系統: `apps/frontend/src/styles/theme.css`
|
||
> 目標視覺保真度: 95%+
|
||
> URL 結構: `/blog` (SEO 友好)
|
||
|
||
---
|
||
|
||
## 🎨 Design Token 驗證
|
||
|
||
### 色彩系統
|
||
|
||
| 用途 | 變數名稱 | Hex Color | CSS Variable | 驗證狀態 |
|
||
|------|----------|-----------|--------------|----------|
|
||
| 主品牌色 | Enchun Blue | `#23608c` | `--color-enchunblue` | ✅ 已定義 |
|
||
| 深品牌色 | Enchun Blue Dark | `#3083bf` | `--color-enchunblue-dark` | ✅ 已定義 |
|
||
| 深灰文字 | Tarawera | `#2d3748` | `--color-tarawera` | ✅ 已定義 |
|
||
| 通知紅 | Notification Red | `#d84038` | `--color-accent` | ✅ 已定義 |
|
||
| CTA 強調 | Amber | `#f6c456` | `--color-amber` | ✅ 已定義 |
|
||
|
||
### 類別分區顏色
|
||
|
||
| 類別 | Hex Color | CSS Variable | 驗證狀態 |
|
||
|------|-----------|--------------|----------|
|
||
| Google 小學堂 | `#67aee1` | `--color-category-google` | ✅ 已定義 |
|
||
| Meta 小學堂 | `#8974de` | `--color-category-meta` | ✅ 已定義 |
|
||
| 行銷時事最前線 | `#3083bf` | `--color-category-news` | ✅ 已定義 |
|
||
| 恩群數位 | `#3898ec` | `--color-category-enchun` | ✅ 已定義 |
|
||
|
||
---
|
||
|
||
## 📐 Section 詳細規格
|
||
|
||
### 1. Blog 列表頁
|
||
|
||
#### 頁面路徑: `/blog`
|
||
|
||
```css
|
||
.blog-section {
|
||
padding: 60px 0 80px;
|
||
background-color: var(--color-background);
|
||
}
|
||
|
||
.blog-header {
|
||
text-align: center;
|
||
margin-bottom: 50px;
|
||
}
|
||
|
||
.blog-title {
|
||
font-size: 2.5rem;
|
||
font-weight: 700;
|
||
color: var(--color-tarawera);
|
||
margin-bottom: 10px;
|
||
line-height: 1.2;
|
||
}
|
||
|
||
.blog-subtitle {
|
||
font-size: 1.125rem;
|
||
color: var(--color-gray-700);
|
||
font-weight: 400;
|
||
line-height: 1.6;
|
||
}
|
||
```
|
||
|
||
#### 分類篩選器
|
||
```css
|
||
.category-filter {
|
||
display: flex;
|
||
justify-content: center;
|
||
gap: 16px;
|
||
margin-bottom: 48px;
|
||
flex-wrap: wrap;
|
||
}
|
||
|
||
.category-button {
|
||
padding: 12px 24px;
|
||
background-color: var(--color-gray-100);
|
||
border: 2px solid transparent;
|
||
border-radius: 30px;
|
||
font-size: 1rem;
|
||
font-weight: 500;
|
||
color: var(--color-gray-700);
|
||
transition: all 200ms ease-in-out;
|
||
}
|
||
|
||
.category-button:hover {
|
||
background-color: var(--color-gray-200);
|
||
transform: translateY(-2px);
|
||
}
|
||
|
||
.category-button.active {
|
||
background-color: var(--color-enchunblue);
|
||
border-color: var(--color-enchunblue);
|
||
color: white;
|
||
}
|
||
```
|
||
|
||
#### 文章卡片網格
|
||
```css
|
||
.posts-grid {
|
||
display: grid;
|
||
grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));
|
||
gap: 32px;
|
||
margin-bottom: 60px;
|
||
}
|
||
|
||
@media (min-width: 1024px) {
|
||
.posts-grid {
|
||
grid-template-columns: repeat(3, 1fr);
|
||
}
|
||
}
|
||
|
||
@media (max-width: 767px) {
|
||
.posts-grid {
|
||
grid-template-columns: 1fr;
|
||
gap: 24px;
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 2. 文章卡片組件
|
||
|
||
#### 組件檔案: `components/blog/ArticleCard.astro`
|
||
|
||
```css
|
||
.article-card {
|
||
background-color: white;
|
||
border-radius: 12px;
|
||
overflow: hidden;
|
||
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
|
||
transition: all 300ms ease-in-out;
|
||
display: block;
|
||
text-decoration: none;
|
||
color: inherit;
|
||
}
|
||
|
||
.article-card:hover {
|
||
transform: translateY(-4px);
|
||
box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
|
||
}
|
||
|
||
.card-image-wrapper {
|
||
position: relative;
|
||
width: 100%;
|
||
padding-bottom: 56.25%; /* 16:9 */
|
||
overflow: hidden;
|
||
background-color: var(--color-gray-100);
|
||
}
|
||
|
||
.card-image {
|
||
position: absolute;
|
||
top: 0;
|
||
left: 0;
|
||
width: 100%;
|
||
height: 100%;
|
||
object-fit: cover;
|
||
transition: transform 300ms ease-in-out;
|
||
}
|
||
|
||
.article-card:hover .card-image {
|
||
transform: scale(1.05);
|
||
}
|
||
|
||
.category-badge-overlay {
|
||
position: absolute;
|
||
top: 16px;
|
||
left: 16px;
|
||
padding: 6px 12px;
|
||
border-radius: 20px;
|
||
font-size: 0.75rem;
|
||
font-weight: 600;
|
||
color: white;
|
||
backdrop-filter: blur(4px);
|
||
background-color: rgba(0, 0, 0, 0.6);
|
||
}
|
||
|
||
.card-content {
|
||
padding: 24px;
|
||
}
|
||
|
||
.category-badge {
|
||
display: inline-block;
|
||
padding: 6px 14px;
|
||
border-radius: 20px;
|
||
font-size: 0.75rem;
|
||
font-weight: 600;
|
||
color: white;
|
||
margin-bottom: 12px;
|
||
}
|
||
|
||
.card-title {
|
||
font-size: 1.25rem;
|
||
font-weight: 600;
|
||
color: var(--color-tarawera);
|
||
margin-bottom: 12px;
|
||
line-height: 1.4;
|
||
display: -webkit-box;
|
||
-webkit-line-clamp: 2;
|
||
-webkit-box-orient: vertical;
|
||
overflow: hidden;
|
||
}
|
||
|
||
.card-excerpt {
|
||
font-size: 0.875rem;
|
||
color: var(--color-gray-600);
|
||
line-height: 1.6;
|
||
margin-bottom: 16px;
|
||
display: -webkit-box;
|
||
-webkit-line-clamp: 3;
|
||
-webkit-box-orient: vertical;
|
||
overflow: hidden;
|
||
}
|
||
|
||
.card-meta {
|
||
display: flex;
|
||
align-items: center;
|
||
gap: 8px;
|
||
font-size: 0.875rem;
|
||
color: var(--color-gray-500);
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 3. 分頁元件
|
||
|
||
```css
|
||
.pagination {
|
||
display: flex;
|
||
justify-content: center;
|
||
align-items: center;
|
||
gap: 8px;
|
||
margin-top: 48px;
|
||
}
|
||
|
||
.pagination-link {
|
||
min-width: 40px;
|
||
height: 40px;
|
||
padding: 0 12px;
|
||
background-color: white;
|
||
border: 1px solid var(--color-gray-300);
|
||
border-radius: 8px;
|
||
color: var(--color-gray-700);
|
||
text-decoration: none;
|
||
font-size: 0.875rem;
|
||
font-weight: 500;
|
||
transition: all 200ms ease-in-out;
|
||
}
|
||
|
||
.pagination-link:hover {
|
||
background-color: var(--color-enchunblue);
|
||
border-color: var(--color-enchunblue);
|
||
color: white;
|
||
}
|
||
|
||
.pagination-link.active {
|
||
background-color: var(--color-enchunblue);
|
||
border-color: var(--color-enchunblue);
|
||
color: white;
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 4. 文章詳情頁
|
||
|
||
#### 頁面路徑: `/blog/[slug]`
|
||
|
||
```css
|
||
.article-header {
|
||
text-align: center;
|
||
padding: 60px 0 40px;
|
||
}
|
||
|
||
.article-hero {
|
||
margin-bottom: 40px;
|
||
}
|
||
|
||
.hero-image {
|
||
width: 100%;
|
||
max-height: 500px;
|
||
object-fit: cover;
|
||
border-radius: 12px;
|
||
box-shadow: 0 4px 16px rgba(0, 0, 0, 0.1);
|
||
}
|
||
|
||
.article-title {
|
||
font-size: 2.5rem;
|
||
font-weight: 700;
|
||
color: var(--color-tarawera);
|
||
margin-bottom: 16px;
|
||
line-height: 1.2;
|
||
}
|
||
|
||
.article-category-badge {
|
||
padding: 8px 20px;
|
||
border-radius: 30px;
|
||
font-size: 0.875rem;
|
||
font-weight: 600;
|
||
color: white;
|
||
margin-bottom: 16px;
|
||
}
|
||
|
||
.article-content {
|
||
max-width: 800px;
|
||
margin: 0 auto;
|
||
padding: 40px 0;
|
||
}
|
||
|
||
.article-content-wrapper {
|
||
background-color: white;
|
||
border-radius: 12px;
|
||
padding: 40px;
|
||
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
|
||
}
|
||
|
||
.article-content p {
|
||
margin-bottom: 20px;
|
||
line-height: 1.8;
|
||
font-size: 1.125rem;
|
||
}
|
||
|
||
.article-content h2 {
|
||
font-size: 2rem;
|
||
font-weight: 600;
|
||
margin: 40px 0 20px;
|
||
}
|
||
|
||
.article-content h3 {
|
||
font-size: 1.5rem;
|
||
font-weight: 600;
|
||
margin: 30px 0 16px;
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 📱 響應式斷點總結
|
||
|
||
| Breakpoint | 字體大小 | 主容器 | 卡片佈局 |
|
||
|------------|----------|--------|----------|
|
||
| Desktop (≥1200px) | 16px | 1200px | 3 columns |
|
||
| Tablet (768-1199px) | 19px | 96% | 2 columns |
|
||
| Mobile (479-767px) | 16px | 96% | 1 column |
|
||
| Small Mobile (<479px) | 13px | 96% | 1 column |
|
||
|
||
---
|
||
|
||
## 🏗️ 組件實現清單
|
||
|
||
### ⏳ 需新增
|
||
- [ ] `ArticleCard.astro` - 文章卡片
|
||
- [ ] `CategoryFilter.astro` - 分類篩選器
|
||
- [ ] `Pagination.astro` - 分頁元件
|
||
- [ ] `RelatedPosts.astro` - 相關文章
|
||
|
||
### 📝 URL 結構
|
||
- 列表頁: `/blog`
|
||
- 詳情頁: `/blog/[slug]`
|
||
- 分類頁: `/blog/category/[slug]`
|
||
|
||
---
|
||
|
||
## 📋 驗收標準
|
||
|
||
### 視覺保真度檢查
|
||
- [ ] 文章卡片樣式與設計一致
|
||
- [ ] 分類標籤顏色正確
|
||
- [ ] Hover 效果流暢
|
||
- [ ] 響應式佈局正確
|
||
|
||
### 功能檢查
|
||
- [ ] 分類篩選功能正常
|
||
- [ ] 分頁導航正常
|
||
- [ ] 文章詳情頁渲染正確
|
||
- [ ] 相關文章顯示正常
|
||
|
||
### 性能檢查
|
||
- [ ] Lighthouse Performance ≥ 90
|
||
- [ ] 圖片懶加載實現
|
||
- [ ] 分頁載入實現
|
||
|
||
---
|
||
|
||
*此文件由 UX Expert 創建，最後更新：2026-02-10*
|