Card Flip
Carte qui se retourne en 3D entre une face avant et une face arriere. Installez Card Flip depuis le registre VLLNT UI avec la CLI shadcn.
Carte qui se retourne en 3D entre une face avant et une face arriere. 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 Card Flip 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/card-flip.jsonSource
"use client";
import * as React from "react";
import { cn } from "../../lib/utils";
/** Props for {@link CardFlip}. */
export type CardFlipProps = React.ComponentPropsWithoutRef<"div"> & {
/** Content shown on the back face. */
back: React.ReactNode;
/** Whether hovering flips the card. Click toggles when disabled. Defaults to `true`. */
flipOnHover?: boolean;
/** Content shown on the front face. */
front: React.ReactNode;
};
function Inner({
back,
flipOnHover,
flipped,
front,
}: {
back: React.ReactNode;
flipOnHover: boolean;
flipped: boolean;
front: React.ReactNode;
}) {
return (
<div
className={cn(
"relative h-full min-h-40 transition-transform duration-500 [transform-style:preserve-3d] motion-reduce:transition-none",
flipOnHover && "group-hover:[transform:rotateY(180deg)]",
!flipOnHover && flipped && "[transform:rotateY(180deg)]",
)}
>
<div className="absolute inset-0 [backface-visibility:hidden]">
{front}
</div>
<div className="absolute inset-0 [backface-visibility:hidden] [transform:rotateY(180deg)]">
{back}
</div>
</div>
);
}
/**
* Card that flips in 3D between a front and a back face on hover or click.
*
* Respects `prefers-reduced-motion`: the flip happens without a transition.
*
* @example
* ```tsx
* <CardFlip front={<p>Front</p>} back={<p>Back</p>} />
* ```
*/
export const CardFlip = ({
back,
className,
flipOnHover = true,
front,
ref,
...props
}: CardFlipProps & { ref?: React.Ref<HTMLDivElement> }) => {
const [flipped, setFlipped] = React.useState(false);
const base = cn(
"relative min-h-40 [perspective:1000px]",
flipOnHover && "group",
className,
);
if (flipOnHover) {
return (
<div className={base} ref={ref} {...props}>
<Inner back={back} flipOnHover={true} flipped={flipped} front={front} />
</div>
);
}
return (
<div
className={base}
onClick={() => {
setFlipped((current) => !current);
}}
onKeyDown={(event) => {
if (event.key === "Enter" || event.key === " ") {
event.preventDefault();
setFlipped((current) => !current);
}
}}
ref={ref}
role="button"
tabIndex={0}
{...props}
>
<Inner back={back} flipOnHover={false} flipped={flipped} front={front} />
</div>
);
};
CardFlip.displayName = "CardFlip";
Stories
Explorez chaque variante et etat dans le Storybook interactif :
Apercu
Basculez entre clair et sombre pour inspecter l'apercu Storybook integre.