diff --git a/DESIGN.md b/DESIGN.md index b76eef5..1aea03c 100644 --- a/DESIGN.md +++ b/DESIGN.md @@ -115,6 +115,54 @@ - **ชื่อเฉพาะไม่แปล** — ชื่อสถานี จังหวัด สายรถ (ภาษาไทยเสมอ) - **ตรวจก่อน 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 diff --git a/frontend/src/app/layout.tsx b/frontend/src/app/layout.tsx index 44372fc..2302f13 100644 --- a/frontend/src/app/layout.tsx +++ b/frontend/src/app/layout.tsx @@ -6,6 +6,7 @@ import SiteFooter from "@/components/SiteFooter"; import SiteHeader from "@/components/SiteHeader"; // ลำดับ CSS ต้องตรงกับ mock: shared → map → shell → responsive +import "@/styles/theme.css"; import "@/styles/_shared.css"; import "@/styles/map.css"; import "@/styles/shell.css"; @@ -61,6 +62,12 @@ export default function RootLayout({ children }: { children: React.ReactNode }) {/* theme-color / apple-touch-icon / apple-mobile-web-app-* / mobile-web-app-capable ถูก emit อัตโนมัติจาก metadata.appleWebApp + metadata.icons + viewport.themeColor — อย่าใส่ซ้ำที่นี่ (จะได้ meta ซ้ำ 2 ชุด) */} + {/* ตั้งธีมก่อนวาดหน้าจอ (กันจอขาววูบตอนเปิดแอปในโหมดมืด) */} +