Flower Menuمنو و ناوبری

منوی شکوفه‌ای

دکمه‌ای با آیکنِ + که آیکن‌هاش مثل گلبرگ دورش شکوفا می‌شن؛ با لمسِ دوباره با همون آرامش جمع می‌شن.

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

وابستگی‌ها

motionlucide-react

نوع تعامل

لمسِ دکمه‌ی مرکزی گلبرگ‌ها رو یکی‌یکی (هر کدوم ۳۵ میلی‌ثانیه دیرتر از قبلی) با فنر باز می‌کنه، هر گلبرگ از تاریِ نرم وارد می‌شه و `+` می‌چرخه تا ضربدر شه. لمسِ دوباره گلبرگ‌ها از آخر به اول با گذارِ نرم جمع می‌کنه. با Space یا Enter هم باز/بسته می‌شه و با باز شدن، فوکوس روی اولین گلبرگ می‌نشینه تا با Tab بقیه رو ببینی؛ Escape هر جا که باشی ببندش و فوکوس رو به دکمه‌ی مرکزی برمی‌گردونه. گلبرگِ بسته با `inert` از ترتیبِ فوکوس و از درختِ دسترس‌پذیری بیرونه. هر گلبرگ یک دکمه‌ی واقعیه؛ کلیک یا Enter روش، `onSelect` رو صدا می‌زنه و منو رو جمع می‌کنه.

پراپ‌ها

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

items
FlowerMenuItem[]پیش‌فرض: ۱۰ آیکنِ پیش‌فرض با برچسبِ فارسی

آیتم‌های منو؛ هر آیتم `id` و `label` و آیکن داره. برچسب به `aria-label` می‌ره چون منو متنِ دیدنی نداره.

open
boolean

حالتِ کنترل‌شده؛ نده تا خود کامپوننت state داشته باشه.

onOpenChange
(open: boolean) => void

با هر باز یا بسته شدن صدا زده می‌شه.

radius
numberپیش‌فرض: 88

شعاعِ دایره‌ی شکوفا شدن بر حسب پیکسل — فاصله‌ی مرکزِ هر گلبرگ تا مرکزِ منو.

discSize
numberپیش‌فرض: 46

اندازه‌ی هر گلبرگ.

centerSize
numberپیش‌فرض: 58

اندازه‌ی دکمه‌ی مرکزی.

نصب

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

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

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

npx shadcn@latest add @farsify/flower-menu

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

نمونه

flower-menu.tsxtsx
"use client";

import { useState } from "react";
import { FlowerMenu } from "@/components/farsify/flower-menu";
import { Home, Search } from "lucide-react";

// ساده‌ترین حالت — خودش باز و بسته می‌شود
<FlowerMenu />

// کنترل‌شده — باز و بسته دستِ تو
export function QuickActions() {
  const [open, setOpen] = useState(false);
  return <FlowerMenu open={open} onOpenChange={setOpen} />;
}

// مرکزِ آبیِ برند و شکوفای پهن‌تر
<FlowerMenu accent="var(--color-brand)" radius={110} />

// فنرِ تندتر و پله‌ی کوتاه — حسِ یک‌باره شکوفا شدن
<FlowerMenu stiffness={700} damping={12} stagger={12} />

// آیتم‌های خودت — برچسب به aria-label می‌رود چون منو متنِ دیدنی ندارد
<FlowerMenu
  items={[
    { id: "home", label: "خانه", icon: Home },
    { id: "search", label: "جست‌وجو", icon: Search },
  ]}
/>

نکته‌ها

  • دایره متقارنه و فلشِ جهت‌دار نداره، پس برای RTL چیزی آینه نشده — هندسه فیزیکی می‌مونه و مرکزِ قاب در هر دو جهت همون نقطه‌ست.
  • قابِ منو با شعاعِ شکوفا رشد می‌کنه (ثابت نیست)، پس شعاعِ بزرگ هم از قاب بیرون نمی‌زنه؛ فقط ارتفاعِ کارتِ میزبان رو ببین.
  • سایه‌ی دیسک‌ها با متغیرِ `--fm-disc` در فایلِ CSS کنترل می‌شه و در تمِ تیره با گزینشگرِ `.dark` خودش عوض می‌شه؛ اگه پروژه‌ت کلاسِ تمِ دیگه‌ای داره، همون یه گزینشگر رو عوض کن.
  • گلبرگ‌های بسته `tabIndex={-1}` و `aria-hidden` دارن — در پیاده‌سازی‌های رایج نامرئی ولی قابلِ tab بودند؛ این‌جا درست شد.
  • با `prefers-reduced-motion` همه‌ی گذارها بی‌درنگ می‌شن: گلبرگ‌ها بدون فنر جابه‌جا می‌شن و تأخیرِ پله‌ای صفر می‌شه.

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

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

مجوز

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