۰۱بامِ ایران

دماوند

از دوردست فقط یک هرمِ برفی است که بالای ابرها می‌ایستد؛ بلندترین قلهٔ خاورمیانه.

۰۲دامنهٔ شمالی

هیرکانی

جنگلی که از عصرِ یخبندان مانده؛ مه از میانِ درختانِ کهنسال تا دهکده پایین می‌آید.

۰۳از پَی تا بام

راهِ قله

سه روز راه از دهکده تا قله؛ شب که می‌شود، آتشِ چادرها از دور پیدا است.

اسکرول کن پایین

Scroll Panelsشو تایم

پنل‌های اسکرولی

سه پرده که کنارِ هم یک عکس را کامل می‌کنند؛ با اسکرول کمی باز می‌شن، فلیپ می‌خورن و متنِ پشتِ هر پرده دیده می‌شه.

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

وابستگی‌ها

motion

نوع تعامل

هر چقدر اسکرول کنی جلوتر می‌ری: اول پرده‌های کناری به بیرون باز می‌شن و کلِ سه‌تایی کمی کوچیک می‌شه، بعد پرده‌ها یکی‌یکی فلیپ می‌خورن و متنِ پشت‌شون نمایان می‌شه و آخرش کلِ گروه کمی بالا می‌ره. اسکرولِ برعکس همه‌چیز رو برمی‌گردونه — حرکت کاملاً دستِ خودته.

پراپ‌ها

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

items
ScrollPanelCard[]

حداکثر سه کارت؛ هر کارت `{ title, description, bgColor, textColor, kicker? }` است و پشتِ یک پرده می‌شینه. ندی؟ سه پردهٔ فارسیِ خودِ کامپوننت می‌آد.

imageSrc
stringپیش‌فرض: منظرهٔ کوهستان

عکسِ مشترکِ سه پرده — یه تصویرِ عریض بهترین جلوه رو می‌ده. ندی، پیش‌فرضِ آنلاین می‌مونه.

className
string

روی ظرفِ مسیرِ اسکرول می‌شینه؛ با یه کلاسِ `h-` می‌تونی بلندیِ ۴۰۰vh رو برای جاهای تنگ‌تر عوض کنی.

containerRef
RefObject<HTMLElement | null>

ناحیهٔ اسکرولِ ردیابی — مثلاً یه div با `overflow-y-auto`. ندی، خودِ صفحه دنبال می‌شه.

paneHeight
stringپیش‌فرض: "100vh"

بلندیِ صحنهٔ چسبان. برای کارگذاری داخلِ جعبه یه مقدارِ قطعی بده، نه درصد.

panelHeight
stringپیش‌فرض: "min(420px,56vh)"

بلندیِ ردیفِ پرده‌ها.

نصب

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

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

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

npx shadcn@latest add @farsify/scroll-panels

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

نمونه

scroll-panels.tsxtsx
"use client";

import { useRef } from "react";
import { ScrollPanels } from "@/components/farsify/scroll-panels";

// تمام‌صفحه — با اسکرولِ خودِ صفحه پیش می‌ره
export function StorySection() {
  return <ScrollPanels />;
}

// کارت‌های خودت — هر کارت پشتِ یک پرده
<ScrollPanels
  imageSrc="/my-landscape.jpg"
  items={[
    { title: "طراحی", kicker: "پردهٔ ۱", description: "…", bgColor: "#ead9c4", textColor: "#2a1810" },
    { title: "کد", kicker: "پردهٔ ۲", description: "…", bgColor: "#c4452d", textColor: "#fff4ec" },
    { title: "انتشار", kicker: "پردهٔ ۳", description: "…", bgColor: "#2c3033", textColor: "#e6e2da" },
  ]}
/>

// داخلِ یه باکسِ اسکرول‌خور — ردیابیِ جعبه و بلندی‌های قطعی
const boxRef = useRef<HTMLDivElement>(null);
<div ref={boxRef} className="h-[480px] overflow-y-auto">
  <ScrollPanels
    containerRef={boxRef}
    paneHeight="466px"
    panelHeight="240px"
    className="h-[1600px]"
  />
</div>

نکته‌ها

  • عکس رو عریض و افقی انتخاب کن؛ سه‌تایی برش می‌خوره و سوژهٔ وسطی بهتره وسط بمونه.
  • برای گذاشتن داخلِ یه باکسِ اسکرول‌خور: `containerRef` رو به همون باکس بده و `paneHeight` رو یه مقدارِ قطعی بگذار — بلندیِ مسیر رو هم با `className="h-…"` کوتاه کن.
  • کیکر رو کوتاه نگه دار (یه عبارتِ دوکلمه‌ای)؛ بلندش با `truncate` می‌بره.
  • رنگِ هر پرده با پراپ‌های خودِ کارت عوض می‌شه — رنگ‌ها محتواشن و با تم سایت قاطی نمی‌شن.

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

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

مجوز

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