卡片與網格

3d Pin

hover 展開的漸層 3D 產品圖釘,卡片後傾露出漂浮膠囊標籤與雷達漣漪光束。

滑鼠移入時卡片沿 X 軸後傾,上方浮出可點擊的膠囊標籤,地面射出漸層光束與同心漣漪,做出立體圖釘的空間感。

把這個效果裝進你的專案

在專案資料夾執行指令,CLI 會加入原始碼與依賴套件,再依下方使用範例引用元件。

npx webberui@latest add 3d-pin

還沒有專案,或安裝遇到問題?看快速開始 →

Playground

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

40
編輯中的呼叫預設屬性
<ThreeDPin/>

完整範例包含預覽的排版與資料。先安裝元件,再把範例檔貼入你的專案。

安裝

npx webberui@latest add https://webberui.com/r/3d-pin.json

或在 components.json 設定 registries 後,改用 @webberui/3d-pin 安裝。

使用

import { ThreeDPin } from "@/components/ui/3d-pin";

<ThreeDPin title="webberui.com" href="https://webberui.com">
  <div className="h-[16rem] w-[16rem]">卡片內容</div>
</ThreeDPin>

放進一個置中的有界容器(例如 flex items-center justify-center),卡片會以其中心浮出圖釘與光束。

Props

Prop型別預設值說明
titlestring"webberui.com"浮出膠囊標籤上的文字
hrefstring—標籤連結;有值時整張卡片可點擊
gradientstring"from-cyan-400 via-sky-500 to-emerald-400"標籤底線與光束的漸層 class
tiltnumber40hover 時卡片後傾的角度(deg)
childrenReactNode—卡片內容
containerClassNamestring—套在最外層互動容器上
classNamestring—套在卡片內容框上

可及性

  • 使用者系統開啟「減少動態效果」時,卡片不再後傾,同心漣漪維持靜態不做無限動畫
  • 標籤在 href 存在時渲染為連結,並帶 rel="noreferrer noopener" 於新分頁開啟