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.

Skeleton

Skeleton

Grey shapes in the exact layout of the content that is loading, with a soft shine passing over them. When the data lands, nothing moves.

Usage

Use it when

  • A view loads data and you already know its layout: a list of courses, a profile header, a dashboard of cards.
  • The loading state of the four data states (loading, empty, error, loaded) for any data view.

Use something else when

  • A short wait with no known layout, or inside a row or control: use Spinner.
  • A button is running its action: use Button.
  • Measurable work (upload, export): use Progress bar.
  • Long work of unknown length where elapsed time matters: use Thinking.
  • The data loaded and there is nothing: use Empty state.

Where it goes. In place of the real content, in the same container, with the same sizes, gaps and radii: avatar circles where avatars go, two text lines where a title and subtitle go. On phones and wide screens alike; show as many placeholder rows as fit the first screen, not more.

Examples

List rowsA square icon and two lines, the same as the loaded row.
<div class="list" style="max-width: 420px;" aria-busy="true" aria-label="Loading courses">
  <div class="lrow" aria-hidden="true"><div class="skel" style="width: 30px; height: 30px;"></div><div class="lrow__body"><div class="skel" style="height: 12px; width: 60%;"></div><div class="skel" style="height: 10px; width: 35%; margin-top: 8px;"></div></div></div>
  <div class="lrow" aria-hidden="true"><div class="skel" style="width: 30px; height: 30px;"></div><div class="lrow__body"><div class="skel" style="height: 12px; width: 48%;"></div><div class="skel" style="height: 10px; width: 30%; margin-top: 8px;"></div></div></div>
  <div class="lrow" aria-hidden="true"><div class="skel" style="width: 30px; height: 30px;"></div><div class="lrow__body"><div class="skel" style="height: 12px; width: 66%;"></div><div class="skel" style="height: 10px; width: 40%; margin-top: 8px;"></div></div></div>
</div>
Profile headerCircles for avatars, wider bars for headings.
<div class="card" style="max-width: 360px;" aria-busy="true" aria-label="Loading profile">
  <div class="docs-row" aria-hidden="true"><div class="skel" style="width: 56px; height: 56px; border-radius: 50%;"></div><div style="flex: 1;"><div class="skel" style="height: 16px; width: 70%;"></div><div class="skel" style="height: 12px; width: 45%; margin-top: 10px;"></div></div></div>
  <div class="skel" style="height: 12px; width: 100%; margin-top: 20px;" aria-hidden="true"></div>
  <div class="skel" style="height: 12px; width: 82%; margin-top: 8px;" aria-hidden="true"></div>
</div>
Loading, then loadedPress the button: the real row replaces the placeholder in the same box, so nothing shifts.
<div class="list" aria-busy="true" aria-label="Loading courses">
  <div class="lrow" aria-hidden="true">
    <div class="skel" style="width: 30px; height: 30px;"></div>
    <div class="lrow__body">
      <div class="skel" style="height: 12px; width: 55%;"></div>
      <div class="skel" style="height: 10px; width: 30%; margin-top: 8px;"></div>
    </div>
  </div>
</div>

Anatomy

PartWhat it is
.skelRequired. One placeholder shape: --bg-skeleton with an 8 px radius. Size it inline (width, height, radius) to match the real element.
.skel::afterThe shine: a light band that crosses every 1.6 s. Automatic.
containerThe real container (a .list, a .card) with aria-busy="true" while loading.

States

StateHow
loadingaria-busy="true" on the container, .skel shapes inside it marked aria-hidden.
loadedReplace the shapes with the content in the same container and remove aria-busy.

Motion and microinteractions

  • The shine is a gradient band moving with transform: translateX() from -100 % to 100 % over 1.6 s on --ease-inout, infinite. Only transform animates.
  • Swap to the real content directly, or with a --d-fast (160 ms) fade; never slide content in over the skeleton.
  • Reduced motion: the animation runs once in 1 ms, so the shapes are static grey.
  • Do not show a skeleton for loads under about 300 ms; render nothing, then the content.

Accessibility

  • The shapes say nothing: aria-hidden="true" on each placeholder row.
  • Mark the region aria-busy="true" and give it a name ("Loading courses") so screen reader users know something is coming.
  • When the content arrives, it is read in the normal flow; do not announce every row.

Do and don't

Do

  • Copy the real layout: the same sizes, gaps and radii.
  • Show only what fits the first screen.
  • Vary line widths a little, like real text.

Don't

  • Use a generic block that does not match the content; the jump on load defeats the purpose.
  • Put a spinner on top of a skeleton.
  • Keep a skeleton when loading failed; show the error state with a retry.