WebberUI

Sparkles Bg

可配置密度/顏色的閃爍星點背景。

以 2D canvas 繪製、每顆星點獨立正弦閃爍的星空背景,密度與顏色皆可調,並會依容器面積自動換算星點數量。

載入預覽⋯

Playground

即時調整 props、程式碼片段同步更新——直接試出你要的樣子再複製。

1
1
1.6
<SparklesBg />

安裝

npx shadcn@latest add https://webberui.com/r/sparkles-bg.json

或在 components.json 設定 registries 後,改用 @webberui/sparkles-bg 安裝。

安裝依賴後,從 registry JSON(/r/sparkles-bg.jsonfiles[0].content)複製 sparkles-bg.tsx 原始碼到你的 components/ui/ 目錄:

npm install motion clsx tailwind-merge

使用

import { SparklesBg } from "@/components/ui/sparkles-bg";

<SparklesBg density={1.4} color="#ffffff" background="#050506" className="h-[320px] w-full rounded-xl">
  <div className="flex h-full items-center justify-center text-white">
    Sparkles
  </div>
</SparklesBg>

Props

Prop型別預設值說明
densitynumber1星點密度倍率,依容器面積換算總數
colorstring"#ffffff"星點顏色,接受任何 CSS 色值
minSizenumber0.6星點最小半徑(px)
maxSizenumber1.6星點最大半徑(px)
speednumber1閃爍速度倍率,1 為預設節奏
backgroundstring"transparent"背景色,設 transparent 可疊在既有底色上
childrenReactNode疊在星點之上的前景內容

可及性

  • 使用者系統開啟「減少動態效果」時,星點以靜態方式一次繪製,不再閃爍
  • canvas 帶 aria-hiddenpointer-events-none,純裝飾不干擾互動與朗讀

On this page