Pagination
קישורים או כפתורים למעבר בין דפי תוצאות.
- דפדפנים
- Chrome 123+Firefox 121+Safari 17.5+
- שכבה
- 0
- גודל חבילה דחוסה
- 3.03 kB
- מגבלת פריסה כפויה
- 0 ms
- מגבלת Axe
- 0
- תואם SSR
- כן
- חוזה מפורסם
- סביבת בדיקות
מגרש ניסויים
API
Pagination.Root
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
aria-label | string | "Pagination" | שם נגיש לאזור הניווט. |
boundaryCount | number | 1 | מספר העמודים המוצגים תמיד בכל קצה של הטווח. |
count* | number | — | מספר העמודים הכולל. |
defaultPage | number | 1 | העמוד הנבחר בתחילה כשהרכיב אינו מבוקר. |
disabled | boolean | false | משבית את כל העמודים ופקדי הניווט. |
onPageChange | (page: number) => void | — | נקראת עם מספר העמוד החדש בכל שינוי בעמוד. |
page | number | — | העמוד הנוכחי, ההופך את הרכיב למבוקר. |
showFirstLast | boolean | false | מוסיף פקדים לעמוד הראשון והאחרון לפריטים שנוצרים. |
siblingCount | number | 1 | מספר העמודים המוצגים בכל צד של העמוד הנוכחי. |
slotProps | PaginationRootSlotProps | — | מאפיינים מובנים לרשימה, לפריטים, לקישורי העמודים, לפקדים ולשלוש הנקודות שנוצרים. |
children | ReactNode | — | מבנה פריטים מותאם אישית; כשהוא מושמט, מוצגת במקומו רשימת העמודים שנוצרת. |
getPageHref | (page: number) => string | — | בונה את href לכל עמוד כדי שהמעטפת מהשרת תציג קישורים אמיתיים הפועלים ללא JavaScript. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
Pagination.List
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
children | ReactNode | — | פריטי העימוד המוצגים בתוך הרשימה. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
Pagination.Item
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
children | ReactNode | — | תוכן פריט אחד ברשימת העימוד. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
Pagination.Link
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
disabled | boolean | false | משבית את הפקד ומסיר את href שלו. |
getPageHref | (page: number) => string | — | בונה את href לעמוד זה, והופך את הפקד לקישור אמיתי. |
page* | number | — | מספר העמוד שפקד זה בוחר. |
selected | boolean | false | מסמן עמוד זה כנוכחי ומגדיר עליו aria-current. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
Pagination.Ellipsis
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
children | ReactNode | — | תוכן שלוש הנקודות, המוסתר מטכנולוגיות מסייעות. |
render | ReactElement | ((props, state) => ReactElement) | — | החלפת האלמנט המוצג תוך שימור ההתנהגות וקישורי הנגישות. |
מקלדת
| מקש | פעולה |
|---|---|
| Tab | העברת המיקוד אל הפקד או ממנו |
| Enter / Space | הפעלה כשהפקד ממוקד (פקדים דמויי כפתור) |
נגישות
משתמש ב-HTML סמנטי ככל האפשר. בדקו את הסימון המרונדר במגרש הניסויים — ARIA נוסף רק כאשר האלמנטים המובנים אינם מספיקים.
נקודות חיבור לעיצוב
data-disabled