Files
Bkk1234 319c271d23 feat: บทความ 2 หน้า + แชร์/ลิงก์ย่อ + PWA + แอนิเมชัน + SEO/AI + เอกสาร
- บทความจากหลังบ้าน: /for-film-lovers, /for-cinemas (ArticlePage + ArticleEditor แบบบล็อกย่อหน้า/รูป)
- แชร์: ปุ่มบนการ์ดและท้ายหน้ารายละเอียด · ลิงก์ย่อ /c/<slug> (302) · ธีมแก้วตาม DESIGN.md
- PWA: manifest/sw/offline + ถอดการล็อกซูม (WCAG 1.4.4) + touch target ≥44px
- แอนิเมชัน reveal: IntersectionObserver + gate ด้วย html.fx-motion · เคารพ prefers-reduced-motion
- ค้นหา: normalize/ตัดวรรณยุกต์ + AND หลายคำ + จัดอันดับ · รองรับ /?q= จาก SearchAction
- SEO: pageMeta (canonical/OG/Twitter) + JSON-LD (WebSite/Organization/BreadcrumbList/MovieTheater/Article)
- ไม่ฝังโดเมนในโค้ด: origin มาจาก request (x-forwarded-host/proto) ทั้ง canonical, sitemap, robots, ลิงก์แชร์
- กัน AI: robots.txt (Nitro route, บล็อก AI 21 ตัว) + ai.txt + OG image 1200x630
- เอกสาร: README สรุปโปรเจกต์, DESIGN.md (motion/PWA/SEO/ข้อมูล), architecture.html, admin-guide
- tests: 135 ผ่าน (16 ไฟล์)
2026-11-10 02:31:10 +07:00

62 lines
3.0 KiB
TypeScript

import { useEffect, useRef, useState, type CSSProperties } from "react";
/**
* ระยะที่ถือว่า "ใกล้พอจะโผล่"
* - `2000px` ด้านบน: ถ้าผู้ใช้เลื่อนข้ามไกล ๆ (หรือกลับเข้าหน้าที่ scroll ค้างอยู่)
* บล็อกที่อยู่เหนือจอจะถูกนับว่าถึงแล้ว → ไม่ค้างซ่อน
* - `-6%` ด้านล่าง: รอให้บล็อกโผล่เข้ามาในจอก่อนเริ่มอนิเมชันเล็กน้อย
*/
const REVEAL_ROOT_MARGIN = "2000px 0px -6% 0px";
/** ต้องเห็นบล็อกอย่างน้อย 6% ก่อนจึงเริ่มโผล่ */
const REVEAL_THRESHOLD = 0.06;
/**
* hook สำหรับ "ค่อย ๆ โผล่" เมื่อเลื่อนมาถึง (IntersectionObserver)
*
* คืน ref + style ที่ใส่วงหน่วง (stagger) ให้เอง — class/animation อยู่ใน global.css
* ใต้ `html.fx-motion` ดังนั้นถ้าผู้ใช้ขอ reduced motion หรือ JS ไม่ทำงาน
* เนื้อหาก็ยังแสดงปกติ (ไม่มีคลาส = ไม่มีอะไรถูกซ่อน)
*/
export function useReveal<T extends HTMLElement = HTMLDivElement>(delayMs = 0) {
const ref = useRef<T | null>(null);
const [revealed, setRevealed] = useState(false);
useEffect(() => {
const node = ref.current;
if (!node) return;
// เบราว์เซอร์เก่ามาก: ไม่มี observer → แสดงทันที ไม่ค้างซ่อน
if (typeof IntersectionObserver === "undefined") {
setRevealed(true);
return;
}
const observer = new IntersectionObserver(
(entries) => {
for (const entry of entries) {
// กันกรณีเลื่อนเร็ว/กลับเข้าหน้าที่ scroll ค้างอยู่: บล็อกที่เลยจอขึ้นไปแล้ว
// ต้องโผล่ทันที (ไม่งั้นจะค้างซ่อนตลอด เพราะไม่มีการตัดผ่านขอบเขตอีก)
const rootTop = entry.rootBounds?.top ?? 0;
const passed = entry.boundingClientRect.bottom <= rootTop;
if (!entry.isIntersecting && !passed) continue;
setRevealed(true);
observer.disconnect();
break;
}
},
{ threshold: REVEAL_THRESHOLD, rootMargin: REVEAL_ROOT_MARGIN },
);
observer.observe(node);
return () => observer.disconnect();
}, []);
const style = {
"--fx-delay": `${Math.max(0, delayMs)}ms`,
} as CSSProperties;
return { ref, revealed, style };
}