Bookshelfشو تایم

قفسه کتاب

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

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

وابستگی‌ها

بدون وابستگی

نوع تعامل

روی عطفی که می‌خوای برو؛ بالا میاد. کلیکش کنی از قفسه پایین میاد روی میز و جلدش با تابِ سنگینی روی لولا باز می‌شه (بکشی هم می‌تونی خودت بلندش کنی و رها کنی). صفحه‌ها رو از نیمهٔ بیرونی‌شون بکش یا کلیک کن؛ پرتتابِ تند ورق می‌زنه، نیمه‌کاره با فنر برمی‌گرده. فلش‌ها ورق می‌زنن (راست = بعدی، هم‌سو با جهتِ ورق‌خوردنِ کتابِ فارسی) و Escape می‌بنده. با کلیک بیرون از کتاب یا Escape بسته می‌شه و پرواز می‌کنه سرِ جاش در قفسه؛ روی نمایشگرِ پهن، رسیدن به آخرین صفحه هم خودش می‌بنددش. صفحه‌های باریک تک‌صفحه‌ن.

پراپ‌ها

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

books
ShelfBook[]

کتاب‌های قفسه (`title`، `author`، `cloth`، `foil`، `blurb`، `content` و اختیاری: `height`/`width`/`label`)؛ پیش‌فرض پنج کتابِ خودِ کامپوننت با متن‌های فارسی.

series
stringپیش‌فرض: "اتاقِ مطالعه"

نامِ سری؛ سرصفحهٔ صفحاتِ راست و پایِ هر جلدِ پشت.

count
number

چند کتابِ اولِ قفسه نشون داده شه؛ بدونِ اون همه، و `0` هم یعنی همه (نه هیچ‌کدام).

autoOpen
boolean

بازکردنِ خودکارِ نخستین کتاب — برای پیش‌نمایشِ خودکارِ سایت.

نصب

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

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

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

npx shadcn@latest add @farsify/bookshelf

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

نمونه

bookshelf.tsxtsx
"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` کتاب بدونِ انیمیشن باز می‌مونه و پروازها حذف می‌شن؛ صفحه‌ها همچنان ورق می‌خورن.

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

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

مجوز

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