Community project. This is not an official government website.

Run by volunteers. Lampung Design System is built by an open source community. No government agency runs or endorses it.

Official services use go.id. Government websites in Indonesia end in .go.id. Never enter your national ID number on a site you are unsure of.

List stagger

List stagger

When a group of items arrives at once, each one follows the one before by 35 ms, fading in from a 4 px blur and a 4 px rise. The whole cascade stays under 400 ms, so the list reads as one arrival with a direction, never as a slow parade.

Usage

Use it when

  • Search results or filter results arriving after the person asked for them.
  • New notifications or messages that came in together while the panel was closed.
  • The cards of a dashboard on first load of the session.
  • The items of a menu or sheet that opened with a list built on the fly (only if they were not already rendered).

Use something else when

  • One item joining an existing list: use Enter and exit.
  • Figures and illustrations appearing as the page scrolls: use Reveal on scroll. It has its own 30 ms stagger, capped at the fourth item.
  • The same list re-rendering after a sort or a small change: use Motion principles. Do not animate it; just update.
  • Content still loading: use Skeleton.
  • A long chat history opening: use Chat layout. Never stagger history.

Where it goes. On the direct children of the list that arrived: .lrow rows, .cards and .kpi cards in an auto-grid, .file-rows. Never on the list container and never on nested parts.

Examples

Search results arrivingResults cascade top to bottom: the first one is readable at once, the last has arrived by 380 ms. Press Replay.
<!-- The system has no stagger class yet: the keyframe and tokens are the contract. -->
<a class="lrow" href="…" style="animation: lds-blur-in var(--d-standard) var(--ease-enter) both; animation-delay: 0ms;">…</a>
<a class="lrow" href="…" style="animation: lds-blur-in var(--d-standard) var(--ease-enter) both; animation-delay: 35ms;">…</a>
<!-- delay = min(index, 4) × 35 ms: everything after the fifth item arrives with the fifth -->
Notifications that came in togetherOpening the panel after a morning away: three new notifications arrive in order, newest first.
APAna Putri commented on your lab report2 minutes ago
RSRizal Siregar shared Week 6 notes40 minutes ago
BKGrades for Quiz 3 are published1 hour ago
<div class="list" style="width: 100%; max-width: 440px;">
  <div class="lrow" style="animation: lds-blur-in var(--d-standard) var(--ease-enter) both; animation-delay: 0ms;"><span class="avatar" style="--size: 36px;">AP</span><span class="lrow__body"><span class="lrow__title">Ana Putri commented on your lab report</span><span class="lrow__sub">2 minutes ago</span></span></div>
  <div class="lrow" style="animation: lds-blur-in var(--d-standard) var(--ease-enter) both; animation-delay: 35ms;"><span class="avatar avatar--gray" style="--size: 36px;">RS</span><span class="lrow__body"><span class="lrow__title">Rizal Siregar shared Week 6 notes</span><span class="lrow__sub">40 minutes ago</span></span></div>
  <div class="lrow" style="animation: lds-blur-in var(--d-standard) var(--ease-enter) both; animation-delay: 70ms;"><span class="avatar avatar--gray" style="--size: 36px;">BK</span><span class="lrow__body"><span class="lrow__title">Grades for Quiz 3 are published</span><span class="lrow__sub">1 hour ago</span></span></div>
</div>
Dashboard cards on first loadKPI cards arrive left to right in reading order. Do this on the first load of a session only; coming back to the page shows them at once.
Classes today
3
Due this week
4
Average grade
3.62
Absences
1
<div class="auto-grid" style="--min: 150px; width: 100%;">
  <article class="kpi" style="animation: lds-blur-in var(--d-standard) var(--ease-enter) both; animation-delay: 0ms;"><div class="kpi__head"><span class="kpi__label">Classes today</span></div><div class="kpi__value">3</div></article>
  <article class="kpi" style="animation: lds-blur-in var(--d-standard) var(--ease-enter) both; animation-delay: 35ms;"><div class="kpi__head"><span class="kpi__label">Due this week</span></div><div class="kpi__value">4</div></article>
  <article class="kpi" style="animation: lds-blur-in var(--d-standard) var(--ease-enter) both; animation-delay: 70ms;"><div class="kpi__head"><span class="kpi__label">Average grade</span></div><div class="kpi__value">3.62</div></article>
  <article class="kpi" style="animation: lds-blur-in var(--d-standard) var(--ease-enter) both; animation-delay: 105ms;"><div class="kpi__head"><span class="kpi__label">Absences</span></div><div class="kpi__value">1</div></article>
</div>

Motion and microinteractions

  • Each item: lds-blur-in (from translateY(4px), blur(4px), transparent) over --d-standard (240 ms) on --ease-enter, with animation-fill-mode: both so it is hidden until its turn.
  • Delay: min(index, 4) × 35 ms. The fifth and later items share the 140 ms delay, so the cascade ends by 380 ms however long the list is.
  • Order follows reading order: top to bottom in lists, left to right then down in grids. Newest first in feeds.
  • Plays once on arrival. Keyframes are fine here because an arrival is not reversed; if the list is replaced again mid-cascade, render the new items and let their own cascade start, do not wait.
  • Never stagger exits: items leave together in 180 ms on --ease-exit, or close their space with height expand.
  • Reduced motion: the animation runs in 1 ms, so items simply appear together.

Accessibility

  • Content is in the DOM from the start; only its painting is delayed, so screen readers and find-in-page see it immediately.
  • Announce the result count once ("5 results") in a polite live region; the motion announces nothing.
  • Keep the total under 400 ms so keyboard users are never waiting to reach an item.

Do and don't

Do

  • Stagger only things that arrived together because the person asked.
  • Cap the delay at the fifth item.
  • Use the same keyframe and tokens as the system (lds-blur-in, --d-standard, --ease-enter).

Don't

  • Stagger every list on every render, or re-stagger after a sort.
  • Use delays longer than 35 ms or a cascade longer than 400 ms.
  • Stagger exits or nested children inside each item.

Behavior and code

Plain HTML. None: it is CSS on the items. There is no system class or attribute for it yet, so set the animation inline (or in a framework style prop) as shown. For figures that appear while scrolling, use data-lds-reveal with --i instead.