

چمنزارکاستومایز
Memoriesشو تایم
خاطرات
دستهٔ کارتِ عکس که روی هم لم داده؛ «شروع» کارتِ رویی رو باز میکنه، با فلش یا کشیدن کارتبهکارت مرور میکنی و با بستن، دِک سرِ جاش جمع میشه.
وابستگیها
نوع تعامل
«شروع» کارتِ وسط رو در جا بزرگ میکنه و دو کارتِ پشتی پشتش عقبنشینی میکنن. در حالتِ باز کارت با موس کشیدنیه: از یکسومِ عرض بیشتر بره یا تند پرتاب بشه ورق میخوره، وگرنه با فنر سرِ جاش برمیگرده. دکمهٔ «بعدی» روی آخرین کارت تیک میشه و پایانِ مروره؛ بستن کارتِ خوندهشده رو روی دِک میشونه و بعد بیصدا به کارتِ اول برمیگرده. با صفحهکلید: فلشِ چپ بعدی، فلشِ راست قبلی و Escape بستن.
پراپها
گزینههایی که میتونی به کامپوننت بدی؛ ستارهدارها اجباریاند.
cardsMemoriesCard[]کارتهای دِک (`label`، `date`، `src` و `alt` برای صفحهخوان)؛ پیشفرض پنج خاطرهٔ خودِ کامپوننت با عکسهای محلی. با یک کارت، دِکِ پشتی ندارد.
headingstringپیشفرض: "مرورِ خاطرهها"سرصفحهٔ حالتِ دِک؛ در حالتِ باز جاش رو به تاریخِ کارتِ جاری میده.
startLabelstringپیشفرض: "شروع"متنِ دکمهٔ توپُرِ شروع.
spreadnumberپیشفرض: 75بازِ افقیِ فنِ کارتهای پشتی در حالتِ دِک، بر حسبِ px.
fanAnglenumberپیشفرض: 10زاویهٔ چرخش کارتهای پشتی، بر حسبِ درجه؛ صفر یعنی فنِ تخت.
cardWidthnumberپیشفرض: 200عرضِ کارت روی دِک؛ ارتفاعش ۱٫۲ برابر و حالتِ باز ۱٫۴۸ برابرِ عرض میشه — همهچیز از همین عدد مشتق میشه.
نصب
۱. این آدرس رو یکبار توی components.json بذار تا shadcn مخزن فارسیفای رو بشناسه.
{
"registries": {
"@farsify": "https://farsifyui.ir/r/{name}.json"
}
}۲. بعد با دستور زیر کامپوننت رو نصب کن.
npx shadcn@latest add @farsify/memoriesپیشنیاز: Tailwind CSS v4 و صفحهٔ راستبهچپ dir="rtl".
نمونه
"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 و تنظیمِ دامنه گره نخوره.
همخانوادهها
کامپوننتهای دیگری از همان دسته که با این یکی جور درمیآیند.
مجوز
کد بعد از نصب مال خودته؛ هر تغییری خواستی بده و توی پروژهی خودت نگهش دار. برای پروژههای شخصی و تجاری آزاده، حتی اگه کدت بسته باشه. فقط اسم و لینک فارسیفای رو یه جا توی پروژه نگه دار.