"use client"; import { useEffect } from "react"; import { usePathname } from "next/navigation"; export interface RevealOptions { /** Attente par défaut, en secondes, avant de révéler une région. */ delay?: number; /** * Bande du viewport qui rend une région « active ». Par défaut le tiers * central : une région est active quand elle occupe le milieu de l'écran. */ rootMargin?: string; } const DEFAULT_DELAY = 0.25; const DEFAULT_ROOT_MARGIN = "-35% 0px -35% 0px"; /** * Anime l'entrée d'une région après que le visiteur s'y est arrêté. * * Chaque `[data-region]` est observé dans une bande centrale du viewport. Le * délai court (0,25 s par défaut, `data-region-delay` pour le surcharger) ne * démarre que lorsque la région occupe cette bande ; s'il repart avant la fin, * le minuteur est annulé et la région se révélera à son prochain passage. Les * éléments `[data-reveal]` de la région apparaissent alors en cascade via * `data-reveal-delay`. * * Le contenu reste visible sans JavaScript et avec `prefers-reduced-motion`. */ export const useScrollReveal = ({ delay = DEFAULT_DELAY, rootMargin = DEFAULT_ROOT_MARGIN, }: RevealOptions = {}): void => { const pathname = usePathname(); useEffect(() => { if (typeof window === "undefined") return; if (window.matchMedia("(prefers-reduced-motion: reduce)").matches) return; const regions = Array.from( document.querySelectorAll("[data-region]"), ); if (regions.length === 0) return; const timers = new Map(); // Un snap obligatoire sur une région plus haute que l'écran rendrait la fin // de son contenu inatteignable : dans ce cas on rend la main au défilement // libre (cf. `html[data-snap="off"]` dans `globals.css`). const root = document.documentElement; const syncSnap = () => { const tooTall = regions.some( (region) => region.getBoundingClientRect().height > window.innerHeight + 1, ); if (tooTall) root.dataset.snap = "off"; else delete root.dataset.snap; }; syncSnap(); const resizeObserver = new ResizeObserver(syncSnap); for (const region of regions) resizeObserver.observe(region); window.addEventListener("resize", syncSnap); const reveal = (region: HTMLElement) => { region.dataset.revealed = "true"; region.querySelectorAll("[data-reveal]").forEach((item) => { const itemDelay = Number.parseFloat(item.dataset.revealDelay ?? ""); if (Number.isFinite(itemDelay) && itemDelay > 0) { item.style.setProperty("--reveal-delay", `${itemDelay}s`); } item.classList.add("is-revealed"); }); }; // Masquage posé au montage : le HTML prérendu reste lisible sans JS. for (const region of regions) { if (region.dataset.revealed === "true") continue; region .querySelectorAll("[data-reveal]") .forEach((item) => item.classList.add("reveal-init")); } const waitFor = (region: HTMLElement): number => { const raw = region.dataset.regionDelay; if (raw === undefined) return delay; const value = Number.parseFloat(raw); return Number.isFinite(value) && value >= 0 ? value : delay; }; const observer = new IntersectionObserver( (entries) => { for (const entry of entries) { const region = entry.target as HTMLElement; if (entry.isIntersecting) { /* Pendant un saut de menu, la région ne fait que traverser l'écran : le délai serait annulé avant la fin. On la révèle tout de suite pour que la séquence ne montre pas de zones vides. */ if (document.documentElement.dataset.scrollAnim !== undefined) { reveal(region); continue; } if (region.dataset.revealed === "true" || timers.has(region)) { continue; } timers.set( region, window.setTimeout(() => { timers.delete(region); reveal(region); }, waitFor(region) * 1000), ); continue; } // Sortie de la bande avant la fin du délai : le visiteur a continué // sa route, inutile de révéler une région qu'il ne regarde plus. const timer = timers.get(region); if (timer !== undefined) { window.clearTimeout(timer); timers.delete(region); } } }, { threshold: 0, rootMargin }, ); for (const region of regions) observer.observe(region); return () => { observer.disconnect(); resizeObserver.disconnect(); window.removeEventListener("resize", syncSnap); for (const timer of timers.values()) window.clearTimeout(timer); timers.clear(); }; }, [pathname, delay, rootMargin]); };