دماوند
از دوردست فقط یک هرمِ برفی است که بالای ابرها میایستد؛ بلندترین قلهٔ خاورمیانه.
هیرکانی
جنگلی که از عصرِ یخبندان مانده؛ مه از میانِ درختانِ کهنسال تا دهکده پایین میآید.
راهِ قله
سه روز راه از دهکده تا قله؛ شب که میشود، آتشِ چادرها از دور پیدا است.
اسکرول کن پایین
کاستومایز
Scroll Panelsشو تایم
پنلهای اسکرولی
سه پرده که کنارِ هم یک عکس را کامل میکنند؛ با اسکرول کمی باز میشن، فلیپ میخورن و متنِ پشتِ هر پرده دیده میشه.
وابستگیها
نوع تعامل
هر چقدر اسکرول کنی جلوتر میری: اول پردههای کناری به بیرون باز میشن و کلِ سهتایی کمی کوچیک میشه، بعد پردهها یکییکی فلیپ میخورن و متنِ پشتشون نمایان میشه و آخرش کلِ گروه کمی بالا میره. اسکرولِ برعکس همهچیز رو برمیگردونه — حرکت کاملاً دستِ خودته.
پراپها
گزینههایی که میتونی به کامپوننت بدی؛ ستارهدارها اجباریاند.
itemsScrollPanelCard[]حداکثر سه کارت؛ هر کارت `{ title, description, bgColor, textColor, kicker? }` است و پشتِ یک پرده میشینه. ندی؟ سه پردهٔ فارسیِ خودِ کامپوننت میآد.
imageSrcstringپیشفرض: منظرهٔ کوهستانعکسِ مشترکِ سه پرده — یه تصویرِ عریض بهترین جلوه رو میده. ندی، پیشفرضِ آنلاین میمونه.
classNamestringروی ظرفِ مسیرِ اسکرول میشینه؛ با یه کلاسِ `h-` میتونی بلندیِ ۴۰۰vh رو برای جاهای تنگتر عوض کنی.
containerRefRefObject<HTMLElement | null>ناحیهٔ اسکرولِ ردیابی — مثلاً یه div با `overflow-y-auto`. ندی، خودِ صفحه دنبال میشه.
paneHeightstringپیشفرض: "100vh"بلندیِ صحنهٔ چسبان. برای کارگذاری داخلِ جعبه یه مقدارِ قطعی بده، نه درصد.
panelHeightstringپیشفرض: "min(420px,56vh)"بلندیِ ردیفِ پردهها.
نصب
۱. این آدرس رو یکبار توی components.json بذار تا shadcn مخزن فارسیفای رو بشناسه.
{
"registries": {
"@farsify": "https://farsifyui.ir/r/{name}.json"
}
}۲. بعد با دستور زیر کامپوننت رو نصب کن.
npx shadcn@latest add @farsify/scroll-panelsپیشنیاز: Tailwind CSS v4 و صفحهٔ راستبهچپ dir="rtl".
نمونه
"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` میبره.
- رنگِ هر پرده با پراپهای خودِ کارت عوض میشه — رنگها محتواشن و با تم سایت قاطی نمیشن.
همخانوادهها
کامپوننتهای دیگری از همان دسته که با این یکی جور درمیآیند.
مجوز
کد بعد از نصب مال خودته؛ هر تغییری خواستی بده و توی پروژهی خودت نگهش دار. برای پروژههای شخصی و تجاری آزاده، حتی اگه کدت بسته باشه. فقط اسم و لینک فارسیفای رو یه جا توی پروژه نگه دار.