Breadcrumb
נתיב קישורים משורש האתר ועד לדף הנוכחי.
- דפדפנים
- Chrome 123+, Firefox 121+, Safari 17.5+
- שכבה
- 0
- גודל חבילה דחוסה
- 1.36 kB
- מגבלת פריסה כפויה
- 0 ms
- מגבלת Axe
- 0
- תואם SSR
- כן
- מבוסס על
- elements/details
- חוזה מפורסם
- סביבת בדיקות
מגרש ניסויים
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
import { Breadcrumb } from "@gunkin/uiify";
export default function Example() {
return (
<Breadcrumb.Root className="">
<Breadcrumb.List
className=""
items={[
{ key: "home", label: "Home", href: "/" },
{ key: "components", label: "Components", current: true },
]}
slotProps={{
item: { className: "" },
link: { className: "" },
}}
separator={<Breadcrumb.Separator className="" />}
/>
</Breadcrumb.Root>
);
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
@layer components {
[data-uiify-breadcrumb] [data-part="list"] {
display: flex;
flex-wrap: wrap;
align-items: center;
gap: 0.5rem;
list-style: none;
padding: 0;
margin: 0;
}
[data-uiify-breadcrumb] [data-part="item"] {
display: flex;
align-items: center;
gap: 0.5rem;
}
[data-uiify-breadcrumb] [data-part="link"] {
color: var(--primary);
text-decoration: none;
}
[data-uiify-breadcrumb] [data-part="link"]:hover {
text-decoration: underline;
}
[data-uiify-breadcrumb] [aria-hidden="true"] {
color: var(--muted-foreground);
}
[data-uiify-breadcrumb] [data-current] {
color: var(--foreground);
font-weight: 600;
}
}
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
import { Breadcrumb } from "@gunkin/uiify";
export default function Example() {
return (
<Breadcrumb.Root className="">
<Breadcrumb.List
className="flex flex-wrap items-center [gap:0.5rem] list-none p-0 m-0"
items={[
{ key: "home", label: "Home", href: "/" },
{ key: "components", label: "Components", current: true },
]}
slotProps={{
item: { className: "flex items-center [gap:0.5rem]" },
link: {
className:
"text-primary no-underline hover:underline data-[current]:text-foreground " +
"data-[current]:font-semibold",
},
}}
separator={<Breadcrumb.Separator className="text-muted-foreground" />}
/>
</Breadcrumb.Root>
);
}
API
Breadcrumb.Root
aria-label | string | "Breadcrumb" | שם נגיש לאזור הניווט. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
Breadcrumb.List
children | ReactNode | — | פריטי נתיב ניווט שנכתבו ידנית, כחלופה ל-items. |
items | BreadcrumbItemData[] | — | רשומות מונעות מנתונים, כל אחת עם key, תווית ו-href ודגל current אופציונליים; נדרשות כאשר maxItems מוגדר. |
itemsAfterCollapse | number | 1 | מספר הפריטים מסוף הנתיב שנותרים גלויים כשהנתיב מקופל. |
itemsBeforeCollapse | number | 1 | מספר הפריטים מתחילת הנתיב שנותרים גלויים כשהנתיב מקופל. |
maxItems | number | — | מספר הפריטים שמעליו אמצע הנתיב מתקפל מאחורי שלוש נקודות הניתנות להרחבה. |
separator | ReactNode | — | תוכן המוצג בין הפריטים כשהרשימה נבנית מתוך items. |
slotProps | BreadcrumbListSlotProps | — | מאפיינים מובנים לפריטים, לקישורים ולחלקי ההרחבה המקופלים שנוצרים; המפתחות ב-byItemValue הם ערכי key של הפריטים. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
Breadcrumb.Item
children | ReactNode | — | תוכן פריט אחד ברשימת נתיב הניווט. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
Breadcrumb.Link
children | ReactNode | — | תווית הקישור. |
current | boolean | false | מסמן רשומה זו כעמוד הנוכחי ומגדיר עליה aria-current. |
href | string | — | יעד הקישור; יש להשמיט אותו להצגת רשומה שאינה מנווטת. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
Breadcrumb.Separator
children | ReactNode | "/" | תוכן המפריד, המוסתר מטכנולוגיות מסייעות. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
Breadcrumb.Ellipsis
slotProps | BreadcrumbEllipsisPartProps["slotProps"] | — | מאפיינים מובנים לפריט שלוש הנקודות ולסמל שנוצרים. |
מקלדת
| מקש | פעולה |
|---|
| Tab | העברת המיקוד אל הפקד או ממנו |
| Enter / Space | הפעלה כשהפקד ממוקד (פקדים דמויי כפתור) |
נגישות
משתמש ב-HTML סמנטי ככל האפשר. בדקו את הסימון המרונדר במגרש הניסויים — ARIA נוסף רק כאשר האלמנטים המובנים אינם מספיקים.
נקודות חיבור לעיצוב
data-disabled