رفتن به محتوای اصلی
  • معرفی
  • نصب
  • Tailwind
  • وب کامپوننت‌ها (بدون React)
  • دوزبانه، فارسی و انگلیسی
  • پلاگین‌های فیگما
  • استفاده با هوش مصنوعی
  • آیکون‌ها
  • راهنمای آیکون‌ها
  • سفارشی‌سازی و تم
  • حرکت و ریزتعامل‌ها
  • حالت‌های کامپوننت‌ها
  • فونت و تایپوگرافی
  • دسترس‌پذیری
  • نوشتن متن رابط
  • رنگ‌ها
  • برند کاشی
  • مقایسه با دیگران
  • نسخه‌ها
  • سیاست تغییرات
  • مهاجرت به ۲.۰
  • امنیت
  • حجم کامپوننت‌ها
  • فیلد فارسی
  • دیت‌پیکر شمسی
  • کد تأیید (OTP)
  • بازهٔ تاریخ شمسی
  • انتخاب ماه
  • شمارش معکوس
  • هیت‌مپ فعالیت
  • انتخاب استان
  • نقشهٔ ایران
  • فرم نشانی
  • انتخاب نوبت
  • ویرایش نگارشی
  • نمایش مبلغ
  • بازهٔ قیمت
  • کارت بانکی
  • رسید پرداخت
  • برگ تقویم
  • لوگوی بانک‌ها
  • ابزارهای فارسی
  • آپلود فایل
  • آکاردئون
  • آواتار
  • اسپلیتر
  • استپر
  • اسکلتون
  • اسلایدر
  • اعتبارسنجی فرم
  • امتیاز ستاره‌ای
  • انتخاب چندتایی
  • انتخاب رنگ
  • بج
  • بردکرامب
  • برگهٔ پایین
  • بنر
  • پاپ‌اور
  • تایم‌لاین
  • تب‌ها
  • تور معرفی
  • توست
  • تولتیپ
  • جداکننده و کلید میان‌بر
  • جدول داده
  • جستجو با پیشنهاد
  • چک‌باکس
  • چیپس
  • حالت خالی
  • دراپ‌داون
  • دکمه
  • دکمهٔ کپی
  • دیالوگ
  • رادیو
  • سایدبار
  • سگمنت
  • سلکت
  • سوییچ
  • صفحه‌بندی
  • قدرت رمز عبور
  • کارت
  • کارت آمار
  • کاروسل
  • کامبوباکس
  • کامند پالت
  • کشو
  • گروه دکمه
  • گیج
  • منوی راست‌کلیک
  • نمای درختی
  • نمودار
  • نمونهٔ رنگ
  • نوار پیشرفت
  • نوار ناوبری
  • ورودی
  • ورودی تگ
  • ورودی عدد
  • ویرایش درجا
  • هشدار
شروع کنید

نوار ناوبری

نوار بالای سایت با لوگو، پیوندها و دکمه‌ها؛ نشانگر لغزان روی پیوندها، سایه هنگام اسکرول و منوی کشو در گوشی.

npm i @kashi-ui/react @kashi-ui/css
import { Navbar } from "@kashi-ui/react";

CSS را یک بار در ریشهٔ برنامه وارد کنید: import "@kashi-ui/css"حجم: ۱٫۹ کیلوبایت + هستهٔ مشترکراهنمای نصب

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).

ویژگی‌ها

ویژگی‌ها (props)
نامتوضیح، نوع و پیش‌فرض
brand

لوگو و نام

نوع: ReactNode

brandHref

پیوند لوگو

نوع: stringپیش‌فرض "/"

links

پیوندها؛ current صفحهٔ فعلی است

نوع: { href, label, current?, icon?, badge? }[]

actions

دکمه‌ها و آیکون‌ها، مثل ورود یا جست‌وجو

نوع: ReactNode

sticky

چسبیدن به بالای صفحه؛ با اسکرول سایه و پس‌زمینهٔ مات می‌گیرد

نوع: booleanپیش‌فرض true

variant

نشان صفحهٔ فعلی: خط زیر پیوند یا قرص رنگی

نوع: "line""pill"پیش‌فرض "line"

centered

پیوندها وسط نوار

نوع: booleanپیش‌فرض false

floating

نوار شناور با گوشهٔ گرد و فاصله از لبه‌ها

نوع: booleanپیش‌فرض false

transparent

بی‌رنگ روی هیرو تا وقتی صفحه اسکرول شود

نوع: booleanپیش‌فرض false

collapseBelow

زیر ۶۴۰، ۷۶۸ یا ۱۰۲۴ پیکسل پیوندها به منو می‌روند

نوع: "sm""md""lg"پیش‌فرض "md"

menuFooter

پایین منوی گوشی

نوع: ReactNode

linkAs

کامپوننت پیوند، مثل Link در Next.js

نوع: ElementTypeپیش‌فرض "a"

aria-label

نام ناحیهٔ ناوبری

نوع: stringپیش‌فرض "ناوبری اصلی"

متغیرهای CSS: --k-navbar-height (پیش‌فرض ۴rem)، --k-navbar-max-width (پیش‌فرض ۸۰rem) و --k-navbar-bg.

دسترس‌پذیری

  • پیوندها داخل <nav> با نام «ناوبری اصلی» هستند و صفحهٔ فعلی aria-current="page" دارد.
  • دکمهٔ منو aria-expanded و aria-haspopup="dialog" دارد و منوی گوشی همان کشوی دسترس‌پذیر است.
  • اگر صفحه پیوند «پرش به محتوا» دارد، آن را پیش از نوار بگذارید.

راهنمای استفاده

کِی استفاده کنیم

  • نوار بالای سایت یا اپ با چهار تا شش پیوند اصلی.
  • سایت محصول، فروشگاه یا وبلاگ که در گوشی هم باید راحت پیمایش شود.

کِی استفاده نکنیم

  • پنل مدیریت با ده‌ها بخش؛ سایدبار جای بیشتری دارد. سایدبار
  • جابه‌جایی بین نماهای یک صفحه. تب‌ها

درست و نادرست

  1. درست
    درست: پیوندها کوتاه و اسم بخش باشند: «محصولات»، «قیمت‌ها»، «وبلاگ».
    نادرست
    نادرست: هشت پیوند با عنوان‌های بلند که در لپ‌تاپ هم جا نمی‌شوند.
  2. درست
    درست: صفحهٔ فعلی را با current مشخص کنید تا هم دیده شود و هم صفحه‌خوان بخواند.
    نادرست
    نادرست: پیوند فعلی فقط با رنگ پررنگ‌تر و بدون aria-current.