کاستومایز
Folderشو تایم
فولدر بازشو
پوشهای سهبعدی که با کلیک لبهاش باز میشه؛ کاغذها بیرون میآن، با هاور سرک میکشن و با کشیدن هرجا رها میشن.
وابستگیها
نوع تعامل
کلیک روی بدنهی پوشه باز/بسته میکنه؛ توی حالتِ باز، هاور روی هر کاغذ بالا میآوردش، کلیک بزرگنمایی میکنه و کشیدن از پوشه بیرونش میبره. کلیک بیرون یا Escape میبنده. کاغذهای بیروناومده دوباره با کشیدن داخلِ پوشه برمیگردن.
پراپها
گزینههایی که میتونی به کامپوننت بدی؛ ستارهدارها اجباریاند.
itemsFolderEntry[]پیشفرض: سه سندِ نمونهآنچه پوشه نگه میدارد، حداکثر ۶ مورد. هر مورد میتواند رشته، `{ title, description }`، `{ image, title, alt }`، `{ content }` یا یک المانِ React باشد.
childrenReactNodeپیشفرض: undefinedاسنادِ دلخواه بهصورتِ فرزند؛ هر فرزند یک کاغذ میشه (بر `items` مقدم است).
mode'flap' | 'book'پیشفرض: 'flap'flap · book`flap` پوشه را ایستاده نگه میدارد و لبهاش را باز میکنه؛ `book` آن را خوابیده میکنه و جلد را مثلِ کتاب ورق میزند.
variant'solid' | 'glass' | 'matte'پیشفرض: 'solid'solid · glass · matteجنسِ پوشه؛ `glass` لبه را شیشهایِ شکستدهنده میکنه و کاغذهای داخل را از پشت نشان میدهد.
layout'spread' | 'stack' | 'row'پیشفرض: 'spread'spread · stack · rowچیدمانِ کاغذها وقتی پوشه باز است: پخشِ آزاد، دستهی عمودی یا ردیفِ منظم.
colorstringپیشفرض: تمآگاه (#8c8c8c / #27272a)رنگِ پوشه؛ سایهها و لایههای روشن/تیره از همان حساب میشوند. نده تا با سطحِ مونوی تم هماهنگ بماند؛ آبیِ `#3b82f6` فقط لهجهی اسلاتِ آبیِ داک است.
نصب
۱. این آدرس رو یکبار توی components.json بذار تا shadcn مخزن فارسیفای رو بشناسه.
{
"registries": {
"@farsify": "https://farsifyui.ir/r/{name}.json"
}
}۲. بعد با دستور زیر کامپوننت رو نصب کن.
npx shadcn@latest add @farsify/folderپیشنیاز: Tailwind CSS v4 و صفحهٔ راستبهچپ dir="rtl".
نمونه
"use client";
import { Folder } from "@/components/farsify/folder";
const documents = [
{ title: "راهنمای برند", description: "رنگها، نشان و لحن" },
{ title: "برنامهٔ عرضه", description: "زمانبندی و مسئولها" },
{ title: "تختهٔ الهام", description: "منابع بصری منتخب" },
];
export function ProjectFolder() {
return (
<Folder
items={documents}
label="پروژهها"
theme="dark"
/>
);
}
// آبی را فقط وقتی بخواهی پوشه از سطحِ خنثی جدا شود بده
<Folder
items={documents}
label="پروژهها"
color="#3b82f6"
theme="dark"
/>
// حالتِ کتابی و شیشهای؛ کاغذها با کشیدن بیرون میآیند
<Folder
items={documents}
label="آرشیو"
mode="book"
variant="glass"
layout="row"
frost={0.6}
/>
// کنترل از بیرون: باز/بسته را خودت مدیریت کن
<Folder
items={documents}
label="پروندهها"
open={open}
onOpenChange={setOpen}
/>نکتهها
- برچسب رو کوتاه و فارسی بده؛ تب با عرضِ متن رشد میکنه و از لبه بیرون نمیزنه.
- نقاشیِ کاغذها جهت رو از CSS میخونه؛ `dir="rtl"` روی صفحه یا والد رو حفظ کن تا خطهای فارسی از راست چیده شن.
- `variant='glass'` روی WebGL2 بهترین نتیجه رو میده؛ بدونِ اون همون شیشهی CSS با `backdrop-filter` میمونه.
- کاغذها رو میشه بیرون کشید و دوباره داخل انداخت؛ `onItemDrop` میگه کدوم حالت رخ داد.
- توی `prefers-reduced-motion` معرفی و فنرها آروم میشن؛ محتوا و دسترسپذیری دستنخورده میمونن.
- برای کارتهای باریک `size` رو کم کن؛ بازشدنِ پخشِ کاغذها عرضِ بیشتری از خودِ پوشه میخواد.
همخانوادهها
کامپوننتهای دیگری از همان دسته که با این یکی جور درمیآیند.
مجوز
کد بعد از نصب مال خودته؛ هر تغییری خواستی بده و توی پروژهی خودت نگهش دار. برای پروژههای شخصی و تجاری آزاده، حتی اگه کدت بسته باشه. فقط اسم و لینک فارسیفای رو یه جا توی پروژه نگه دار.