کاستومایز
Flower Menuمنو و ناوبری
منوی شکوفهای
دکمهای با آیکنِ + که آیکنهاش مثل گلبرگ دورش شکوفا میشن؛ با لمسِ دوباره با همون آرامش جمع میشن.
وابستگیها
نوع تعامل
لمسِ دکمهی مرکزی گلبرگها رو یکییکی (هر کدوم ۳۵ میلیثانیه دیرتر از قبلی) با فنر باز میکنه، هر گلبرگ از تاریِ نرم وارد میشه و `+` میچرخه تا ضربدر شه. لمسِ دوباره گلبرگها از آخر به اول با گذارِ نرم جمع میکنه. با Space یا Enter هم باز/بسته میشه و با باز شدن، فوکوس روی اولین گلبرگ مینشینه تا با Tab بقیه رو ببینی؛ Escape هر جا که باشی ببندش و فوکوس رو به دکمهی مرکزی برمیگردونه. گلبرگِ بسته با `inert` از ترتیبِ فوکوس و از درختِ دسترسپذیری بیرونه. هر گلبرگ یک دکمهی واقعیه؛ کلیک یا Enter روش، `onSelect` رو صدا میزنه و منو رو جمع میکنه.
پراپها
گزینههایی که میتونی به کامپوننت بدی؛ ستارهدارها اجباریاند.
itemsFlowerMenuItem[]پیشفرض: ۱۰ آیکنِ پیشفرض با برچسبِ فارسیآیتمهای منو؛ هر آیتم `id` و `label` و آیکن داره. برچسب به `aria-label` میره چون منو متنِ دیدنی نداره.
openbooleanحالتِ کنترلشده؛ نده تا خود کامپوننت state داشته باشه.
onOpenChange(open: boolean) => voidبا هر باز یا بسته شدن صدا زده میشه.
radiusnumberپیشفرض: 88شعاعِ دایرهی شکوفا شدن بر حسب پیکسل — فاصلهی مرکزِ هر گلبرگ تا مرکزِ منو.
discSizenumberپیشفرض: 46اندازهی هر گلبرگ.
centerSizenumberپیشفرض: 58اندازهی دکمهی مرکزی.
نصب
۱. این آدرس رو یکبار توی components.json بذار تا shadcn مخزن فارسیفای رو بشناسه.
{
"registries": {
"@farsify": "https://farsifyui.ir/r/{name}.json"
}
}۲. بعد با دستور زیر کامپوننت رو نصب کن.
npx shadcn@latest add @farsify/flower-menuپیشنیاز: Tailwind CSS v4 و صفحهٔ راستبهچپ dir="rtl".
نمونه
"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` همهی گذارها بیدرنگ میشن: گلبرگها بدون فنر جابهجا میشن و تأخیرِ پلهای صفر میشه.
همخانوادهها
کامپوننتهای دیگری از همان دسته که با این یکی جور درمیآیند.
مجوز
کد بعد از نصب مال خودته؛ هر تغییری خواستی بده و توی پروژهی خودت نگهش دار. برای پروژههای شخصی و تجاری آزاده، حتی اگه کدت بسته باشه. فقط اسم و لینک فارسیفای رو یه جا توی پروژه نگه دار.