کاستومایز
Bookshelfشو تایم
قفسه کتاب
قفسهای از عطفِ کتابها؛ کلیک کن تا کتاب پرواز کنه روی میز، جلدش با فیزیکِ واقعی باز شه و صفحهها با هندسهٔ واقعیِ کاغذ ورق بخورن. با Esc یا کلیک بیرون، سرِ قفسه برمیگرده.
وابستگیها
نوع تعامل
روی عطفی که میخوای برو؛ بالا میاد. کلیکش کنی از قفسه پایین میاد روی میز و جلدش با تابِ سنگینی روی لولا باز میشه (بکشی هم میتونی خودت بلندش کنی و رها کنی). صفحهها رو از نیمهٔ بیرونیشون بکش یا کلیک کن؛ پرتتابِ تند ورق میزنه، نیمهکاره با فنر برمیگرده. فلشها ورق میزنن (راست = بعدی، همسو با جهتِ ورقخوردنِ کتابِ فارسی) و Escape میبنده. با کلیک بیرون از کتاب یا Escape بسته میشه و پرواز میکنه سرِ جاش در قفسه؛ روی نمایشگرِ پهن، رسیدن به آخرین صفحه هم خودش میبنددش. صفحههای باریک تکصفحهن.
پراپها
گزینههایی که میتونی به کامپوننت بدی؛ ستارهدارها اجباریاند.
booksShelfBook[]کتابهای قفسه (`title`، `author`، `cloth`، `foil`، `blurb`، `content` و اختیاری: `height`/`width`/`label`)؛ پیشفرض پنج کتابِ خودِ کامپوننت با متنهای فارسی.
seriesstringپیشفرض: "اتاقِ مطالعه"نامِ سری؛ سرصفحهٔ صفحاتِ راست و پایِ هر جلدِ پشت.
countnumberچند کتابِ اولِ قفسه نشون داده شه؛ بدونِ اون همه، و `0` هم یعنی همه (نه هیچکدام).
autoOpenbooleanبازکردنِ خودکارِ نخستین کتاب — برای پیشنمایشِ خودکارِ سایت.
نصب
۱. این آدرس رو یکبار توی components.json بذار تا shadcn مخزن فارسیفای رو بشناسه.
{
"registries": {
"@farsify": "https://farsifyui.ir/r/{name}.json"
}
}۲. بعد با دستور زیر کامپوننت رو نصب کن.
npx shadcn@latest add @farsify/bookshelfپیشنیاز: Tailwind CSS v4 و صفحهٔ راستبهچپ dir="rtl".
نمونه
"use client";
import { Bookshelf } from "@/components/farsify/bookshelf";
export function ReadingCorner() {
return <Bookshelf />;
}
// کتابهای خودت — هر پارچه، هر فویل و هر متنی
<Bookshelf
books={[
{
id: "diary",
title: "دفترِ روزانه",
author: "خودم",
cloth: "#3b4a6b",
foil: "#e9d7a8",
blurb: "یک سال نوشتن، بی هیچ قاعدهای.",
content: <p>هر بلندی که به کتاب بدهی، خودش درست صفحهبندی میشود.</p>,
},
]}
/>
// قفسهٔ جمعوجورتر
<Bookshelf count={3} />نکتهها
- هیچ وابستگیای نداره — بدونِ `motion`؛ همهچیز فیزیکِ دستی روی requestAnimationFrame و CSS پورسه: جلدها با معادلهٔ تابِ سنگینی روی لولا، برگهها با هندسهٔ تاخوردنِ کاغذ (تای = عمودنیمسازِ خطِ گوشهتامقصد).
- هندسه کاملاً برای کتابِ فارسی آینه شده: عطف سمتِ راست، صفحهٔ اول سمتِ چپ و ورقخوردن از چپ به راست — نه ترفندِ ظاهری؛ خودِ ریاضیات آینه شده.
- متن با ستونهای CSS صفحهبندی میشه و هر متنی به هر بلندی، خودش درست صفحه میشه؛ شمارهٔ صفحهها فارسیه.
- جلد و عطف هر کتاب با `cloth` و `foil` داده میشه؛ رنگهای فیزیکی (کاغذِ کرم، چوبِ قفسه) با تم عوض نمیشن ولی متغیرِ `--bs-*` در `bookshelf.css` هستند — کتاب است دیگه، ولی رنگش دستِ توست.
- روی صفحههای پهن گسترشِ دوعفحهایه و روی گوشی تکصفحه؛ برگشتن به قفسه با `offset-path` پرواز میکنه و تا لحظهٔ نشستن، عطفش به ردیف میچرخه.
- با `prefers-reduced-motion` کتاب بدونِ انیمیشن باز میمونه و پروازها حذف میشن؛ صفحهها همچنان ورق میخورن.
همخانوادهها
کامپوننتهای دیگری از همان دسته که با این یکی جور درمیآیند.
مجوز
کد بعد از نصب مال خودته؛ هر تغییری خواستی بده و توی پروژهی خودت نگهش دار. برای پروژههای شخصی و تجاری آزاده، حتی اگه کدت بسته باشه. فقط اسم و لینک فارسیفای رو یه جا توی پروژه نگه دار.