رفتن به محتوای اصلی

کامپوننت‌ها

مسیر صفحه

نشان می‌دهد کاربر کجای ساختار سایت است.

import { Breadcrumb } from "@kashi-ui/react";

نمونه

خانه فقط با آیکون نمایش داده می‌شود و برچسبش برای صفحه‌خوان می‌ماند.

<Breadcrumb items={[
{ label: "خانه", href: "/", icon: <HomeIcon />, hideLabel: true },
{ label: "تنظیمات", href: "/settings" },
{ label: "امنیت" },
]} />

مسیر بلند

با maxItems وسط مسیر به «…» جمع می‌شود؛ با زدن آن، مسیر کامل باز می‌شود. نام‌های بلند هم کوتاه می‌شوند و متن کامل در title است.

<Breadcrumb maxItems={3} items={[
{ label: "خانه", href: "/", icon: <HomeIcon />, hideLabel: true },
{ label: "پروژه‌ها", href: "/projects" },
{ label: "فروشگاه آنلاین", href: "/projects/shop" },
{ label: "تنظیمات", href: "/projects/shop/settings" },
{ label: "امنیت و ورود دو مرحله‌ای" },
]} />

جداکنندهٔ «/»

<Breadcrumb separator="slash" items={[…]} />
نامنوعپیش‌فرضتوضیح
items{ label, href?, icon?, hideLabel? }[]—آخرین مورد صفحهٔ فعلی است
maxItemsnumber—جمع کردن وسط مسیرهای بلند
separator"chevron" | "slash""chevron"شکل جداکننده
labelstring"مسیر"نام nav برای صفحه‌خوان
expandLabelstring"نمایش مسیر کامل"نام دکمهٔ «…»

متغیرهای CSS

--k-breadcrumb-max-item (پیش‌فرض 14rem): بیشترین عرض هر مورد پیش از کوتاه شدن.

دسترس‌پذیری

داخل <nav aria-label="مسیر"> با فهرست <ol>؛ صفحهٔ فعلی aria-current="page" دارد و لینک نیست. جداکننده‌ها تزئینی‌اند و در راست‌به‌چپ آینه می‌شوند. «…» یک دکمهٔ واقعی با نام «نمایش مسیر کامل» است.