卡片與網格

Focus Cards

hover 聚焦單卡、其餘卡片模糊淡出的卡片網格效果。

滑鼠移入任一張卡片時,該卡片微幅放大並保持清晰,其餘卡片同步模糊、縮小、淡出,把注意力集中到當下這一張。

把這個效果裝進你的專案

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

npx webberui@latest add focus-cards

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

Playground

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

8
0.96
1.02
0.6
260
編輯中的呼叫預設屬性
<FocusCards/>

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

安裝

npx webberui@latest add https://webberui.com/r/focus-cards.json

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

使用

import { FocusCards } from "@/components/ui/focus-cards";

const cards = [
  {
    title: "Aurora",
    description: "冷色極光漸層背景",
    background: "linear-gradient(135deg, #22d3ee 0%, #6366f1 100%)",
  },
  // ...
];

<FocusCards cards={cards} />;

每張卡片以 CSS background 呈現底圖(漸層或色塊皆可),不依賴外部圖片。省略 background 時會依索引循環套用內建漸層。

Props

Prop型別預設值說明
cardsFocusCard[]—卡片清單,見下方型別
blurnumber8未聚焦卡片的模糊強度(px)
scalenumber0.96未聚焦卡片的縮放比例
focusScalenumber1.02聚焦卡片的放大比例
dimnumber0.6未聚焦卡片的透明度
heightnumber260卡片高度(px)
classNamestring—透傳到外層網格容器

FocusCard 型別

欄位型別說明
titlestring卡片標題
descriptionstring副標題,聚焦時淡入(選填)
backgroundstring任意 CSS background 值當底圖(選填)

可及性

  • 每張卡片可用鍵盤 focus,focus 時觸發與 hover 相同的聚焦效果
  • 使用者系統開啟「減少動態效果」時,卡片維持靜態、不做模糊與縮放
  • 卡片帶 role="group" 與 aria-label,底部暗化漸層純為裝飾(aria-hidden)