תבניות של החלקה להסרה נפוצות באפליקציות לנייד, אבל יכול להיות קשה להטמיע אותן בצורה נקייה באינטרנט. באמצעות CSS Scroll Snap, אתם יכולים ליצור אינטראקציה חלקה של החלקה שמרגישה כמו חלק מהמערכת ומתחברת ישירות למנוע הגלילה של הדפדפן. כך אפשר להבטיח ביצועים גבוהים ותנופה שמבוססת על פיזיקה, בלי להשתמש בספריית תנועות מורכבת של JavaScript.
אותה תבנית פועלת לכל החלקה עם פעולה אחת (הסרה, העברה לארכיון, סימון כ"כבר קראתי", טיפול בהמשך). הפעולות נראות אחרת, אבל המכניקה שלהן לא משתנה.
אם אתם רוצים שהחלקה אופקית תפתח קבוצה של כפתורי פעולה או תפריט צדדי בלי לבצע פעולה באופן אוטומטי במהלך ההחלקה, עיינו בקטע החלקה לחשיפה.
איך מטמיעים
לרכיב יש שתי שכבות: רשימה (<ul>) ופריטים בתוכה. כל פריט מורכב מ-<li> חיצוני, מסלול גלילה פנימי (מאגר הגלילה עם נקודות ההצמדה) ורכיב תוכן (השורה שרואים). ממשק המשתמש של הפעולה (סמל האשפה, תווית הארכיון וכו') מופיע משני צידי התוכן. הרשימה כוללת חיווט משותף (הגדרה עצלה של פריטים, איסוף פריטים שנוספו לאחרונה); כל פריט כולל זיהוי החלקה משלו.
שלב 1: מסמנים את הרשימה עם הטראק והתוכן
<ul class="SwipeableList">
<li id="list-item-1" class="SwipeableList-item">
<div class="SwipeableList-track">
<div class="SwipeableList-content">Item One</div>
</div>
</li>
<li id="list-item-2" class="SwipeableList-item">
<div class="SwipeableList-track">
<div class="SwipeableList-content">Item Two</div>
</div>
</li>
<!-- ...more items... -->
</ul>
שלב 2: מגדירים את המסלול כקונטיינר אופקי עם שלוש נקודות הצמדה
למסלול יש שלוש עמודות ברוחב מלא: מרווח שמאלי (::before), התוכן ומרווח ימני (::after). הצמדה למרווח פירושה שהתוכן נמצא לגמרי מחוץ למסך, וזה המיקום שבו הוא נשאר אחרי החלקה מלאה.
הגדרת המסלול מוגבלת על ידי מחלקת .is-initialized בפריט ברשימה. לפני ש-JS משדרג את השורה, הפריט מוצג כתוכן פשוט בלי פס גלילה אופקי. הכיתה מתווספת בשלב 4 אחרי שה-JavaScript שמזהה החלקות מחובר. כך המשתמש לא יוכל להחליק לפני שהפונקציונליות מוכנה.
.SwipeableList {
list-style: none;
}
.SwipeableList-item {
/* Establishes a containing block for the absolutely positioned action
icons (Step 3) and clips overflow during the row's removal
animation (Step 4). */
contain: content;
}
/* The track only becomes a scroll snap container after JS upgrades
the row by adding `.is-initialized` (see Step 4). */
.SwipeableList-item.is-initialized .SwipeableList-track {
/* Three full-width columns: left spacer | content | right spacer.
Width is 100% of the track, so each column fills the viewport row. */
display: grid;
grid-template-columns: 100% 100% 100%;
/* Horizontal scroll only; vertical overflow is clipped so the
reveal stays inside the row. */
overflow: scroll clip;
/* Prevent the swipe from chaining into the page scroll or browser
back-gesture on iOS/Android. */
overscroll-behavior-x: none;
/* Hide the scrollbar; the gesture is the affordance. */
scrollbar-width: none;
/* `mandatory` ensures the track always rests on a snap point
(spacer or content), never partially scrolled. */
scroll-snap-type: x mandatory;
}
/* Spacers act as the left and right snap targets, AND carry the action's
reveal color. As the user swipes, the colored spacer slides into view,
which is what the user sees behind the content. */
.SwipeableList-item.is-initialized .SwipeableList-track::before,
.SwipeableList-item.is-initialized .SwipeableList-track::after {
content: '';
/* `scroll-snap-align` is required to make this a valid snap target,
but the specific value (`start`/`center`/`end`) doesn't matter here
because each snap point spans the full width of the scroll
container, so all alignments resolve to the same resting position. */
scroll-snap-align: start;
/* `hsl(0 65% 50%)` is an example value; pick whatever fits your
design (red here signals "delete"; use a different color for
archive, mark-as-read, etc.). */
background-color: hsl(0 65% 50%);
}
.SwipeableList-content {
/* The content sits above the action icons (Step 3), so it covers
them until the user swipes. */
position: relative;
z-index: 2;
/* Required to make the content a valid snap target (its resting
position). As with the spacers above, the specific value doesn't
matter because the snap points are full-width. */
scroll-snap-align: start;
/* The content must paint over the revealed spacer color. */
background: Canvas;
/* Row separator (example value; customize to taste). */
border-bottom: 1px solid #eee;
}
/* Gate `scroll-initial-target` behind `.is-initialized` so it only
applies once the track is actually a scroll container. Setting it on
the content before then would let the property walk up to the nearest
scrollable ancestor (typically the document) and shift the page's
initial scroll position to bring this row's content into view. With
the gate, the rule is only live when the row's own track can satisfy
it, so the initial scroll happens inside the track as intended. */
.SwipeableList-item.is-initialized .SwipeableList-content {
scroll-initial-target: nearest;
}
/* The track is the focusable scroll container, but its overflow is clipped
so a default focus ring on the track itself would be invisible. Project
the focus affordance onto the content element (which paints above the
track) using `:focus-visible` on the track. */
.SwipeableList-track:focus-visible .SwipeableList-content {
outline: auto;
outline-offset: -2px;
}
שלב 3: מוסיפים את סמלי הפעולות לפריט ברשימה
צבע הפעולה מופיע במרווחים (שלב 2). סמל הפעולה נמצא בפריט הרשימה עצמו, מעוגן לקצוות השמאלי והימני של השורה.
המיקום, הגודל והתנועה שמופיעים למטה הם הצעה ראשונית, ולא דרישה. כדי להתאים את העיצוב, אפשר לשנות את גודל הסמל, את השוליים הפנימיים, את קנה המידה של ה-pop-up, את משך המעבר ואפילו את הבחירה בין רכיבי פסאודו לבין צומתי DOM אמיתיים. הדרישה המכנית היחידה היא שהסמל יהיה מאחורי התוכן (כדי שהתוכן יוכל לכסות אותו לפני ההחלקה) ובתוך הפריט ברשימה (כדי שהוא לא ייגלל עם המרווח). כל השאר זה עניין של טעם.
/* Action icons painted on the list item. They're absolutely positioned
inside the row (which is a containing block thanks to `contain: content`
on `.SwipeableList-item` from Step 2) and sit at z-index 1, so the
content element (z-index 2) covers them until the user swipes far
enough. */
.SwipeableList-item.is-initialized::before,
.SwipeableList-item.is-initialized::after {
/* Inline an SVG as the action icon. Replace this with whatever icon
fits the action (archive, checkmark, clock, etc.). The `fill='white'`
is baked into the SVG so it contrasts with the red spacer background;
adjust if your background color is light. */
--action-icon: url("data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='white'><path d='M9 3v1H4v2h1v13a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V6h1V4h-5V3H9zm0 5h2v9H9V8zm4 0h2v9h-2V8z'/></svg>");
content: '';
position: absolute;
z-index: 1;
/* The size (`width`) and insets (`left`/`right` below) are example
values, tune them to match your row height and visual weight.
The icon fills its box via `background-size: contain`, so changing
`width` resizes it. */
width: 1.5em; /* example value, adjust to taste */
aspect-ratio: 1;
top: 50%;
translate: 0 -50%;
/* Smooth transitions for the icon's visual states: the activate-point
pop (`scale`, see `.is-activating` below) and the removal fade
(`scale` + `opacity`, see `.is-removing` below). 0.2s is an example
duration. */
transition: scale 0.2s ease, opacity 0.2s ease;
background: var(--action-icon) center / contain no-repeat;
}
/* Inset from the row edge (example values; adjust to match your layout). */
.SwipeableList-item.is-initialized::before { left: 1.5em; }
.SwipeableList-item.is-initialized::after { right: 1.5em; }
/* Activating pop: scale the icon up when the user is past the visual
activate point, so the row's affordance feels reactive. Toggled by JS
in Step 4. */
.SwipeableList-item.is-activating::before,
.SwipeableList-item.is-activating::after {
scale: 1.333;
}
/* Removal affordance: fade and shrink the icons as the row collapses.
Driven by the `is-removing` class added in Step 4 at commit time;
the existing `transition` on the icons animates the change. */
.SwipeableList-item.is-removing::before,
.SwipeableList-item.is-removing::after {
scale: 0.5;
opacity: 0;
}
/* Only show the icon on the *leading* side of the swipe; hide the
trailing-side one. `data-swipe-direction` is set by JS in Step 4. */
.SwipeableList-item.is-activating[data-swipe-direction="left"]::after,
.SwipeableList-item.is-activating[data-swipe-direction="right"]::before {
visibility: hidden;
}
שלב 4: זיהוי תנועת האישור באמצעות IntersectionObserver
משתמשים ב-IntersectionObserver שמושרש בטראק, וצופים בתוכן. כשהמשתמש מחליק, יחס החיתוך של התוכן עם המסלול יורד. אנחנו משתמשים בשני ערכי סף:
-
activateThreshold: יחס גבוה (למשל, 0.8). כשהחלק הגלוי של התוכן קטן מהאחוז הזה, המשתמש עבר את נקודת ההפעלה החזותית. החלפת המצב של האפשרות להקפצת סמלים. -
commitThreshold: יחס נמוך (למשל 0.2). כשהחלק הגלוי יורד מתחת לזה, המשתמש ביצע את הפעולה. מתחילים את אנימציית ההסרה מיד, בלי לחכות שהתנועה המהירה תסתיים. השורה שמתכווצת משתלבת בתנועת ההחלקה של המשתמש, וזה מרגיש יותר רספונסיבי מאשר לחכות שהשורה תתכווץ לפני שמגיבים.
כאן אנחנו מטפלים בשני נושאים נוספים:
- הגדרה עצלה לכל פריט: רכיב
IntersectionObserverחיצוני אחד שמושרש באזור התצוגה מפעיל את ההגדרה ואת ההתחלה/הפסקה של רכיבי ה-swipe observer הפנימיים. הפריטים מחוברים רק בפעם הראשונה שהם נגללים לתצוגה, והצופה בהחלקה מושהה בפריטים שנגללים אל מחוץ למסך. כך מספר הצופים הפעילים נשאר מוגבל, ולא נקראים ערכים שתלויים בפריסה (כמוclientWidth) לפני שהפריט עבר עיבוד. - פריטים דינמיים: רשימות אמיתיות גדלות עם הזמן (רינדור ראשוני, גלילה מתמשכת, דחיפת שרת).
MutationObserverב-<ul>רושם כל פריט חדש שנוסף עם הצופה החיצוני.
// Per-item handles. Populated when an item is first lazily wired up; read by
// the outer viewport observer to start/stop the inner observer as items enter
// and leave the viewport.
const swipeObservers = new WeakMap();
// Outer observer: drives the entire swipe lifecycle off viewport visibility.
// On first entry, lazily wires the item up (`setupItem` reads layout-dependent
// values like `clientWidth`, which return 0 until the item is rendered). After
// setup, starts the inner observer. On exit, stops the inner observer so
// offscreen items don't track scroll positions.
const viewportObserver = new IntersectionObserver((entries) => {
for (const entry of entries) {
const item = entry.target;
if (entry.isIntersecting) {
const handle = swipeObservers.get(item) ?? setupItem(item);
handle.observer.observe(handle.content);
} else {
const handle = swipeObservers.get(item);
if (handle) handle.observer.unobserve(handle.content);
}
}
});
function setupItem(item) {
const track = item.querySelector('.SwipeableList-track');
const content = track.querySelector('.SwipeableList-content');
// Upgrade the row into "swipeable" mode. This is the gate for all the CSS
// from Steps 2 and 3 (the track becomes a snap container, the action icons
// appear). Done *before* the inner observer is attached so the snap
// container exists by the time intersection callbacks can fire.
item.classList.add('is-initialized');
// Tunable thresholds. `activateThreshold` is the visual feedback point
// (icon pops). `commitThreshold` is the point of no return: once the
// content is past this point of being off-screen, we commit even if the
// user releases mid-gesture and the track snaps back. A low value (~0.2)
// commits before the snap settles, so the remove animation can start
// during the swipe.
const activateThreshold = 0.8;
const commitThreshold = 0.2;
// One inner observer per item, rooted at the track. Vertical scrolling of
// the outer list moves root and target together, so the callback only fires
// for the horizontal swipe.
const observer = new IntersectionObserver((entries, observer) => {
const entry = entries.at(-1);
const ratio = entry.intersectionRatio;
// Direction the user is swiping toward. A positive offset from the
// track's left edge means the content has been pulled right (left
// spacer revealed), so the leading icon is on the left.
const direction = (entry.boundingClientRect.x - entry.rootBounds.x) > 0
? 'left'
: 'right';
if (ratio < commitThreshold) {
// The IO entry's boundingClientRect is the last reliable measurement
// before the animation starts; reuse it for both the pre-collapse
// height and the slide-off translate distance.
removeItem(item, content, direction, entry);
viewportObserver.unobserve(item);
observer.disconnect();
return;
}
// Scale up the leading icon while the content is past the activate
// point; restore it at rest.
item.classList.toggle('is-activating', ratio < activateThreshold);
// Hold the previous direction at rest so the icon's exit animation
// finishes on the side the user was swiping toward.
if (entry.boundingClientRect.x !== entry.rootBounds.x) {
item.dataset.swipeDirection = direction;
}
}, {
root: track,
threshold: [commitThreshold, activateThreshold],
});
// Return the handle without starting observation; the outer viewport observer
// calls `observer.observe(content)` once the item is in view.
const handle = {observer, content};
swipeObservers.set(item, handle);
return handle;
}
async function removeItem(item, content, direction, entry) {
const opts = { duration: 300, easing: 'ease', fill: 'forwards' };
const rect = entry.boundingClientRect;
// Content's pixel offset from the track's left edge.
const x = rect.x - entry.rootBounds.x;
// Pixel distance the content needs to travel to be fully out of view.
const translate = direction === 'left'
? rect.width - x
: -(x + rect.width);
// Use a combination of CSS transitions (for declarative styles) and
// WAAPI animations (for computed values) to remove the element,
// then await the completion of all of them.
// Note: the content translate animation is important because the
// height-collapse animation can otherwise finish before the browser's
// smooth scroll-snap has scrolled the content fully off-screen.
item.classList.add('is-removing');
item.animate([{ height: `${rect.height}px` }, { height: '0px' }], opts);
content.animate([{ translate: `${translate}px` }], opts);
await Promise.allSettled(
item.getAnimations({ subtree: true }).map((a) => a.finished),
);
// Safari has a scroll-latching bug: removing the node while the swipe
// gesture's momentum is still resolving causes the next item (which
// slides up into this one's place) to inherit the scroll and
// immediately scroll itself off-screen. Detect Safari via
// `GestureEvent` (a Safari-only API) and defer the actual DOM removal
// until the gesture has fully settled. The 5s delay is conservative;
// anything longer than the momentum tail is fine. Mark the row inert
// so it can't be interacted with during the delay.
if (globalThis.GestureEvent) {
item.inert = true;
setTimeout(() => item.remove(), 5000);
} else {
item.remove();
}
}
function setupList(list) {
// Observe items already in the list.
for (const item of list.children) {
if (item.matches('.SwipeableList-item')) {
viewportObserver.observe(item);
}
}
// Pick up items added later (initial render after data loads, infinite
// scroll, server push). Removals don't need MutationObserver handling —
// the commit branch above already unobserves the item before removing it
// from the DOM.
new MutationObserver((mutations) => {
for (const mutation of mutations) {
for (const node of mutation.addedNodes) {
if (node.nodeType === Node.ELEMENT_NODE &&
node.matches('.SwipeableList-item')) {
viewportObserver.observe(node);
}
}
}
}).observe(list, { childList: true });
}
document.querySelectorAll('.SwipeableList').forEach(setupList);
שלב 5: משתמשים בפעולה ובתווית שמתאימות לתרחיש לדוגמה
בגרסאות אחרות, שאינן הסרה, רק הרכיבים החזותיים והגוף של ה-commit handler משתנים:
- העברה לארכיון: רקע ירוק/כחול, סמל של ארכיון, העברת הפריט לרשימת ארכיון במקום להסיר אותו.
- סימון כהודעה שנקראה: רקע מעומעם, סמל וי, עדכון מצב הפריט ועיבוד מחדש (או פשוט הסרת מחלקה
.unread). - טיפול בהמשך: רקע כחול, סמל שעון, הסתרה עד למועד שנבחר.
מנגנוני הגלילה, ההצמדה והתצפית לא השתנו.
פעולות שונות לכל כיוון החלקה
שורה אחת יכולה גם לחשוף שתי פעולות שונות: אחת להחלקה שמאלה ואחת להחלקה ימינה (למשל, "העברה לארכיון" מימין, "מחיקה" משמאל), כמו בהרבה אפליקציות דואר מקוריות. מנגנוני הגלילה, ההצמדה וזיהוי השמירה לא משתנים בכלל – הדבר היחיד שמשתנה הוא מה שקורה בזמן השמירה.
בשלב 4, ההסתעפות של ה-commit תמיד קוראת ל-removeItem(...). כדי לתמוך בשתי פעולות, בוחרים את ה-handler על סמך direction:
if (ratio < commitThreshold) {
const handler = direction === 'left' ? archiveItem : removeItem;
handler(item, content, direction, entry);
viewportObserver.unobserve(item);
observer.disconnect();
return;
}
הערה לגבי מתן שמות: הפונקציה removeItem נקראת על שם המקרה ההרסני, אבל הפונקציה שהיא מריצה (כיווץ גובה השורה, הזזת התוכן אל מחוץ למסך ואז הסרת הצומת) היא למעשה שגרה כללית של "השורה הזו הסתיימה, צריך להסיר אותה באמצעות אנימציה". הפעולה הזו פועלת באותו אופן גם כשמעבירים לארכיון, מסמנים כהודעה שכבר קראתי או מסמנים לטיפול בהמשך – בכל מקרה, השורה נעלמת מהרשימה הזו. אם ה-handlers לא באמת מסירים שום דבר (למשל, שניהם מעבירים את הפריט למקום אחר), צריך לשנות את השם למשהו ניטרלי כמו dismissItem כדי שהקוד ייקרא בצורה נכונה.
כדי להבחין בין שתי הפעולות באופן חזותי, צריך להגדיר צבע וסמל לכל כיוון בפריט ברשימה, ואז לצבוע את המסלול בשיפוע מפוצל ובשני הסמלים של הרכיבים המדומים מאותם משתנים.
.SwipeableList-item {
/* Action color + icon per swipe direction. `--left-*` is revealed
when the user swipes RIGHT (e.g., archive); `--right-*` is revealed
when the user swipes LEFT (e.g., delete). */
--left-action-color: hsl(140 50% 40%);
--left-action-icon: url("…archive svg…");
--right-action-color: hsl(0 65% 50%);
--right-action-icon: url("…trash svg…");
}
.SwipeableList-item.is-initialized .SwipeableList-track {
/* Split reveal: left half of the scrollable area gets the left-action
color, right half gets the right-action color. `background-attachment:
local` makes the gradient's positioning area the scrollable area
(3x the visible width), so the default size fills it and the 50% hard
stop lines up exactly with the midpoint of the resting content column.
The track's color also stays continuous behind the content as it
translates off, so the leading-direction color shows the whole way. */
background-image: linear-gradient(
to right,
var(--left-action-color) 50%,
var(--right-action-color) 50%
);
background-attachment: local;
}
/* Per-side icons read from the same variables. */
.SwipeableList-item.is-initialized::before { background-image: var(--left-action-icon); }
.SwipeableList-item.is-initialized::after { background-image: var(--right-action-icon); }
בהגדרה הזו, המרווחים לא צריכים צבע רקע משלהם (השיפוע של המסלול מטפל בחשיפה), כך שאפשר להשמיט את הכלל background-color ב-.SwipeableList-track::before, ::after מהשלב השני אם משתמשים בגרסה הזו עם הפעולה הכפולה.
שיטות מומלצות וטעויות נפוצות
- צריך להשתמש ב-
mandatory, לא ב-proximity. ב-proximity, השורה יכולה להישאר במצב של גלילה חלקית, כך שהרקע של הפעולה נשאר גלוי למחצה. - צריך להגדיר את
overscroll-behavior-x: noneבטראק. בלעדיו, החלקה מוגזמת עלולה להפעיל את תנועת הניווט לאחור של הדפדפן ב-iOS או ב-Android. - מומלץ להגדיר את ההתחייבות לסף לפני שההצמדה מסתיימת (למשל,
commitThreshold ≈ 0.2) במקום לחכות שהתוכן ייעלם לגמרי מהמסך. כך אנימציית ההסרה מתחילה במהלך התנועה, וזה מרגיש הרבה יותר מהיר מאשר לחכות שהתנועה תסתיים. - מומלץ להגדיר כל פריט בנפרד מאזור תצוגה חיצוני
IntersectionObserverבמקום להגדיר את כל הפריטים בטעינת הדף. כך אפשר להימנע מקריאת ערכים שתלויים בפריסה (clientWidthוכו') לפני שהפריטים עוברים רינדור, ולשמור על מספר צופים פעילים שפרופורציונלי למה שהמשתמש יכול לראות בפועל. - מומלץ להשתמש ב-
MutationObserverברשימה כשפריטים מתווספים באופן דינמי (רינדור ראשוני אחרי טעינת הנתונים, גלילה מתמשכת, דחיפת שרת). בלי הפונקציה הזו, פריטים שנוספים אחרי טעינת הדף לא יחוברו. - אל תסתמכו על
pointerdown/pointermove/pointerupכדי לבצע טרנספורמציה ידנית. אתם תאבדו את התנופה, את החזרה למצב הקודם, את הנגישות למקלדת ואת הטיפול בהפחתת התנועה שהדפדפן נותן לכם בחינם. - כן כדאי לאשר פעולות הרסניות כשצריך. לגבי "הסרה", כדאי להציג הודעה קצרה לביטול הפעולה אחרי שההחלקה מסתיימת. קל להפעיל את התנועה הזו בטעות.
- כן: חשוב לוודא שאפשר להתמקד בפס הגלילה, שהוא נגיש דרך המקלדת ושיש לו מאפיין חזותי שמאפשר להתמקד בו.
- כן מספקים חלופות נגישות לכל פעולה רלוונטית שמופעלת באמצעות החלקה (למשל, כפתור גלוי, תפריט הקשר או מצב עריכה).
אסטרטגיות חלופיות
כל התכונות החדשות יותר שנעשה בהן שימוש הן לא חלק מהותי מהחוויה, או שיש להן חלופות חזקות שאפשר להשתמש בהן באופן מהימן עכשיו.
חלופה ל-overscroll-behavior
אין צורך בברירת מחדל לתרחיש לדוגמה הזה. למרות שב-overscroll-behavior יש בעיית יכולת פעולה הדדית שמופיעה בקונטיינרים בלי גלישה, אפשר תמיד לגלול את הטראק כאן באופן אופקי (שלוש עמודות ברוחב מלא בתוך קונטיינר ברוחב של 100%), כך שהמאפיין פועל באופן עקבי בדפדפנים שונים ותנועת ההחלקה נכללת באופן מהימן.
חלופה ל-scrollbar-width
פסי גלילה מוסתרים הם שיפור חזותי, ולא המנגנון שמאפשר את פעולת ההחלקה להסרה. אם היעד של Baseline לא כולל את scrollbar-width, השורה עדיין נגללת, נצמדת, מזהה את השמירה ומוסרת בצורה נכונה. יכול להיות שבחוויה הלא נתמכת פשוט יופיע פס גלילה אופקי. אם המוצר שלכם דורש פסי גלילה מוסתרים בדפדפנים ישנים יותר שמבוססים על WebKit, אתם יכולים להוסיף כלל ::-webkit-scrollbar { display: none; } בהיקף צר למסלול ההחלקה.
חלופה ל-scroll-initial-target
אם יעד הבסיס לא כולל את scroll-initial-target, צריך לגלול את הטראק לתוכן באופן פרוגרמטי בתוך setupItem. זיהוי באמצעות CSS.supports:
// Hoist the feature detect so the conditional `ResizeObserver` below can be
// skipped entirely when the property is supported.
const needsScrollWorkaround = !CSS.supports('scroll-initial-target', 'nearest');
function setupItem(item) {
// ...existing setup from Step 4...
if (needsScrollWorkaround) {
track.scrollLeft = track.clientWidth;
}
// ...attach the inner IntersectionObserver, etc.
}
סדר הקריאות חשוב. הגלילה הפרוגרמטית חייבת לפעול:
- AFTER שמוסיפים את
.is-initializedלפריט ברשימה (ה-class הוא מה שהופך את הטראק לקונטיינר שאפשר לגלול; הגדרתscrollLeftברכיב שלא ניתן לגלול לא עושה כלום). - לפני שמצרפים את ה-
IntersectionObserverהפנימי משלב 4. אחרת, הגלילה הראשונית באמצעות קוד מעבר למרווח השמאלי תזוהה כ "החלקה" ותפעיל מיד את ה-commit handler.
הגדרת ההפעלה מהצופה החיצוני של אזור התצוגה (שלב 4) היא מה שהופך את זה לאמין: setupItem פועל אחרי שהפריט עובר רינדור, כך ש-track.clientWidth מחזיר ערך אמיתי ולא 0.
בדפדפנים מסוימים (במיוחד ב-Safari) מתבצע גם איפוס של מיקום הגלילה של מאגר ההצמדה בכל פעם שמשנים את גודל הטראק (הצגה או הסתרה של סרגל כתובות ה-URL, שינוי הגודל של אזור התצוגה, שאילתות מאגר וכו'). כדי להחיל מחדש את הגלילה, משתמשים ב-ResizeObserver בכל טראק. צריך להגביל את זה מאחורי אותה בדיקה של CSS.supports – כשיש תמיכה ב-scroll-initial-target, הדפדפן מטפל בעצמו בשחזור הגלילה בזמן שינוי הגודל.
const trackResizeObserver = needsScrollWorkaround
? new ResizeObserver((entries) => {
for (const entry of entries) {
entry.target.scrollLeft = entry.target.clientWidth;
}
})
: null;
function setupItem(item) {
// ...existing setup...
if (needsScrollWorkaround) {
track.scrollLeft = track.clientWidth;
trackResizeObserver.observe(track);
}
// ...attach the inner IntersectionObserver, etc.
}
צריך לבטל את המעקב אחרי הטראק לפני שהאנימציה של גובה השורה פועלת ב-removeItem, אחרת השינוי בגובה יפעיל מחדש את הקריאה החוזרת (callback) לשינוי הגודל במהלך ההסרה. מוסיפים את הקוד הבא לצד ה-viewportObserver.unobserve(item) הקיים בהסתעפות של ה-commit:
if (ratio < commitThreshold) {
removeItem(item, content, direction, entry);
viewportObserver.unobserve(item);
if (needsScrollWorkaround) trackResizeObserver.unobserve(track);
observer.disconnect();
return;
}