Sparkles
Etincelles scintillantes decoratives dispersees derriere le contenu. Installez Sparkles depuis le registre VLLNT UI avec la CLI shadcn.
Etincelles scintillantes decoratives dispersees derriere le contenu. 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 Sparkles 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/sparkles.jsonSource
"use client";
import * as React from "react";
import { cn } from "../../lib/utils";
/** Props for {@link Sparkles}. */
export type SparklesProps = React.ComponentPropsWithoutRef<"div"> & {
/** Count of twinkling sparkle squares to scatter. Defaults to `20`. */
count?: number;
};
type Sparkle = {
delay: number;
duration: number;
left: number;
size: number;
top: number;
};
function createSparkles(count: number): Sparkle[] {
return Array.from({ length: count }, () => ({
delay: Math.random() * 2,
duration: 1 + Math.random() * 1.5,
left: Math.random() * 100,
size: 4 + Math.random() * 8,
top: Math.random() * 100,
}));
}
/**
* Decorative field of twinkling sparkles layered behind optional content.
*
* Respects `prefers-reduced-motion`: the sparkles hold still.
*
* @example
* ```tsx
* <Sparkles count={30}>
* <h1>Magic</h1>
* </Sparkles>
* ```
*/
export const Sparkles = ({
children,
className,
count = 20,
ref,
...props
}: SparklesProps & { ref?: React.Ref<HTMLDivElement> }) => {
const [sparkles] = React.useState(() => createSparkles(count));
return (
<div className={cn("relative", className)} ref={ref} {...props}>
<div
aria-hidden="true"
className="pointer-events-none absolute inset-0 overflow-hidden"
>
{sparkles.map((sparkle, index) => (
<span
className="absolute rotate-45 rounded-[1px] bg-foreground motion-reduce:animate-none"
key={index}
style={{
animation: `vllnt-sparkle ${sparkle.duration}s linear infinite`,
animationDelay: `${sparkle.delay}s`,
height: `${sparkle.size}px`,
left: `${sparkle.left}%`,
top: `${sparkle.top}%`,
width: `${sparkle.size}px`,
}}
/>
))}
</div>
{children ? <div className="relative">{children}</div> : null}
</div>
);
};
Sparkles.displayName = "Sparkles";
Stories
Explorez chaque variante et etat dans le Storybook interactif :
Apercu
Basculez entre clair et sombre pour inspecter l'apercu Storybook integre.