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:
1 parent
2eb625c8bc
commit
cfb24b8138
4 files changed
+92
-40
No files matched your search
@@ -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
@@ -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;
|
||||
|
||||
@@ -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
@@ -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}`;
|
||||
|
||||
|
||||
Reference in new issue
Block a user