Files
Esiah-s-Universe/src/components/cursors/TargetCursor.tsx
T
Esiah 8727eac300 Refactor scroll system, regions, layout and download flow
- Completely reworked `useRegionScroll` controller: paginated region-by-region scroll (wheel/swipe/arrows/Home/End/Space), native scroll neutralized, regions taller than viewport split into screens, time-based rAF animation, interruption only on effective deviation.
- Region resolution in 3 levels: `data-region` (single element), `data-region-children` (each direct child), `.page-snap-section` as fallback. Added `data-no-region` to exclude hero/title.
- Homepage: entire MagicBento as a single region. Projects page: one stop per project (`HorizontalMotion` with `data-region-children`), category title preserved, hero excluded.
- Project detail pages (ProjectPage): hero excluded from regions, media in `data-region-children`, download button as separate region.
- Contact/PageShell: updated markers, removed empty zones (no forced `min-height` on `.page-snap-section`).
- Removed unbounded `--region-tail` in favor of capped reserve (15vh) + merged landing spots too close to each other.
- Navigation: more reliable scroll-to-top, footer "Co Hai Se" bold with target cursor.
- ZIP download: stopped propagation + global click handler ignores download.
- Various fixes (cursor, 404, layouts), docs updated, typecheck/ignoreDeprecations adjusted.
2026-10-22 15:20:20 +02:00

377 lines
13 KiB
TypeScript

import React, { useEffect, useRef, useCallback, useMemo } from "react";
import { gsap } from "gsap";
export interface TargetCursorProps {
targetSelector?: string;
spinDuration?: number;
hideDefaultCursor?: boolean;
hoverDuration?: number;
parallaxOn?: boolean;
}
const TargetCursor: React.FC<TargetCursorProps> = ({
targetSelector = ".cursor-target",
spinDuration = 2,
hideDefaultCursor = true,
hoverDuration = 0.2,
parallaxOn = true,
}) => {
const cursorRef = useRef<HTMLDivElement>(null);
const cornersRef = useRef<NodeListOf<HTMLDivElement> | null>(null);
const spinTl = useRef<gsap.core.Timeline | null>(null);
const dotRef = useRef<HTMLDivElement>(null);
const isActiveRef = useRef(false);
const targetCornerPositionsRef = useRef<{ x: number; y: number }[] | null>(
null,
);
const tickerFnRef = useRef<(() => void) | null>(null);
const activeStrengthRef = useRef({ current: 0 });
const isMobile = useMemo(() => {
const hasTouchScreen =
"ontouchstart" in window || navigator.maxTouchPoints > 0;
const isSmallScreen = window.innerWidth <= 768;
const userAgent =
navigator.userAgent || navigator.vendor || (window as any).opera;
const mobileRegex =
/android|webos|iphone|ipad|ipod|blackberry|iemobile|opera mini/i;
const isMobileUserAgent = mobileRegex.test(userAgent.toLowerCase());
return (hasTouchScreen && isSmallScreen) || isMobileUserAgent;
}, []);
const constants = useMemo(() => ({ borderWidth: 3, cornerSize: 16 }), []);
const moveCursor = useCallback((x: number, y: number) => {
if (!cursorRef.current) return;
gsap.to(cursorRef.current, { x, y, duration: 0.1, ease: "power3.out" });
}, []);
useEffect(() => {
if (isMobile || !cursorRef.current) return;
const originalCursor = document.body.style.cursor;
if (hideDefaultCursor) {
document.body.style.cursor = "none";
}
const cursor = cursorRef.current;
cornersRef.current = cursor.querySelectorAll<HTMLDivElement>(
".target-cursor-corner",
);
let activeTarget: Element | null = null;
let currentLeaveHandler: (() => void) | null = null;
let resumeTimeout: ReturnType<typeof setTimeout> | null = null;
const cleanupTarget = (target: Element) => {
if (currentLeaveHandler) {
target.removeEventListener("mouseleave", currentLeaveHandler);
}
currentLeaveHandler = null;
};
gsap.set(cursor, {
xPercent: -50,
yPercent: -50,
x: window.innerWidth / 2,
y: window.innerHeight / 2,
});
const createSpinTimeline = () => {
if (spinTl.current) {
spinTl.current.kill();
}
spinTl.current = gsap.timeline({ repeat: -1 }).to(cursor, {
rotation: "+=360",
duration: spinDuration,
ease: "none",
});
};
createSpinTimeline();
const tickerFn = () => {
if (
!targetCornerPositionsRef.current ||
!cursorRef.current ||
!cornersRef.current
) {
return;
}
const strength = activeStrengthRef.current.current;
if (strength === 0) return;
const cursorX = gsap.getProperty(cursorRef.current, "x") as number;
const cursorY = gsap.getProperty(cursorRef.current, "y") as number;
const corners = Array.from(cornersRef.current);
corners.forEach((corner, i) => {
const currentX = gsap.getProperty(corner, "x") as number;
const currentY = gsap.getProperty(corner, "y") as number;
const targetX = targetCornerPositionsRef.current![i].x - cursorX;
const targetY = targetCornerPositionsRef.current![i].y - cursorY;
const finalX = currentX + (targetX - currentX) * strength;
const finalY = currentY + (targetY - currentY) * strength;
const duration = strength >= 0.99 ? (parallaxOn ? 0.2 : 0) : 0.05;
gsap.to(corner, {
x: finalX,
y: finalY,
duration: duration,
ease: duration === 0 ? "none" : "power1.out",
overwrite: "auto",
});
});
};
tickerFnRef.current = tickerFn;
const moveHandler = (e: MouseEvent) => moveCursor(e.clientX, e.clientY);
window.addEventListener("mousemove", moveHandler);
const scrollHandler = () => {
if (!activeTarget || !cursorRef.current) return;
const mouseX = gsap.getProperty(cursorRef.current, "x") as number;
const mouseY = gsap.getProperty(cursorRef.current, "y") as number;
const elementUnderMouse = document.elementFromPoint(mouseX, mouseY);
const isStillOverTarget =
elementUnderMouse &&
(elementUnderMouse === activeTarget ||
elementUnderMouse.closest(targetSelector) === activeTarget);
if (!isStillOverTarget) {
currentLeaveHandler?.();
}
};
window.addEventListener("scroll", scrollHandler, { passive: true });
const mouseDownHandler = () => {
if (!dotRef.current) return;
gsap.to(dotRef.current, { scale: 0.7, duration: 0.3 });
gsap.to(cursorRef.current, { scale: 0.9, duration: 0.2 });
};
const mouseUpHandler = () => {
if (!dotRef.current) return;
gsap.to(dotRef.current, { scale: 1, duration: 0.3 });
gsap.to(cursorRef.current, { scale: 1, duration: 0.2 });
};
window.addEventListener("mousedown", mouseDownHandler);
window.addEventListener("mouseup", mouseUpHandler);
const enterHandler = (e: MouseEvent) => {
const directTarget = e.target as Element;
const allTargets: Element[] = [];
let current: Element | null = directTarget;
while (current && current !== document.body) {
if (current.matches(targetSelector)) {
allTargets.push(current);
}
current = current.parentElement;
}
const target = allTargets[0] || null;
if (!target || !cursorRef.current || !cornersRef.current) return;
if (activeTarget === target) return;
if (activeTarget) {
cleanupTarget(activeTarget);
}
if (resumeTimeout) {
clearTimeout(resumeTimeout);
resumeTimeout = null;
}
activeTarget = target;
const corners = Array.from(cornersRef.current);
corners.forEach((corner) => gsap.killTweensOf(corner));
gsap.killTweensOf(cursorRef.current, "rotation");
spinTl.current?.pause();
gsap.set(cursorRef.current, { rotation: 0 });
const rect = target.getBoundingClientRect();
const { borderWidth, cornerSize } = constants;
const cursorX = gsap.getProperty(cursorRef.current, "x") as number;
const cursorY = gsap.getProperty(cursorRef.current, "y") as number;
let r = rect;
if (target.classList && target.classList.contains("infinite-menu-canvas")) {
// Cadre agrandi : les angles restent hors du texte superposé au menu
const size = Math.min(rect.width, rect.height) * 0.7;
r = {
left: rect.left + (rect.width - size) / 2,
top: rect.top + (rect.height - size) / 2,
right: rect.left + (rect.width - size) / 2 + size,
bottom: rect.top + (rect.height - size) / 2 + size,
} as DOMRect;
}
targetCornerPositionsRef.current = [
{ x: r.left - borderWidth, y: r.top - borderWidth },
{ x: r.right + borderWidth - cornerSize, y: r.top - borderWidth },
{
x: r.right + borderWidth - cornerSize,
y: r.bottom + borderWidth - cornerSize,
},
{
x: r.left - borderWidth,
y: r.bottom + borderWidth - cornerSize,
},
];
isActiveRef.current = true;
gsap.ticker.add(tickerFnRef.current!);
gsap.to(activeStrengthRef.current, {
current: 1,
duration: hoverDuration,
ease: "power2.out",
});
corners.forEach((corner, i) => {
gsap.to(corner, {
x: targetCornerPositionsRef.current![i].x - cursorX,
y: targetCornerPositionsRef.current![i].y - cursorY,
duration: 0.2,
ease: "power2.out",
});
});
const leaveHandler = () => {
gsap.ticker.remove(tickerFnRef.current!);
isActiveRef.current = false;
targetCornerPositionsRef.current = null;
gsap.set(activeStrengthRef.current, { current: 0, overwrite: true });
activeTarget = null;
if (cornersRef.current) {
const corners = Array.from(cornersRef.current);
gsap.killTweensOf(corners);
const { cornerSize } = constants;
const positions = [
{ x: -cornerSize * 1.5, y: -cornerSize * 1.5 },
{ x: cornerSize * 0.5, y: -cornerSize * 1.5 },
{ x: cornerSize * 0.5, y: cornerSize * 0.5 },
{ x: -cornerSize * 1.5, y: cornerSize * 0.5 },
];
const tl = gsap.timeline();
corners.forEach((corner, index) => {
tl.to(
corner,
{
x: positions[index].x,
y: positions[index].y,
duration: 0.3,
ease: "power3.out",
},
0,
);
});
}
resumeTimeout = setTimeout(() => {
if (!activeTarget && cursorRef.current && spinTl.current) {
const currentRotation = gsap.getProperty(
cursorRef.current,
"rotation",
) as number;
const normalizedRotation = currentRotation % 360;
spinTl.current.kill();
spinTl.current = gsap
.timeline({ repeat: -1 })
.to(cursorRef.current, {
rotation: "+=360",
duration: spinDuration,
ease: "none",
});
gsap.to(cursorRef.current, {
rotation: normalizedRotation + 360,
duration: spinDuration * (1 - normalizedRotation / 360),
ease: "none",
onComplete: () => {
spinTl.current?.restart();
},
});
}
resumeTimeout = null;
}, 50);
cleanupTarget(target);
};
currentLeaveHandler = leaveHandler;
target.addEventListener("mouseleave", leaveHandler);
};
window.addEventListener("mouseover", enterHandler as EventListener);
return () => {
if (tickerFnRef.current) {
gsap.ticker.remove(tickerFnRef.current);
}
window.removeEventListener("mousemove", moveHandler);
window.removeEventListener("mouseover", enterHandler as EventListener);
window.removeEventListener("scroll", scrollHandler);
window.removeEventListener("mousedown", mouseDownHandler);
window.removeEventListener("mouseup", mouseUpHandler);
if (activeTarget) {
cleanupTarget(activeTarget);
}
spinTl.current?.kill();
document.body.style.cursor = originalCursor;
isActiveRef.current = false;
targetCornerPositionsRef.current = null;
activeStrengthRef.current.current = 0;
};
}, [
targetSelector,
spinDuration,
moveCursor,
constants,
hideDefaultCursor,
isMobile,
hoverDuration,
parallaxOn,
]);
useEffect(() => {
if (isMobile || !cursorRef.current || !spinTl.current) return;
if (spinTl.current.isActive()) {
spinTl.current.kill();
spinTl.current = gsap.timeline({ repeat: -1 }).to(cursorRef.current, {
rotation: "+=360",
duration: spinDuration,
ease: "none",
});
}
}, [spinDuration, isMobile]);
if (isMobile) {
return null;
}
return (
<div
ref={cursorRef}
className="fixed top-0 left-0 w-0 h-0 pointer-events-none z-9999"
style={{ willChange: "transform" }}
>
<div
ref={dotRef}
className="absolute top-1/2 left-1/2 w-1 h-1 bg-white rounded-full -translate-x-1/2 -translate-y-1/2"
style={{ willChange: "transform" }}
/>
<div
className="target-cursor-corner absolute top-1/2 left-1/2 w-3 h-3 border-[3px] border-white -translate-x-[150%] -translate-y-[150%] border-r-0 border-b-0"
style={{ willChange: "transform" }}
/>
<div
className="target-cursor-corner absolute top-1/2 left-1/2 w-3 h-3 border-[3px] border-white translate-x-1/2 -translate-y-[150%] border-l-0 border-b-0"
style={{ willChange: "transform" }}
/>
<div
className="target-cursor-corner absolute top-1/2 left-1/2 w-3 h-3 border-[3px] border-white translate-x-1/2 translate-y-1/2 border-l-0 border-t-0"
style={{ willChange: "transform" }}
/>
<div
className="target-cursor-corner absolute top-1/2 left-1/2 w-3 h-3 border-[3px] border-white -translate-x-[150%] translate-y-1/2 border-r-0 border-t-0"
style={{ willChange: "transform" }}
/>
</div>
);
};
export default TargetCursor;