fix(motion): คืนอนิเมชัน reveal ที่หายไป + จดข้อยกเว้นเบราว์เซอร์

สาเหตุ: hydration เขียนทับ class ของ <html> ทำให้ `fx-motion` หลุด
และอนิเมชันเดิมผูกกับคลาสนั้นอย่างเดียว → อนิเมชันหายทั้งเว็บ

- ผูก "ตัวอนิเมชัน" กับ @media (prefers-reduced-motion: no-preference)
  (สถานะซ่อนก่อน reveal ยังผูกกับ html.fx-motion เพื่อกันเนื้อหาหายเมื่อปิด JS)
- เพิ่ม <MotionBootstrap/> เติมคลาส fx-motion ซ้ำหลัง hydration + ฟังการเปลี่ยน reduced-motion
- คืน @keyframes fx-swap-in ที่หลุดไประหว่างแก้ CSS
- DESIGN.md: Motion contract สองชั้น + ตารางข้อยกเว้นต่อเบราว์เซอร์ (scrollbar/share/install/blur/ฟอนต์ไทย/ITP)
- sw VERSION v2.0.4
This commit is contained in:
Bkk1234 committed 2026-11-14 13:18:42 +07:00
1 parent 2eb625c8bc
commit cfb24b8138
4 files changed
+92 -40

No files matched your search

+22 -2
View File
@@ -74,8 +74,14 @@ part of that build, not leave them as an empty template.
## Motion contract (บังคับ)
- อนิเมชันทั้งหมดอยู่ใน `app/global.css` ใต้ `html.fx-motion` — คลาสนี้ถูกใส่โดยสคริปต์ใน `<head>` (`MOTION_INIT_SCRIPT`, `app/lib/motion.ts`) **เฉพาะเมื่อผู้ใช้ไม่ได้ขอ `prefers-reduced-motion: reduce`** → ปิด JS หรือ reduced motion = ไม่มีอะไรถูกซ่อน (ห้ามเขียน `opacity:0` นอกขอบเขตนี้)
- ใช้ `transform`/`opacity` เท่านั้น ห้าม animate `width/height/top/left` · ระยะเวลา: เร็ว 160ms · ปกติ 280ms · **เปลี่ยนหน้า 460ms (`--fx-page`)** · reveal 640ms · หน่วงต่อชิ้นไม่เกิน ~240ms
- ทุกอนิเมชันใช้ **`transform` / `opacity` เท่านั้น** (ห้าม `width/height/top/left`) · ตัวแปร: `--fx-fast 160ms`, `--fx-base 280ms`, `--fx-page 460ms`, `--fx-slow 640ms`, `--fx-ease-out cubic-bezier(0.16,1,0.3,1)` · หน่วงต่อชิ้นไม่เกิน ~240ms
- **การเปิด/ปิดอนิเมชันมีสองชั้น — ต้องมีทั้งคู่**:
1. **สถานะ "ซ่อนก่อน reveal"** ผูกกับ `html.fx-motion [data-reveal]{opacity:0}` — คลาสนี้ใส่โดยสคริปต์ใน `<head>` (`MOTION_INIT_SCRIPT`) **และเติมซ้ำโดย `<MotionBootstrap/>`** (effect ฝั่ง client) เพราะพบว่า hydration เขียนทับ `class` ของ `<html>` ทำให้คลาสหลุด
2. **ตัวอนิเมชัน** ผูกกับ `@media (prefers-reduced-motion: no-preference)` ไม่ใช่คลาส → ถ้าคลาสหลุดอีก อนิเมชันก็ยังทำงาน และถ้าผู้ใช้ขอ reduced motion ทุกอย่างนิ่ง+เห็นครบ
- ห้ามย้ายตัวอนิเมชันกลับไปผูกกับ `html.fx-motion` อย่างเดียว (เคสจริง: อนิเมชันหายทั้งเว็บหลัง hydration ลบคลาส)
- hover ของการ์ดใช้ `translate` (Tailwind `hover:-translate-y-1`) ไม่ใช้ `transform` เพราะชนกับ keyframe ของ reveal · `.fx-swap` (แกลเลอรี) ใช้ `@keyframes fx-swap-in` — ห้ามลบ keyframes นี้
- สรุปตำแหน่งโค้ด: `@keyframes` + สถานะซ่อน + media query อยู่ใน `app/global.css` ท้ายไฟล์ (`fx-*`) · สคริปต์ตั้งต้นอยู่ `app/lib/motion.ts` · ตัวเติมคลาสซ้ำคือ `<MotionBootstrap/>` ใน `app/root.tsx`
- "ค่อย ๆ โผล่เมื่อเลื่อนถึง" ใช้ `useReveal` (`app/hooks/use-reveal.ts`) หรือ `<Reveal>` (`app/components/site/Reveal.tsx`) — มีกฎกันค้างซ่อน: บล็อกที่เลื่อนผ่านไปแล้ว (หรือถูกข้ามด้วยการกระโดด scroll) ต้องโผล่ทันที
- hover ของการ์ดใช้ `translate` (Tailwind `hover:-translate-y-1`) ไม่ใช้ `transform` เพราะชนกับ keyframe ของ reveal · ทุกอนิเมชันต้องมีคู่มือปิดใน `@media (prefers-reduced-motion: reduce)`
@@ -105,6 +111,20 @@ part of that build, not leave them as an empty template.
- **สิ่งที่ต่างโดยธรรมชาติ ไม่ต้องแก้**: Firefox ไม่มี `navigator.share` / install prompt · Safari ไม่มี install prompt (`beforeinstallprompt` ไม่มี แต่ `display: standalone` ใน manifest ทำให้ติดตั้งจากเมนูแชร์ได้) · iOS ล้าง cache ของ SW เมื่อไม่ใช้งาน 7 วัน (ITP) · inertia การเลื่อนต่างกัน
- ทดสอบ: `/`, `/cinema/<slug>`, `/for-cinemas`, `/admin` ในทั้งสามเอนจิน — สกรอลบาร์/select/`<details>`/ปุ่ม/ขนาดช่องค้นหาต้องเท่ากัน (มือถือ 16px, เดสก์ท็อป 14px)
### ข้อยกเว้นต่อเบราว์เซอร์ (exception list — ตั้งใจปล่อยไว้)
| เรื่อง | Chromium | Firefox | Safari | สิ่งที่ทำ |
|---|---|---|---|---|
| ความกว้างสกรอลบาร์ | 5px (`::-webkit-scrollbar`) | ได้แค่ `thin` (~8px) — `scrollbar-width` ไม่รับ px | overlay (ไม่แสดงถ้าไม่เลื่อน) | ยอมรับความต่างเล็กน้อย |
| สีสกรอลบาร์ตอน hover | เปลี่ยนได้ (`::-webkit-scrollbar-thumb:hover`) | **ไม่ได้** (ไม่มี pseudo-element ของ scrollbar) | ไม่ได้ | ปล่อย |
| ปุ่ม X ในช่องค้นหา | ซ่อนได้ (`::-webkit-search-cancel-button`) | **ซ่อนไม่ได้** → FF แสดง X เอง | แสดง X เอง | ปล่อย (เป็น UI ของเบราว์เซอร์) |
| `navigator.share` | ✅ (Windows/Android) | ❌ เดสก์ท็อป | ✅ ดีที่สุด | fallback คัดลอกลิงก์ |
| PWA install prompt | ✅ `beforeinstallprompt` | ❌ | ❌ (ติดตั้งผ่านเมนูแชร์) | ไม่พึ่ง event นี้ |
| `backdrop-filter` | เร็ว | ช้ากว่ามาก | กลาง | จำกัด blur ≤ 24px |
| ฟอนต์ไทย (shaping) | ต่างจาก FF เล็กน้อย | ต่างจาก Chromium เล็กน้อย | ต่างที่สุดถ้าไม่มี Noto | ยอมรับ — ทางแก้คือ self-host subset |
| `dvh` | ✅ | 101+ | 15.4+ | ใช้ได้ แต่ถ้าต้องรองรับเก่ากว่านี้ต้องมี `100vh` สำรอง |
| cache ของ SW | คงอยู่จน bump VERSION | คงอยู่ | **ถูกล้างหลังไม่ใช้งาน 7 วัน (ITP)** | ยอมรับ |
## Agent-Native is structural, not visual
This shell already meets the Agent-Native contract: data in SQL, actions as the
+46 -37
View File
@@ -400,31 +400,6 @@
}
}
/* สถานะตั้งต้น: ซ่อนเฉพาะเมื่อ motion เปิดอยู่ (JS ใส่คลาสแล้วเท่านั้น) */
html.fx-motion [data-reveal] {
opacity: 0;
}
html.fx-motion [data-reveal="rise"][data-revealed] {
animation: fx-rise-in var(--fx-slow) var(--fx-ease-out) var(--fx-delay, 0ms)
both;
}
html.fx-motion [data-reveal="fade"][data-revealed] {
animation: fx-fade-in var(--fx-base) var(--fx-ease-out) var(--fx-delay, 0ms)
both;
}
html.fx-motion [data-reveal="zoom"][data-revealed] {
animation: fx-pop-in var(--fx-slow) var(--fx-ease-out) var(--fx-delay, 0ms)
both;
}
/* อนิเมชันตอนโหลด (ไม่ผูกกับ scroll) */
html.fx-motion .fx-page {
animation: fx-page-in var(--fx-page) var(--fx-ease-out) both;
}
/* สลับภาพในแกลเลอรี (ปุ่มลูกศร) — จางเข้าเบา ๆ ไม่กระตุก */
@keyframes fx-swap-in {
from {
@@ -437,25 +412,59 @@ html.fx-motion .fx-page {
}
}
html.fx-motion .fx-swap {
animation: fx-swap-in 320ms var(--fx-ease-out) both;
/* ══ สถานะตั้งต้น + อนิเมชัน reveal ══════════════════════════════════════
กันสองทาง:
1) เนื้อหาห้ามหายถ้าปิด JS → สถานะ "ซ่อน" ผูกกับคลาส `html.fx-motion`
(คลาสถูกใส่โดยสคริปต์ใน <head> และเสริมอีกครั้งจาก client effect)
2) อนิเมชันต้องทำงานแม้คลาสหลุด (เคยเกิดจาก hydration ลบคลาส) → ตัวอนิเมชัน
ผูกกับ `@media (prefers-reduced-motion: no-preference)` แทน
ผลคือทุกเอนจิน (Chromium / Firefox / Safari) ได้อนิเมชันเหมือนกัน และ
ผู้ใช้ที่ขอ reduced motion ได้เนื้อหานิ่งครบทันที */
html.fx-motion [data-reveal] {
opacity: 0;
}
html.fx-motion .fx-drop {
animation: fx-drop-in var(--fx-base) var(--fx-ease-out) both;
}
@media (prefers-reduced-motion: no-preference) {
[data-reveal="rise"][data-revealed] {
animation: fx-rise-in var(--fx-slow) var(--fx-ease-out) var(--fx-delay, 0ms)
both;
}
html.fx-motion .fx-hero-image {
animation: fx-hero-zoom 1400ms var(--fx-ease-out) both;
[data-reveal="fade"][data-revealed] {
animation: fx-fade-in var(--fx-base) var(--fx-ease-out) var(--fx-delay, 0ms)
both;
}
[data-reveal="zoom"][data-revealed] {
animation: fx-pop-in var(--fx-slow) var(--fx-ease-out) var(--fx-delay, 0ms)
both;
}
/* อนิเมชันตอนโหลด (ไม่ผูกกับ scroll) */
.fx-page {
animation: fx-page-in var(--fx-page) var(--fx-ease-out) both;
}
.fx-swap {
animation: fx-swap-in 320ms var(--fx-ease-out) both;
}
.fx-drop {
animation: fx-drop-in var(--fx-base) var(--fx-ease-out) both;
}
.fx-hero-image {
animation: fx-hero-zoom 1400ms var(--fx-ease-out) both;
}
}
/* ทางออกสุดท้าย: ถ้าผู้ใช้ขอ reduced motion ให้ทุกอย่างนิ่งและเห็นครบ */
@media (prefers-reduced-motion: reduce) {
html.fx-motion [data-reveal],
html.fx-motion .fx-page,
html.fx-motion .fx-drop,
html.fx-motion .fx-swap,
html.fx-motion .fx-hero-image {
[data-reveal],
.fx-page,
.fx-drop,
.fx-swap,
.fx-hero-image {
animation: none !important;
opacity: 1 !important;
transform: none !important;
+23
View File
@@ -124,6 +124,28 @@ function ServiceWorkerSetup() {
return null;
}
/**
* เติมคลาส `fx-motion` ซ้ำฝั่ง client
*
* ทำไมต้องมี: สคริปต์ใน <head> ใส่คลาสนี้ก่อน paint แล้ว แต่พบว่า hydration
* เขียนทับ `class` ของ <html> ทำให้คลาสหลุด → เนื้อหาที่ควร "ค่อย ๆ โผล่"
* กลายเป็นโผล่ทันที (อนิเมชันหาย) · effect นี้รันหลัง hydration จึงเติมกลับให้เสถียร
* ตัวอนิเมชันเองผูกกับ `@media (prefers-reduced-motion: no-preference)` แล้ว
* จึงยังทำงานได้แม้คลาสหลุด (คลาสมีหน้าที่แค่ "ซ่อนก่อน reveal" ไม่ให้กระพริบ)
*/
function MotionBootstrap() {
useEffect(() => {
const query = window.matchMedia("(prefers-reduced-motion: reduce)");
const sync = () => {
document.documentElement.classList.toggle("fx-motion", !query.matches);
};
sync();
query.addEventListener("change", sync);
return () => query.removeEventListener("change", sync);
}, []);
return null;
}
export default function Root() {
const [queryClient] = useState(() => createAgentNativeQueryClient());
const { content, localeFromUrl, shareOrigin } =
@@ -141,6 +163,7 @@ export default function Root() {
<AppProviders queryClient={queryClient}>
<DbSyncSetup />
<ServiceWorkerSetup />
<MotionBootstrap />
<AppLayout>
<Outlet />
</AppLayout>
+1 -1
View File
@@ -18,7 +18,7 @@
* | โดเมนอื่น (รูป hotlink) | ไม่จัดการ |
* | /app/* · /node_modules/* · /@* | ไม่จัดการ (โมดูลของ dev server) |
*/
const VERSION = "v2.0.3";
const VERSION = "v2.0.4";
const PAGES_CACHE = `alterflixhub-pages-${VERSION}`;
const ASSETS_CACHE = `alterflixhub-assets-${VERSION}`;