Tilt Card
Carte qui s'incline en 3D vers le pointeur pour un survol parallaxe. Installez Tilt Card depuis le registre VLLNT UI avec la CLI shadcn.
Carte qui s'incline en 3D vers le pointeur pour un survol parallaxe. Fait partie de la famille utility dans VLLNT UI, il est publie comme entree de registre lisible par machine — copiez la source directement dans votre application avec la CLI shadcn et possedez-la, sans dependance d'execution a une bibliotheque de composants.
Apercu
Basculez entre clair et sombre pour inspecter l'apercu Storybook integre.
Installation
Ajoutez Tilt Card a votre projet avec la CLI shadcn. La source arrive dans votre code, prete a etre adaptee :
pnpm dlx shadcn@latest add https://ui.vllnt.ai/r/tilt-card.jsonSource
"use client";
import * as React from "react";
import { cn } from "../../lib/utils";
/** Props for {@link TiltCard}. */
export type TiltCardProps = React.ComponentPropsWithoutRef<"div"> & {
/** Peak rotation in degrees applied at the card edges. Defaults to `12`. */
maxTilt?: number;
};
function usePrefersReducedMotion(): boolean {
const [reduced, setReduced] = React.useState(false);
React.useEffect(() => {
if (
typeof window === "undefined" ||
typeof window.matchMedia !== "function"
) {
return;
}
const query = window.matchMedia("(prefers-reduced-motion: reduce)");
const onChange = (): void => {
setReduced(query.matches);
};
onChange();
query.addEventListener("change", onChange);
return () => {
query.removeEventListener("change", onChange);
};
}, []);
return reduced;
}
function clamp(value: number, max: number): number {
return Math.min(Math.max(value, -max), max);
}
/**
* Card that tilts in 3D toward the pointer for a parallax hover effect.
*
* Respects `prefers-reduced-motion`: the card stays flat.
*
* @example
* ```tsx
* <TiltCard className="rounded-xl border bg-card p-6">Hover me</TiltCard>
* ```
*/
export const TiltCard = ({
children,
className,
maxTilt = 12,
ref,
style,
...props
}: TiltCardProps & { ref?: React.Ref<HTMLDivElement> }) => {
const reduced = usePrefersReducedMotion();
const [transform, setTransform] = React.useState<string>();
const handlePointerMove = (
event: React.PointerEvent<HTMLDivElement>,
): void => {
if (reduced) {
return;
}
const bounds = event.currentTarget.getBoundingClientRect();
const offsetX = (event.clientX - bounds.left) / bounds.width - 0.5;
const offsetY = (event.clientY - bounds.top) / bounds.height - 0.5;
const rotateY = clamp(offsetX * maxTilt * 2, maxTilt);
const rotateX = clamp(-offsetY * maxTilt * 2, maxTilt);
setTransform(
`perspective(800px) rotateX(${rotateX}deg) rotateY(${rotateY}deg)`,
);
};
return (
<div
className={cn(
"transition-transform duration-200 ease-out will-change-transform",
className,
)}
onPointerLeave={() => {
setTransform(undefined);
}}
onPointerMove={handlePointerMove}
ref={ref}
style={{ transform, ...style }}
{...props}
>
{children}
</div>
);
};
TiltCard.displayName = "TiltCard";
Stories
Explorez chaque variante et etat dans le Storybook interactif :
Apercu
Basculez entre clair et sombre pour inspecter l'apercu Storybook integre.