Previous order was (menu)(theme)(language). Swapped so the row reads logo ... (theme)(language)(menu) and the hamburger sits flush against the right padding edge, which is where the thumb menu is expected. Measured 360/375/414px: brand starts at 14px, menu ends exactly on the right padding edge, 8px gaps, no horizontal overflow.
322 lines
28 KiB
Markdown
322 lines
28 KiB
Markdown
# DESIGN.md — เอกลักษณ์งานออกแบบ Atroute
|
||
|
||
> **ขอบเขต:** ใช้กับ UI ใน `frontend/` (Next.js App Router) ซึ่งพอร์ตมาจาก mock
|
||
> (`D:\Git\workspace\web-at-transit-mock`) แบบ 1:1 — mock คือแหล่งความจริงของดีไซน์
|
||
> AI agent ต้องอ่านไฟล์นี้ก่อนแก้ UI ทุกครั้ง และห้ามฝ่าฝืนกฎ "ห้ามทำ"
|
||
|
||
---
|
||
|
||
## 1. เอกลักษณ์ (Design Signature)
|
||
|
||
**Concept: "ขาวไล่ม่วง" (White-to-Purple)** — พื้นขาวสะอาด มีม่วงเฉดเดียวเป็นตัวชูโรง
|
||
|
||
หัวใจคือ **ม่วงหนึ่งเฉด + ความนิ่งของตัวพิมพ์** ไม่ใช่การไล่สีรุ้งแบบ template:
|
||
ม่วง `#7a4cc0` ถูกใช้อย่างตั้งใจ (ปุ่ม / CTA / รหัสป้าย / แอคเซนต์) บนพื้นขาวที่ไล่
|
||
ไปม่วงจาง ๆ แทบไม่เห็น เพื่อให้ข้อมูลอ่านง่ายและไม่แย่งความสนใจ
|
||
|
||
สามเสาหลัก:
|
||
|
||
1. **ข้อมูลต้องอ่านได้ชัดเจน** — ตัวเลข/รหัสใช้ฟอนต์ mono + tabular-nums เรียงตรงกัน
|
||
2. **ม่วงหนึ่งเฉด มีเหตุผล** — ม่วง = แบรนด์/แอคเซนต์, ไม่ใช่สีสุ่ม 5 เฉดไร้ความหมาย
|
||
3. **สี = ภาษาสถานะ** — เขียว = มีรอบ, แดง = ออกแล้ว, เทา = ไม่มีข้อมูล ไม่ใช่ของตกแต่ง
|
||
|
||
---
|
||
|
||
## 2. กฎ "ห้ามทำ" (ฉีกสไตล์ AI slop)
|
||
|
||
รายการนี้คือลายเซ็นของเว็บ AI ยุค 2024–2025 — **ห้าม** ใช้เด็ดขาด:
|
||
|
||
| # | ห้าม | เพราะ |
|
||
|---|---|---|
|
||
| 1 | ❌ **Aurora gradient หลายสี** (ม่วง→ชมพู→ฟ้า→เขียว ผสมกันแนวทแยง) | ลายเซ็น AI อันดับหนึ่ง |
|
||
| 2 | ❌ **ม่วงสุ่ม 5+ เฉด** ไม่มีความหมาย (ม่วง 50/100/200/…/900 หว่านเต็มหน้า) | ยึดม่วงเฉดเดียว `#7a4cc0` + อ่อน `#b07ce0` |
|
||
| 3 | ❌ Glassmorphism (`backdrop-filter: blur`) | ใช้เฉพาะแถบนำทางที่จำเป็นจริง ๆ |
|
||
| 4 | ❌ **Emoji เป็น icon** (🚏🕒📍🛣️🧭) | ใช้ SVG icon หรือ glyph ตัวพิมพ์ |
|
||
| 5 | ❌ Blob / รูปทรงออร์แกนิกลอย ๆ เป็นพื้นหลัง | ใช้เส้นขอบ/ตาราง/ลวดลายเรขาคณิต |
|
||
| 6 | ❌ การ์ดมน ๆ พื้นสีพาสเทล รัศมี 16–22px | ใช้เส้นขอบ 1px + `radius: 8px` ไม่ใช่สีพื้น+เงา |
|
||
| 7 | ❌ Badge "✨ ยินดีต้อนรับ", sparkle, star | ไร้สาระ ไม่ได้ให้ข้อมูล |
|
||
| 8 | ❌ Drop shadow ทั่วหน้า | แบ่งองค์ประกอบด้วย border + whitespace |
|
||
| 9 | ❌ ฟอนต์แฟนซี/display เกินจำเป็น | ใช้ระบบฟอนต์เดียวตลอด (ดูหัวข้อ 4) |
|
||
| 10 | ❌ คำว่า "template / mockup / demo" ใน UI | โปรเจกต์จริง ไม่ใช่ template |
|
||
| 11 | ❌ ตัวหนังสือ gradient (text-clip) บนพื้นอ่อน | ตัวหนังสือสีทึบ ตรง ไม่มี gradient |
|
||
|
||
> ตรวจงานก่อนส่งทุกครั้ง: ถ้าเห็นรายการข้างต้นในโค้ด/ดีไซน์ = แก้ก่อน merge
|
||
|
||
---
|
||
|
||
## 3. โทเคนสี (ใช้ค่าที่กำหนดเท่านั้น — ห้ามคิดเลขใหม่เอง)
|
||
|
||
```css
|
||
:root {
|
||
/* ม่วง — สีหลักเฉดเดียวของแบรนด์ */
|
||
--purple-700: #6d28d9; /* ม่วงเข้ม — hover / เน้น */
|
||
--purple: #7a4cc0; /* ม่วงหลัก — ปุ่ม / CTA / แอคเซนต์ */
|
||
--purple-300: #b07ce0; /* ม่วงอ่อน — ปลาย gradient / ขอบโฟกัส */
|
||
--purple-50: #f3ecff; /* พื้นม่วงอ่อน — badge / ชิป */
|
||
--purple-25: #faf7ff; /* พื้นไล่ม่วงจางสุด — hover / hero */
|
||
|
||
/* พื้นฐาน */
|
||
--paper: #ffffff; /* พื้นขาวหลัก */
|
||
--ink: #1f2a44; /* ตัวอักษรหลัก (น้ำเงินเข้ม) */
|
||
--muted: #6f7b95; /* ตัวอักษรรอง */
|
||
--line: #e7e0f6; /* เส้นขอบม่วงอ่อน */
|
||
|
||
/* หมวดเส้นทาง (route_group ใน routes.json) — ใช้กับ "เลขสาย" (chip) เท่านั้น */
|
||
--group-bangkok: #1f5fbf; /* เข้ากรุงเทพฯ — น้ำเงิน */
|
||
--group-interprovincial: #7a4cc0; /* ระหว่างจังหวัด — ม่วง (ม่วงแบรนด์) */
|
||
--group-in-province: #d6388f; /* ภายในจังหวัด — ชมพู */
|
||
--group-municipal: #6b7268; /* ภายในเทศบาล — เทา (สำรอง ยังไม่มีสายใช้) */
|
||
|
||
/* สถานะ */
|
||
--green-500: #1f8765; /* มีรอบ / เปิดให้บริการ */
|
||
--green-50: #e4efe4;
|
||
--amber: #c47b1d; /* เตือน / หมายเหตุ (ไม่ใช่สีหลัก) */
|
||
--amber-50: #fff6e8;
|
||
--red: #c93a3a; /* ออกรถแล้ว / ยกเลิก */
|
||
--red-50: #fbe4e4;
|
||
|
||
/* โครงสร้าง */
|
||
--radius: 8px; /* มุมโค้งเล็ก เท่านั้น */
|
||
--radius-sm: 4px;
|
||
--shadow: none; /* ห้ามใช้ shadow เป็นเครื่องมือแบ่งองค์ประกอบ */
|
||
--line-w: 1px;
|
||
|
||
/* gradient ที่อนุญาต (ใช้ซ้ำได้) */
|
||
--grad-brand: linear-gradient(135deg, #7a4cc0, #b07ce0); /* ปุ่ม/ชิป/CTA */
|
||
--grad-bg: linear-gradient(180deg, #ffffff, #faf7ff, #f4f0fd); /* พื้นหลังหน้า */
|
||
}
|
||
```
|
||
|
||
### กติกาสีต่อสถานะ
|
||
| องค์ประกอบ | สี |
|
||
|---|---|
|
||
| แอคเซนต์ / ปุ่ม / CTA / รหัสป้าย | `--grad-brand` (ม่วงหลัก) |
|
||
| พื้นหลังหน้า | `--grad-bg` (ขาว→ม่วงจาง) |
|
||
| ป้ายสถานะ "มีรอบ/เปิดให้บริการ" | `--green-500` |
|
||
| ป้ายสถานะ "ออกรถแล้ว/ปิด" | `--red` |
|
||
| ข้อมูลว่าง / ไม่มีพิกัด | `--muted` |
|
||
| หมายเหตุ / เตือน | `--amber` (ใช้ sparingly) |
|
||
|
||
---
|
||
|
||
## 3.1 ระบบภาษา (i18n)
|
||
|
||
คำแปลแยกเป็น **ไฟล์ต่อภาษา** — `frontend/locales/<รหัสภาษา>.json` (แบน: `"key": "ข้อความ"`)
|
||
|
||
- **ภาษาที่รองรับ** ประกาศที่ `frontend/i18n.js → SUPPORTED` (ปัจจุบัน `th`, `en`) · ภาษาตั้งต้น `th`
|
||
ใช้เป็น fallback เมื่อคีย์ขาดในภาษาปัจจุบัน
|
||
- **เพิ่มภาษาใหม่** = วางไฟล์ `frontend/locales/<รหัส>.json` + เพิ่มรหัสใน `SUPPORTED`
|
||
+ เพิ่ม `./locales/<รหัส>.json` ใน PRECACHE ของ `frontend/sw.js` (ไม่ต้องแก้โค้ดอื่น)
|
||
- **โหลดแบบ lazy** เฉพาะภาษาที่ใช้ (+ ภาษาตั้งต้น) — ไม่ดึงทุกภาษามาทั้งหน้า
|
||
- **ข้อความใน HTML คือ fallback** — ถ้าโหลดไฟล์ภาษาไม่สำเร็จ ระบบจะ **ไม่เขียนทับ** (คงข้อความเดิมไว้)
|
||
- **สลับภาษา** → `I18N.setLang()` โหลดไฟล์ภาษาให้เสร็จก่อน แล้วประกาศ event `langchange` ให้หน้าวาดใหม่
|
||
(กันข้อความที่ JS สร้างค้างเป็นภาษาเก่า) · จำค่าไว้ใน `localStorage('at_lang')`
|
||
- `<html lang>` ถูกอัปเดตตามภาษาที่เลือกอัตโนมัติ (a11y · การตัดคำ · เลือกฟอนต์)
|
||
- **ชื่อเฉพาะไม่แปล** — ชื่อสถานี จังหวัด สายรถ (ภาษาไทยเสมอ)
|
||
- **ตรวจก่อน commit:** `python resource/tools/check-i18n.py`
|
||
|
||
## 3.2 ธีม (Theme) — สว่าง / มืด / ตามเวลาเครื่อง
|
||
|
||
**ไฟล์:** `frontend/src/styles/theme.css` (โทเคน) · `frontend/src/components/ThemeSwitch.tsx` (ตัวสลับ)
|
||
|
||
### โหมดที่รองรับ
|
||
|
||
| โหมด | ค่า `data-theme` | กติกา |
|
||
|---|---|---|
|
||
| สว่าง | `light` | ผู้ใช้เลือกเอง |
|
||
| มืด | `dark` | ผู้ใช้เลือกเอง |
|
||
| ตามเวลา | `auto` | 06:00–17:59 = สว่าง · 18:00–05:59 = มืด (เวลาจากเครื่องผู้ใช้) |
|
||
|
||
- ค่าเริ่มต้น = `auto` · เก็บที่ `localStorage['at_theme']`
|
||
- สคริปต์ inline ใน `src/app/layout.tsx` ตั้ง `data-theme` **ก่อน paint** → ไม่มีจอขาววูบ
|
||
- โหมด `auto` ตรวจซ้ำทุก 60 วินาที + ทุกครั้งที่กลับเข้าแท็บ (`visibilitychange`)
|
||
- `color-scheme` ถูกตั้งตามธีม → สกรอลบาร์/คอนโทรลเบราว์เซอร์กลมกลืน
|
||
|
||
### กฎการใช้สี (สำคัญ)
|
||
|
||
**ห้ามใส่ hex ตรง ๆ ในไฟล์ CSS อีก** — ใช้โทเคนใน `theme.css` เท่านั้น
|
||
|
||
| โทเคน | สว่าง | มืด | ใช้กับ |
|
||
|---|---|---|---|
|
||
| `--c-bg` | `#f7f9fd` | `#120e1e` | พื้นหลังหน้า |
|
||
| `--c-surface` | `#ffffff` | `#171225` | การ์ด/แถบนำทาง |
|
||
| `--c-surface-2` | `#faf7ff` | `#1f1833` | พื้นรอง |
|
||
| `--c-surface-3` | `#f4f2fa` | `#251d3d` | พื้นตติยภูมิ |
|
||
| `--c-ink` | `#1f2a44` | `#ece9f7` | ข้อความหลัก |
|
||
| `--c-ink-2` | `#5f6b83` | `#a9a2c4` | ข้อความรอง |
|
||
| `--c-border` | `#e7e2f6` | `#352b52` | เส้นขอบ |
|
||
| `--c-brand` | `#7a4cc0` | `#7a4cc0` | พื้นม่วง (คงที่) |
|
||
| `--c-brand-ink` | `#7a4cc0` | `#b892f5` | ตัวอักษรม่วง |
|
||
| `--c-tint-purple/pink/green/amber/cyan` | อ่อน | เข้มจัด | พื้นตามหมวด |
|
||
| `--c-ok/warn/danger/info` | เข้ม | สว่าง | ข้อความสถานะ |
|
||
| `--c-glass / -70 / -24` | ขาวโปร่ง | ดำโปร่ง | พื้นผิวโปร่งแสง |
|
||
|
||
### ตรวจแล้ว (WCAG AA)
|
||
|
||
- ข้อความบนพื้น: **0 จุดต่ำกว่า 4.5:1** ทั้งโหมดสว่างและมืด (สแกน 8 หน้า)
|
||
- ปุ่มธีม 34×34px · **40×40px บนจอสัมผัส** (`@media (pointer: coarse)`)
|
||
- `aria-checked` + `role="radiogroup"` + `:focus-visible` 2px
|
||
- ไม่มี horizontal overflow ที่ 375px
|
||
|
||
### ข้อควรระวัง
|
||
|
||
- แผนที่ (Leaflet) ยังใช้ไทล์สว่าง — ตั้งใจให้เป็นเช่นนั้น (อ่านถนนง่ายกว่า)
|
||
- `--c-brand` คงที่ทั้ง 2 ธีม เพื่อรักษาเอกลักษณ์ม่วง; ที่เปลี่ยนคือ `--c-brand-ink` (ตัวอักษร)
|
||
|
||
## 4. ตัวพิมพ์ (Typography)
|
||
|
||
```css
|
||
--font-display: "K2D", "Prompt", "Noto Sans Thai", sans-serif; /* หัวเรื่อง — หนัก 600–800 (มีหัวแบบไทย) */
|
||
--font-body: "K2D", "Noto Sans Thai", "Sarabun", sans-serif; /* เนื้อหา — อ่านง่ายบนจอเล็ก */
|
||
--font-mono: "IBM Plex Mono", ui-monospace, monospace; /* เวลา + เลขสาย + ตัวเลข */
|
||
```
|
||
|
||
**ทำไม K2D:** ฟอนต์ไทย **มีหัว (Loop)** หัวเหลี่ยมโมเดิร์น ไม่เชย · น้ำหนักครบ 300–800 · ตัวเลขสวย (เข้าคู่กับ
|
||
`IBM Plex Mono` ที่ใช้กับเวลา/เลขสาย) · ใบอนุญาต SIL OFL
|
||
|
||
**ฝังไว้ในโปรเจกต์ (ไม่พึ่ง CDN):** ไฟล์อยู่ที่ `frontend/vendor/fonts/` — `k2d.css` (@font-face 18 กฎ · 6 น้ำหนัก ×
|
||
subset thai/latin/latin-ext · ~218 KB) + ไฟล์ `.woff2` 18 ไฟล์
|
||
· precache ใน `sw.js` → **ทำงานออฟไลน์ได้จริง** · อัปเดตฟอนต์ = โหลดชุดใหม่ทับ แล้ว bump `VERSION` ใน `sw.js`
|
||
· `Prompt` / `Noto Sans Thai` ยังโหลดจาก Google Fonts เป็นตัวสำรองใน Fallback chain (ออฟไลน์จะถอยไป `system-ui`)
|
||
|
||
| ระดับ | ฟอนต์ | ขนาด | ลักษณะ |
|
||
|---|---|---|---|
|
||
| H1 (hero) | display 800 | clamp(2.2rem, 6vw, 3.4rem) | ตัวตรง ไม่มี gradient |
|
||
| H2 (section) | display 700 | 1.35rem | + เส้นใต้สั้น 24px สี `--purple` |
|
||
| เลขสาย/รหัสป้าย/เวลา | mono 700 | 1.1–1.6rem | `font-variant-numeric: tabular-nums` |
|
||
| ป้าย micro-label | body 600 | 0.72rem | ภาษาอังกฤษ ตัวพิมพ์ใหญ่ `letter-spacing: 0.14em`, สี muted |
|
||
|
||
**กฎ:** ตัวเลข/รหัส/เวลาทุกตำแหน่งต้อง mono + tabular-nums — ตัวเลขต้องเรียงตรงกัน
|
||
|
||
---
|
||
|
||
## 5. องค์ประกอบ (Component Spec)
|
||
|
||
### การ์ดเส้นทาง / ป้าย (route card / stop tile)
|
||
- พื้น `--paper`, ขอบ `1px solid --line`, `radius: 8px`
|
||
- หัวการ์ด / รหัสป้าย: ตัวเลข mono ใหญ่บนพื้น `--grad-brand` ตัวอักษรขาว
|
||
- ชื่อ: body 700 ขนาด 1rem
|
||
- ข้อมูลรอง: muted 0.85rem
|
||
- hover: ขอบเปลี่ยนเป็น `--purple-300` + `translateY(-1px)` — **ห้ามใส่ shadow**
|
||
|
||
### ปุ่มแชร์หน้านี้ (`.mu-share-row` / `.mu-share-btn`)
|
||
ใช้ร่วมทุกหน้า — `/` · `/stops/:code` · `/routes/:id` · `/check/:id`
|
||
(ประกาศใน `styles/_shared.css` **ไม่ใช่** CSS ของหน้าใดหน้าหนึ่ง — เคยหลุดไปอยู่ใน `pages/home.css` ทำให้หน้าอื่นไม่มีสไตล์)
|
||
|
||
- **variant = ปุ่มรอง (ghost)** เพราะไม่ใช่ CTA หลักของหน้า — CTA หลักคือ topbar `.mu-action-btn`
|
||
- พื้น `--c-surface` · ขอบ `1px solid --c-border` · ตัวอักษร `--c-brand-ink` · weight 700
|
||
- `min-height: 44px` (48px เมื่อ `@media (pointer: coarse)`) · `padding: 10px 18px` · `gap: 6px`
|
||
- ไอคอน `.ic` 16px · `font-size: .85rem` · `line-height: 1`
|
||
- hover = ขอบ `#d8c9f2` + พื้น `--c-surface-2` (ไม่มี shadow) · active = `translateY(1px)`
|
||
- โฟกัส = `outline: 2px solid var(--c-focus)` + `offset: 2px` — **ห้ามใช้สีดำ/เทา**
|
||
- ข้อความสถานะ `.mu-share-status` ใช้ `--c-ink-2` · ลิงก์ที่คัดลอก `.mu-share-url` ใช้ mono + `tabular-nums` + `word-break: break-all`
|
||
- ปุ่มแชร์ LINE ใช้ `--c-brand-ink` (ม่วง) — **ไม่ใช้เขียว** เพราะ DESIGN ใช้แอคเซนต์เดียว
|
||
- มือถือ (<560px) = ปุ่มเต็มความกว้าง ข้อความชิดซ้าย
|
||
|
||
### สเกลที่บังคับใช้ (radius / type)
|
||
|
||
| หมวด | ค่าที่อนุญาต | โทเคน |
|
||
|---|---|---|
|
||
| มุมโค้ง | **4px · 8px · pill** เท่านั้น | `--radius-sm` · `--radius` · `--radius-pill` |
|
||
| ขนาดตัวอักษร | 0.72 · 0.78 · 0.85 · 0.95 · 1 · 1.1 · 1.2 · 1.35 · 1.5 · 1.6 · 1.8 · 2 · 2.2 rem | — |
|
||
| ปุ่ม | `min-height 44px` (48px จอสัมผัส) · `radius 8px` · `font-size .85rem` · weight 700 | — |
|
||
| โฟกัส | `outline 2px solid var(--c-focus)` · `offset 2px` | — |
|
||
|
||
> ค่า 12/14/16/18/20/22px และ 0.68/0.7/0.74/0.8/0.82/0.9/1.05 ฯลฯ ถูกยุบในรอบปรับปรุงนี้ — **ห้ามเพิ่มค่าใหม่นอกตาราง** ถ้าจำเป็นให้เพิ่มในไฟล์นี้ก่อน
|
||
|
||
### ชิปรหัส / เวลา (code chip / departure chip)
|
||
- รหัสป้าย/เลขสาย: พื้น `--grad-brand` ตัวอักษรขาว mono 700
|
||
- กลุ่มเวลาวางเป็น grid เรียงจากน้อยไปมาก
|
||
|
||
### เลขสายหน้า `/routes/:id` — พื้นหลังตามหมวดเส้นทาง
|
||
เลขสาย (`.mu-route-chip`) เปลี่ยนสีพื้นหลังตาม **หมวดเส้นทาง** ที่ประกาศใน
|
||
`frontend/public/resource/data/routes.json → route_group` (นิยามหมวดอยู่ที่ `route_groups.json`)
|
||
เพื่อให้อ่านปราดเดียวรู้ว่าสายนั้นเป็นสายประเภทใด
|
||
|
||
| หมวด (`route_group`) | สี | โทเคน | คลาส CSS |
|
||
|---|---|---|---|
|
||
| `bangkok` — เข้ากรุงเทพฯ | น้ำเงิน | `--group-bangkok` | `.grp-bangkok` |
|
||
| `interprovincial` — ระหว่างจังหวัด | ม่วง | `--group-interprovincial` | `.grp-interprovincial` |
|
||
| `in_province` — ภายในจังหวัด | ชมพู | `--group-in-province` | `.grp-in_province` |
|
||
| `municipal` — ภายในเทศบาล | เทา (สำรอง) | `--group-municipal` | `.grp-municipal` |
|
||
| ไม่ระบุ / ไม่รู้จัก | ม่วงแบรนด์ (ค่าเริ่มต้น) | `--grad-brand` | *(ไม่มีคลาส)* |
|
||
|
||
- ใช้เฉพาะ **การ์ดหัวเรื่องหน้ารายละเอียดสาย** (`/routes/:id`) — chip เล็กในหน้า `/stops` ยังใช้ม่วงแบรนด์
|
||
- **เพิ่มหมวดใหม่** = เพิ่ม `route_group` ใน `route_groups.json` + โทเคนสีใน §3 + กฎ `.grp-<key>` ใน `busDetail.html`
|
||
- สีของหมวด **ไม่ใช่** สีสถานะ — ห้ามนำไปใช้กับ badge สถานะ (§5 ป้ายสถานะ)
|
||
|
||
### ป้ายสถานะ (status badge)
|
||
- พื้นสีอ่อน (`--green-50` / `--red-50` / `--amber-50`) + ตัวอักษรสีเข้มของเฉดนั้น
|
||
- ใช้เฉพาะบอกสถานะจริง ไม่ใช่แค่ตกแต่ง
|
||
|
||
### หัวโซน (zone head) — ป้ายหัวข้อ + บรรทัดข้อมูล
|
||
ใช้กับทุกโซนที่มีป้ายกำกับ (`.mu-zone-head`) เช่น `/check` (`ตารางเวลาเดินรถทุกจุดจอด`) และ `/routes/:id` (แผนที่)
|
||
|
||
- ป้ายหัวข้อ (`.mu-zone-tag`) — แคปซูลสีอ่อนตามโทนของโซน (tag-purple / tag-sky / tag-pink / tag-yellow)
|
||
- **บรรทัดข้อมูลต้องแยกเป็น "ชิ้น" (`.mu-zone-seg`)** ไม่ใช่สตริงยาว ๆ ที่ต่อด้วย `·` เอง
|
||
- เหตุผล: ภาษาไทยไม่มีเว้นวรรค → ถ้าเป็นสตริงเดียว เบราว์เซอร์จะ **ตัดกลางชื่อสถานี**
|
||
- แต่ละชิ้นเป็น flex item → ตัดบรรทัดเป็นหน่วย · ตัวคั่น `·` วาดด้วย `::after` (ท้ายชิ้น ไม่ขึ้นต้นบรรทัด)
|
||
- ชิ้นที่เล็กลง (เช่น ชื่อสถานีในวงเล็บ `.mu-zone-at`) ช่วยให้บรรทัดจัดเรียงสวยขึ้น
|
||
- **มือถือ (<768px)** — ป้ายหัวข้อบรรทัดบน · บรรทัดข้อมูลเต็มความกว้าง เรียงลงมา (flex + wrap)
|
||
- **จอใหญ่ (≥768px)** — เปลี่ยนเป็น **grid 2 คอลัมน์**: ป้ายหัวข้อซ้าย · บรรทัดข้อมูลคอลัมน์ขวา
|
||
· จำกัดความยาวบรรทัด `max-width: 82ch` (กันบรรทัดยาวเกินอ่านยาก)
|
||
- ห้ามใช้ `flex` โดยไม่ใส่ `flex-wrap` ร่วมกับลูกที่เป็น `flex-basis:100%` (จะถูกบีบรวมแถวเดียว)
|
||
|
||
### แถบนำทาง (topbar)
|
||
- พื้น `--paper` (ขาว) ตัวอักษร `--ink` ขอบล่าง `1px solid --line`
|
||
- active menu = เส้นใต้ `--purple`
|
||
- CTA "เช็กเวลาเดินรถ" = พื้น `--grad-brand` ตัวอักษรขาวหนา
|
||
|
||
#### เครื่องมือในแถบนำทาง — "ปุ่มละเรื่อง" (`.mu-topbar-tools`)
|
||
**ห้ามวางกลุ่มปุ่มเรียงเป็นแถว** (เช่น ปุ่มธีม 3 ปุ่ม + ปุ่มภาษา 2 ปุ่ม = 5 ปุ่ม) เพราะทำให้แถบนำทางแน่นและล้นบนจอเล็ก
|
||
|
||
| ปุ่ม | แสดง | กดแล้ว |
|
||
|---|---|---|
|
||
| ธีม (`.mu-pop-btn`) | ไอคอนของโหมดที่ใช้อยู่ (สว่าง/มืด/ตามเวลา) | เปิดเมนู 3 ตัวเลือก `role="menuitemradio"` |
|
||
| ภาษา (`.mu-pop-btn-lang`) | รหัสภาษาที่ใช้อยู่ (`ไทย` / `EN`) + chevron | เปิดเมนู 2 ภาษา |
|
||
|
||
- **มือถือ (<640px)** — โลโก้ชิดซ้าย · `(ธีม)(ภาษา)(3 ขีด)` ชิดขวา โดย **3 ขีดอยู่ขวาสุด**: `flex-wrap: nowrap` · `margin-inline-start: auto` ที่ `.mu-topbar-tools` · `order: 2` (tools) / `3` (menu)
|
||
- **≥640px** — เมนู 3 ขีดซ่อน แสดง `.mu-nav` แทน · `≥1024px` เพิ่มปุ่ม CTA
|
||
- ปุ่มกลมเหลี่ยม `height 40px` · `radius 8px` · ขอบ `--c-border` · ตัวอักษร `--c-brand-ink`
|
||
- จอสัมผัส → `44px`
|
||
- ระยะห่างระหว่างปุ่ม **≥ 8px** (WCAG 2.5.8)
|
||
- เมนู `.mu-pop-panel` ชิดขวา `z-index: 1200` (เหนือ topbar 1100 · ใต้ visitor dialog 3000)
|
||
- ปิดเมนูด้วย: เลือกแล้ว · คลิกนอก · `Esc` (คืนโฟกัสที่ปุ่ม)
|
||
- ข้อความในเมนูมีทั้งไทยและอังกฤษกำกับ (`.mu-pop-item-th` / `.mu-pop-item-en`)
|
||
|
||
#### ปุ่มขอบ (`.mu-btn.outline`)
|
||
พื้นโปร่งใส + ขอบและตัวอักษร `--c-brand-ink` — **ต้องมีกฎนี้เสมอ** ถ้าไม่มี เบราว์เซอร์จะใส่พื้นเทาอ่อนเองและหลุดธีมในโหมดมืด
|
||
|
||
### ฟอร์มค้นหา
|
||
- พื้น `--paper` ขอบ `--line`, โฟกัส = ขอบ `--purple-300` — ไม่มี glow
|
||
- ช่องกรอกแบบแบ่งกล่อง (รหัสป้าย) ใช้ mono + กล่องละ 1 หลัก
|
||
|
||
---
|
||
|
||
## 6. วิธีเขียนงานออกแบบใหม่ (สำหรับ AI)
|
||
|
||
เมื่อได้รับงาน "ออกแบบ/ปรับ UI" ให้ทำตามลำดับ:
|
||
|
||
1. **ห้ามเริ่มเขียนโค้ดทันที** — เขียน mockup spec 1 ย่อหน้า: concept นี้คืออะไร, ใช้สี/ฟอนต์/ลวดลายอะไร
|
||
2. ใช้โทเคนจากหัวข้อ 3–4 เท่านั้น — ถ้าสี/ขนาดไม่พอ ค่อยเพิ่มในไฟล์นี้ (ไม่ใช่ inline ในโค้ด)
|
||
3. ใช้ class เดิม + ปรับ CSS ตาม spec — ห้ามสร้าง class ใหม่ทั้งชุดโดยไม่จำเป็น
|
||
4. ตรวจกฎ "ห้ามทำ" (หัวข้อ 2) ก่อนสรุปงาน
|
||
|
||
## 7. เอกสารอ้างอิงเชิงภาพ (moodboard ภาษา)
|
||
|
||
- พื้นหลังไล่เฉดขาว→ม่วงอ่อน (single-hue fade) — สะอาด ไม่มีสีรุ้ง
|
||
- ป้าย/CTA ม่วง `#7a4cc0` ตัดกับพื้นขาว — แอคเซนต์เดียว ชัดเจน
|
||
- ตัวเลขรหัสป้ายแบบ mono + tabular — เรียงตรงกันเหมือนป้ายจริง
|
||
- เส้นแบ่งบาง ๆ ม่วงอ่อน `#e7e0f6` — แบ่งองค์ประกอบ ไม่ใช้เงา
|
||
|
||
---
|
||
|
||
*ไฟล์นี้มีผลบังคับใช้กับทุกงานออกแบบในโปรเจกต์ — ถ้าอยากเปลี่ยนทิศทางศิลป์ ต้องแก้ไฟล์นี้ก่อน แล้วค่อยเขียนโค้ด*
|
||
|
||
---
|
||
|
||
## 9. รูปภาพ (Asset cache)
|
||
|
||
รูปทุกตัวเติม `?v=<เวอร์ชันแอป>` อัตโนมัติผ่าน `frontend/imageurl.js` — เปลี่ยนรูปทับชื่อเดิมแล้ว
|
||
ต้องรัน `python resource/tools/bump-version.py` เพื่อให้ทุกเครื่องเห็นของใหม่ (รายละเอียดใน AGENTS.md)
|