84 lines
8.3 KiB
Markdown
84 lines
8.3 KiB
Markdown
# DESIGN.md — ค่าออกแบบของเว็บ farm-planning
|
||
|
||
> เวอร์ชัน 2 (16 พ.ย. 2026) — เปลี่ยนธีมเป็น **ฟ้า-ขาว** ตามที่ผู้ใช้กำหนด
|
||
> เอกสารนี้คือค่าที่ใช้จริงในโค้ด: ถ้าจะเปลี่ยน ต้องแก้ที่นี่ก่อน แล้วแก้โค้ดตาม
|
||
|
||
## 0. ที่มาของการตัดสินใจ (สำคัญ)
|
||
|
||
| ส่วน | มาจากไหน |
|
||
|---|---|
|
||
| **โครงสร้างหน้า** (Hero → เครื่องมือ/ฟีเจอร์ → ประโยชน์ → ความน่าเชื่อถือ → CTA) | `ui-ux-pro-max` pattern "Feature-Rich Showcase" + โครงหน้า `fastwork.com/selling` ที่ผู้ใช้ให้เป็นต้นแบบ (hero + service row + การ์ดหลักฐาน) |
|
||
| **ค่าสี / ฟอนต์ / รัศมี** | ผู้ใช้กำหนด "ธีม ฟ้า-ขาว" · โทเคนน้ำเงินมาจากพาเลตต์ SaaS (`#2563EB`) และตรวจคอนทราสต์ทุกคู่ด้วยการคำนวณ WCAG |
|
||
| **คู่สีที่ยืนยันแล้ว** | ขาว/`#2563EB` = 5.17:1 · ขาว/`#1D4ED8` = 6.70:1 · `#1D4ED8`/`#EFF6FF` = 6.16:1 · `#475569`/ขาว = 7.58:1 · `#1E293B`/`#F8FAFC` = 13.98:1 |
|
||
|
||
## 1. สี
|
||
|
||
| โทเคน | ค่า | ใช้ที่ |
|
||
|---|---|---|
|
||
| `--primary` | `#2563eb` | ปุ่มหลัก, พื้นหลังปุ่มติดตั้ง, ปุ่มขึ้นบน |
|
||
| `--primary-dark` | `#1d4ed8` | ตัวเลขผลลัพธ์, nav ที่ active, ลิงก์ hover |
|
||
| `--primary-soft` | `#eff6ff` | พื้นชิป/ป้าย, พื้น hover ของ nav, หัวการ์ด |
|
||
| `--primary-line` | `#bfdbfe` | ขอบชิป, ขอบปุ่มรอง, ขอบ hover |
|
||
| `--bg` | `#f8fafc` | พื้นหลังเว็บ (ทั้งแอป) |
|
||
| `--surface` | `#ffffff` | การ์ด, ฟอร์ม, footer |
|
||
| `--ink` | `#1e293b` | ตัวอักษรหลัก |
|
||
| `--muted` | `#475569` | คำอธิบาย/hint |
|
||
| `--line` | `#e2e8f0` | เส้นขอบ/เส้นคั่น |
|
||
| `--warn` / `--warn-soft` | `#b45309` / `#fffbeb` | กล่องคำเตือน |
|
||
| `--ok` / `--ok-soft` | `#166534` / `#f0fdf4` | ป้าย "ออนไลน์" |
|
||
| `--danger` / `--danger-soft` | `#b91c1c` / `#fef2f2` | ข้อความผิดพลาด |
|
||
|
||
`theme-color` (meta + manifest) = `#2563eb` · `background_color` (manifest) = `#f8fafc`
|
||
|
||
**ห้าม** ใช้สีส้ม `#F05F40` ของเทมเพลตเดิมในหน้าเว็บ — เป็นสีตกค้างจาก creative.css
|
||
(ตรวจแล้วทุกหน้าปัจจุบันไม่มี element ที่คำนวณออกมาเป็นสีนี้)
|
||
|
||
## 2. ฟอนต์
|
||
|
||
| ใช้ที่ | ฟอนต์ |
|
||
|---|---|
|
||
| เนื้อความ | `Sarabun` → `Kanit` → system-ui |
|
||
| หัวข้อ (h1–h5, `.page-title`, `.section-head h2`) | `Kanit` |
|
||
| ตัวเลขผลลัพธ์ / build badge | `font-variant-numeric: tabular-nums` / `ui-monospace` |
|
||
|
||
ขนาด: เนื้อความ 16px, line-height 1.6 · hero h1 1.65rem (มือถือ) → 2.15rem (≥640) → 2.5rem (≥1024)
|
||
· `.page-title` 1.55rem → 2rem · `.section-head h2` 1.35rem → 1.6rem
|
||
|
||
## 3. ระยะและรัศมี
|
||
|
||
- mobile-first: base = มือถือ, ขยายด้วย `@media (min-width: 640/768/1024px)` เท่านั้น
|
||
- รัศมี: `--r-sm` 8px (input, ชิป) · `--r-md` 12px (ปุ่ม, tool row) · `--r-lg` 16px (การ์ด, ฟอร์ม, ผลลัพธ์)
|
||
- เงา: `--shadow-sm` (การ์ดปกติ) → `--shadow-md` (hover, ปุ่มลอย) — ไม่ใช้เงาหนัก
|
||
- ทุกปุ่ม/ช่องกรอก/แถวที่กดได้สูง **≥ 44px** (วัดที่ 360/768/1280 แล้ว)
|
||
- `.view-root` padding-top 64px (68px ที่ ≥1024) เผื่อ navbar fixed
|
||
|
||
## 4. คอมโพเนนต์
|
||
|
||
| ชื่อ | กติกา |
|
||
|---|---|
|
||
| `#mainNav` | พื้นขาว 96% + เส้นขอบล่าง · แบรนด์สีน้ำเงิน / น้ำหนัก 600 · ลิงก์เทา `--muted` / active = พื้น `--primary-soft` + น้ำเงิน (ไม่ใช้สีพื้นทึบ) |
|
||
| `.hero` | พื้น gradient ฟ้าอ่อน + radial จากมุมซ้ายบน, ปิดท้ายด้วยเส้นขอบล่าง · `.hero-eyebrow` ชิป, `.hero h1` มี `<strong>` เป็นสีน้ำเงิน, `.hero-cta` 2 ปุ่ม, `.hero-stats` 2→4 คอลัมน์ |
|
||
| `.tool-row` | แถวเครื่องมือแบบ service row: ไอคอน 44px ในพื้นฟ้าอ่อน + ชื่อ + meta + ปลายทาง ("คำนวณ →") · hover ยกขึ้น 1px + เงา · `.tool-row--soon` จาง + กดไม่ได้ + `.chip--soon` |
|
||
| `.card` | พื้นขาว ขอบ `--line` รัศมี 16px · hover เปลี่ยนขอบเป็น `--primary-line` + เงา · การ์ดที่เป็นลิงก์ทั้งใบให้สีตัวอักษรเป็น `inherit` |
|
||
| `.feature-card` | การ์ด 3 ใบในส่วน "ตัวเลขที่ให้ไป ตรวจย้อนได้" · มี `.feature-card__num` วงกลมเลขลำดับ |
|
||
| `.calc` | ฟอร์มในการ์ดขาว: 1 คอลัมน์ → 2 คอลัมน์ที่ ≥640 · ปุ่ม/ช่องเต็มความกว้างด้วย `.field--wide` |
|
||
| `.result` | การ์ดขาว ขอบซ้าย 4px สี `--primary` · `.result-value` 1.9rem ตัวหนา สี `--primary-dark` |
|
||
| `.steps` | ตาราง "ที่มาของค่า" — แถวสลับสีอ่อน, คอลัมน์ขวาชิดขวา + tabular-nums |
|
||
| `.warn-list` | กล่องเหลืองอ่อน ขอบ `#fde68a` ตัวอักษร `--warn` · ซ่อนด้วย `hidden` + `[hidden]{display:none}` |
|
||
| `#install-btn` | มือถือเต็มความกว้างล่างจอ / ≥640px กว้าง 15rem มุมขวาล่าง · พื้น `--primary` |
|
||
| `#myBtn` | ปุ่มลอยมุมขวาล่าง ทรงแคปซูล พื้น `--primary` |
|
||
|
||
## 5. Interaction / a11y
|
||
|
||
- ระยะเปลี่ยนสถานะ 150–200ms (hover/press), ปุ่มกดแล้วขยับ 1px
|
||
- `:focus-visible` = outline 2px `--primary` + offset 2px (ไม่ลบ focus ring)
|
||
- `prefers-reduced-motion: reduce` → ปิด transition/animation และ scroll แบบ smooth
|
||
- ไม่ใช้ emoji เป็นไอคอน · ไอคอนใช้ SVG ในโปรเจกต์ (`flat icon/`) ที่อยู่ใน PRECACHE
|
||
- ภาษาไทยบนหน้าเว็บ: ใช้ "ต้นทาง/กลางทาง/ปลายทาง" ไม่ใช้ "จุดเปลี่ยน"; เลี่ยงคำอังกฤษลอย (คำเทคนิคที่จำเป็นให้คงไว้พร้อมคำอธิบาย)
|
||
|
||
## 6. ข้อห้าม
|
||
|
||
- ห้าม hardcode สีใน partial — ใช้ตัวแปรจาก `:root` ใน `assets/css/app.css`
|
||
- ห้ามใส่ `!important` ยกเว้นกรณีชนกับ `css/creative.css` ของเทมเพลตเดิม (ระบุเหตุผลในคอมเมนต์)
|
||
- ห้ามเพิ่มไลบรารี UI ใหม่ถ้าเขียน vanilla CSS ได้
|