مرورِ خاطره‌ها
چمنزاری سبز در دامنهٔ تپه‌ها
چمنزار

Memoriesشو تایم

خاطرات

دستهٔ کارتِ عکس که روی هم لم داده؛ «شروع» کارتِ رویی رو باز می‌کنه، با فلش یا کشیدن کارت‌به‌کارت مرور می‌کنی و با بستن، دِک سرِ جاش جمع می‌شه.

پیش‌نمایش خاطرات
اختصاصی فارسی‌فایطراحی و توسعه در فارسی‌فای

وابستگی‌ها

motion

نوع تعامل

«شروع» کارتِ وسط رو در جا بزرگ می‌کنه و دو کارتِ پشتی پشتش عقبنشینی می‌کنن. در حالتِ باز کارت با موس کشیدنیه: از یک‌سومِ عرض بیشتر بره یا تند پرتاب بشه ورق می‌خوره، وگرنه با فنر سرِ جاش برمی‌گرده. دکمهٔ «بعدی» روی آخرین کارت تیک می‌شه و پایانِ مروره؛ بستن کارتِ خونده‌شده رو روی دِک می‌شونه و بعد بی‌صدا به کارتِ اول برمی‌گرده. با صفحه‌کلید: فلشِ چپ بعدی، فلشِ راست قبلی و Escape بستن.

پراپ‌ها

گزینه‌هایی که می‌تونی به کامپوننت بدی؛ ستاره‌دارها اجباری‌اند.

cards
MemoriesCard[]

کارت‌های دِک (`label`، `date`، `src` و `alt` برای صفحه‌خوان)؛ پیش‌فرض پنج خاطرهٔ خودِ کامپوننت با عکس‌های محلی. با یک کارت، دِکِ پشتی ندارد.

heading
stringپیش‌فرض: "مرورِ خاطره‌ها"

سرصفحهٔ حالتِ دِک؛ در حالتِ باز جاش رو به تاریخِ کارتِ جاری می‌ده.

startLabel
stringپیش‌فرض: "شروع"

متنِ دکمهٔ توپُرِ شروع.

spread
numberپیش‌فرض: 75

بازِ افقیِ فنِ کارتهای پشتی در حالتِ دِک، بر حسبِ px.

fanAngle
numberپیش‌فرض: 10

زاویهٔ چرخش کارتهای پشتی، بر حسبِ درجه؛ صفر یعنی فنِ تخت.

cardWidth
numberپیش‌فرض: 200

عرضِ کارت روی دِک؛ ارتفاعش ۱٫۲ برابر و حالتِ باز ۱٫۴۸ برابرِ عرض می‌شه — همهچیز از همین عدد مشتق می‌شه.

نصب

۱. این آدرس رو یک‌بار توی components.json بذار تا shadcn مخزن فارسی‌فای رو بشناسه.

components.jsonjson
{
  "registries": {
    "@farsify": "https://farsifyui.ir/r/{name}.json"
  }
}

۲. بعد با دستور زیر کامپوننت رو نصب کن.

npx shadcn@latest add @farsify/memories

پیش‌نیاز: Tailwind CSS v4 و صفحهٔ راست‌به‌چپ dir="rtl".

نمونه

memories.tsxtsx
"use client";

import { Memories } from "@/components/farsify/memories";

export function MemoryCorner() {
  return <Memories />;
}

// کارت‌های خودت — هر عکس و هر برچسب و تاریخی
<Memories
  cards={[
    { label: "سفرِ شمال", date: "۳ مرداد ۱۴۰۳", src: "/photos/north.jpg" },
    { label: "عروسیِ سارا", date: "۱۲ شهریور ۱۴۰۳", src: "/photos/wedding.jpg" },
  ]}
/>

// هندسهٔ دِک — فنِ بازتر با کارتهای بزرگتر
<Memories spread={110} fanAngle={16} cardWidth={220} />

// بی‌فن — دِکِ تخت و مرتب
<Memories spread={90} fanAngle={0} />

نکته‌ها

  • جهت‌ها فیزیکی و راست‌به‌چپ‌پسندن: «بعدی» همیشه به سمتِ چپه — هم با کشیدنِ کارت هم با فلشِ صفحه‌کلید؛ فلش‌های دکمه‌ها هم همین جهت رو نشون می‌دن.
  • بستن، کارتِ خونده‌شده رو همون‌جا روی دِک می‌شونه و بعد از نشستن، بی‌صدا به کارتِ اول برمی‌گرده — یعنی هر بار که باز می‌کنی دِک از اولشه.
  • دکمهٔ «بعدی» تا صفحهای مونده معمولیه و فقط روی آخرین کارت توپُر می‌شه و تیک می‌گیره: سیاه یعنی پایانِ مرور، نه جهتِ جلو.
  • پرتابِ کارت آستانه داره: بیشتر از یک‌سومِ قاب یا سرعتِ ۵۰۰px/s ورق می‌زنه؛ نیمهکاره با فنر برمی‌گرده.
  • رنگهای قاب و دکمه‌ها متغیرهای `--mm-*` در `memories.css`ان و به توکنهای سایت وصله — تم روشن/تیره خودکار عوض می‌شه؛ گرادیانِ عکسها عمداً ثابته.
  • فقط `motion` لازمه؛ عکس‌ها مسیرِ محلی دارن و `img` ساده‌ست تا به next/image و تنظیمِ دامنه گره نخوره.

هم‌خانواده‌ها

کامپوننت‌های دیگری از همان دسته که با این یکی جور درمی‌آیند.

مجوز

کد بعد از نصب مال خودته؛ هر تغییری خواستی بده و توی پروژه‌ی خودت نگهش دار. برای پروژه‌های شخصی و تجاری آزاده، حتی اگه کدت بسته باشه. فقط اسم و لینک فارسی‌فای رو یه جا توی پروژه نگه دار.