🚀 Ship faster with premium components 🚀
Search documentation v1.4.0

Sparkle

Highlight key messages with a subtle effect

Command docs
How to add this block to your project
npm run add Sparkle

Use the Sparkle component to add an animated sparkle effect to your text. The visual accent helps emphasize key messages. Use it to:

Preview
Text with sparkle
Unlock code
How to use the Sparkle component in Astro
<Sparkle text="Text with sparkle" />

To ues the Sparkle component, simply pass a text prop. By default, the component will calculate the amount of sparkles based on the length of the text. The longer the text, the more sparkles will be added.

Sparkle Amount

To override the automatically calculated amount of sparkles, you can set the amount prop:

Amount set to 1
Amount set to 10
Unlock code
How to customize the amount of sparkles
<Sparkle
text="Text with sparkle"
amount={10}
/>

Size and Color

The size and color of the sparkles can also be configured using the size and color props:

Single color
Multiple colors
Custom size
Unlock code
How to change colors
<Sparkle
text="Single color"
color={['var(--w-color-info)']}
/>
Unlock code
Using multiple colors
<Sparkle
text="Multiple colors"
color={[
'var(--w-color-info)', // Pass any valid CSS color
'var(--w-color-success)',
'var(--w-color-warning)',
'var(--w-color-alert)'
]}
/>
Unlock code
Setting custom size
<Sparkle
text="Custom size"
size={25}
/>

Animation Speed

The animation speed of the component can also be controlled. By default, the animation speed is set to 1 second. You can override this by setting the animationSpeed prop:

Animation speed set to 0.5s
Animation speed set to 2s
Unlock code
How to customize animation speed
<Sparkle
text="Text with sparkle"
animationSpeed={2}
/>

API

Unlock code
Component API reference
type SparkleProps = {
text: string
amount?: number
color?: string | string[]
animationSpeed?: number
size?: number
className?: string
}
PropDefaultPurpose
text - Sets the text for the sparkle.
amount - Sets the amount of sparkles. Calculated automatically if not set.
color - Sets the color of the sparkles.
animationSpeed 1 Sets the speed of the animation in seconds.
size 16 Sets the size of the sparkles.
className - Pass additional CSS classes for the component.