نوار ناوبری
نوار بالای سایت با لوگو، پیوندها و دکمهها؛ نشانگر لغزان روی پیوندها، سایه هنگام اسکرول و منوی کشو در گوشی.
npm i @kashi-ui/react @kashi-ui/cssimport { Navbar } from "@kashi-ui/react";CSS را یک بار در ریشهٔ برنامه وارد کنید: import "@kashi-ui/css"حجم: ۱٫۹ کیلوبایت + هستهٔ مشترکراهنمای نصب
npx shadcn@latest add @kashi/navbarکد خودِ کامپوننت در پوشهٔ components/kashi پروژهٔ شما کپی میشود. برای نسخههای قدیمی shadcn، راهنمای «دربارهٔ shadcn» را ببینید.دربارهٔ shadcn
import { Navbar } from "@kashi-ui/react";
نمونه
<Navbar
brand={<><Logo />فروشگاه کاشی</>}
links={[
{ href: "/", label: "خانه" },
{ href: "/products", label: "محصولات", current: true },
{ href: "/pricing", label: "قیمتها" },
{ href: "/blog", label: "وبلاگ", badge: "جدید" },
]}
actions={<>
<Button size="sm" variant="tertiary">ورود</Button>
<Button size="sm" variant="primary">ثبتنام</Button>
</>}
/>نشانگر را روی پیوندها ببرید: پسزمینهٔ ملایم زیر نشانگر میلغزد و وقتی بیرون بروید به صفحهٔ فعلی برمیگردد. با کیبورد هم همینطور است.
مدلها
چهار انتخاب که با هم ترکیب میشوند: نشان صفحهٔ فعلی با variant (خط یا قرص)، centered برای پیوندهای وسط نوار، floating برای نوار جدا از لبهها با گوشهٔ گرد، و transparent برای نوار بیرنگ روی هیرو که با اسکرول پسزمینه میگیرد.
<Navbar variant="pill" … />
<Navbar centered variant="pill" … />
<Navbar floating variant="pill" … />
<Navbar transparent … /> // روی تصویر یا هیرو- پیشفرض برای سایت محتوایی و مستندات؛ آرامترین مدل.
- قرص برای اپ و فروشگاه؛ صفحهٔ فعلی پررنگتر دیده میشود.
- وسطچین وقتی لوگو و دکمهها کماند و پیوندها اصل ماجرا هستند، مثل صفحهٔ معرفی محصول.
- شناور برای صفحهٔ فرود؛ با اسکرول جدا از محتوا میماند و سایهاش بیشتر میشود.
- شفاف فقط روی تصویر یا هیروی تیره؛ رنگ متن لوگو را خودتان با پسزمینه هماهنگ کنید.
در گوشی
زیر عرض collapseBelow پیوندها در یک کشو جمع میشوند و دکمهٔ منو جایشان را میگیرد. menuFooter پایین همان کشو است، مثلاً دکمهٔ ثبتنام.
<Navbar collapseBelow="md" menuFooter={<Button variant="primary">ثبتنام</Button>} … />با Next.js و روترها
پیوندها پیشفرض <a> هستند. برای پیمایش بدون بارگذاری دوباره، کامپوننت پیوند روتر را بدهید:
import Link from "next/link";
<Navbar linkAs={Link} links={links} brand={…} />
current را از مسیر فعلی بسازید، مثلاً current: pathname.startsWith(href).
ویژگیها
| نام | توضیح، نوع و پیشفرض |
|---|---|
brand | لوگو و نام |
brandHref | پیوند لوگو |
links | پیوندها؛ current صفحهٔ فعلی است |
actions | دکمهها و آیکونها، مثل ورود یا جستوجو |
sticky | چسبیدن به بالای صفحه؛ با اسکرول سایه و پسزمینهٔ مات میگیرد |
variant | نشان صفحهٔ فعلی: خط زیر پیوند یا قرص رنگی |
centered | پیوندها وسط نوار |
floating | نوار شناور با گوشهٔ گرد و فاصله از لبهها |
transparent | بیرنگ روی هیرو تا وقتی صفحه اسکرول شود |
collapseBelow | زیر ۶۴۰، ۷۶۸ یا ۱۰۲۴ پیکسل پیوندها به منو میروند |
menuFooter | پایین منوی گوشی |
linkAs | کامپوننت پیوند، مثل Link در Next.js |
aria-label | نام ناحیهٔ ناوبری |
متغیرهای CSS: --k-navbar-height (پیشفرض ۴rem)، --k-navbar-max-width (پیشفرض ۸۰rem) و --k-navbar-bg.
دسترسپذیری
- پیوندها داخل
<nav>با نام «ناوبری اصلی» هستند و صفحهٔ فعلیaria-current="page"دارد. - دکمهٔ منو
aria-expandedوaria-haspopup="dialog"دارد و منوی گوشی همان کشوی دسترسپذیر است. - اگر صفحه پیوند «پرش به محتوا» دارد، آن را پیش از نوار بگذارید.
راهنمای استفاده
کِی استفاده کنیم
- نوار بالای سایت یا اپ با چهار تا شش پیوند اصلی.
- سایت محصول، فروشگاه یا وبلاگ که در گوشی هم باید راحت پیمایش شود.
درست و نادرست
- درست
درست: پیوندها کوتاه و اسم بخش باشند: «محصولات»، «قیمتها»، «وبلاگ». نادرستنادرست: هشت پیوند با عنوانهای بلند که در لپتاپ هم جا نمیشوند. - درست
درست: صفحهٔ فعلی را با currentمشخص کنید تا هم دیده شود و هم صفحهخوان بخواند.نادرستنادرست: پیوند فعلی فقط با رنگ پررنگتر و بدون aria-current.