Virtual scroll
רשימה בחלון תצוגה — 10k שורות, כ-25 צומתי DOM.
- דפדפנים
- Chrome 123+Firefox 121+Safari 17.5+
- שכבה
- 2
- גודל חבילה דחוסה
- 4.81 kB
- מגבלת פריסה כפויה
- 0 ms
- מגבלת Axe
- 0
- תואם SSR
- כן
- חוזה מפורסם
- סביבת בדיקות
מגרש ניסויים
API
VirtualScroll
| מאפיין | טיפוס | ברירת מחדל | תיאור |
|---|---|---|---|
items* | T[] | — | רשימת הפריטים המלאה, עם מזהה יציב לכל פריט; רק השורות בטווח הנוכחי מוצגות. |
renderRow* | (item: T, index: number) => ReactNode | — | מציגה את תוכן השורה לפי הפריט שלה והאינדקס המוחלט שלה. |
slotProps | VirtualScrollSlotProps | — | מאפיינים מובנים למרווח ולעטיפות השורות שנוצרים; ניתן למקד מאפייני שורות חוזרות לפי מזהה פריט יציב או אינדקס פריט מוחלט. מיקום השורה, התפקיד וסמני הפריסה נשארים בשליטת הספרייה. |
height | number | — | גובה מפורש בפיקסלים. ניתן להשמיט אותו ולהעביר style={{ blockSize: '100%' }} כדי למלא גובה מוגדר של ההורה; ברירת המחדל היא 600px אם אף אחד מהם לא סופק. |
rowHeight | number | 64 | גודל קבוע בפיקסלים לכל שורה בציר הגלילה (גובה בגלילה אנכית, רוחב באופקית), המשמש לחישוב גודל הגלילה והשורות הגלויות. |
orientation | "vertical" | "horizontal" | "vertical" | ציר הגלילה. רשימות אופקיות נגללות בציר השורה, קובעות את גודל החלון לפי רוחב אזור התצוגה הנמדד, מתהפכות כראוי בפריסות מימין לשמאל ומשקפות את הערך ב-data-orientation. |
overscan | number | 5 | מספר השורות הנוספות המוצגות מעל לטווח הגלוי ומתחתיו, כדי שגלילה מהירה לא תחשוף שטח ריק. |
estimateRowHeight | (index: number) => number | — | אומדן גובה לכל אינדקס, המעביר את הרשימה לפריסה דינמית שבה השורות המוצגות נמדדות והאומדן מתוקן. |
role | "list" | "grid" | "list" | תפקיד ARIA המוחל על מכל הגלילה. |
anchor | "start" | "end" | "start" | קצה הרשימה שאליו נשאר מיקום הגלילה מוצמד כשמוסיפים או מסירים פריטים. |
followAppend | boolean | "smooth" | false | גולל לפריטים חדשים שנוספו כשהרשימה כבר נמצאת בסופה, עם אפשרות לגלילה חלקה. |
scrollRef | Ref<VirtualScrollHandle> | — | מקבל את ממשק השליטה החושף scrollToIndex, scrollToOffset ו-scrollToEnd. |
onRangeChange | (range: VirtualScrollRangeChange) => void | — | נקראת עם טווח האינדקסים הגלוי והטווח המורחב המוצג מראש בכל תזוזה של חלון התצוגה. |
onScrollStateChange | (state: VirtualScrollScrollState) => void | — | נקראת כשהגלילה מתחילה וכשהיא מסתיימת. |
isScrollingResetDelay | number | 150 | מספר אלפיות השנייה ללא פעילות שאחריהן הגלילה נחשבת כמסתיימת בדפדפנים ללא האירוע scrollend. |
className | string | — | המחלקה המוחלת על מכל הגלילה. |
style | CSSProperties | — | סגנונות אלמנט השורש המובנה. |
ref | Ref<HTMLDivElement> | — | ה-ref המועבר לאלמנט השורש המוצג. |
testId | string | — | הערך של המאפיין data-testid במכל הגלילה. |
מקלדת
| מקש | פעולה |
|---|---|
| Scroll | הגלגלת, משטח המגע או פס הגלילה מזיזים את חלון התצוגה |
| Tab | העברת המיקוד בין פקדי השורה (תיבת סימון, מפעיל תפריט) |
| Arrow keys | מעבר בין פריטים בתוך תפריט נפתח פתוח |
| Escape | סגירת תפריט נפתח פתוח |
נגישות
רכיב מרווח בגובה מלא שומר על דיוק פס הגלילה המובנה, בעוד שרק מאגר קבוע של תאי שורות, בתוספת שורות מעבר לתצוגה, מותקן; מפתחות תאים יציבים ממחזרים צומתי DOM. השורות חושפות role="listitem" עם aria-posinset ו-aria-setsize בתוך אזור גלילה עם role="list". סנכרון הגלילה פסיבי, וקפיצות גדולות באמצעות פס הגלילה, Home/End או Cmd+Arrow מעדכנות את הטווח באופן סינכרוני.
נקודות חיבור לעיצוב
data-uiify-virtual-scrolldata-part="spacer"data-part="row"