Skip to content

Internal ID software / Status and waiting

Skeleton

A placeholder with the shape of the content that has not arrived yet.

Not drawn in Figma: built only from the tokens, for internal ID software. In code: components/software/waiting.tsx. From the old system: Skeleton and SkeletonText in @id-identity-as/ui.

Example

import { Skeleton, SkeletonText } from '@/components/software/waiting';

<div aria-busy="true">
  <Skeleton className="h-section-1 w-full" />
  <SkeletonText lines={3} />
</div>

Props

PropTypeDefaultWhat it does
classNamestringOn Skeleton: the size of the block, with token utilities such as "h-section-1 w-full".
linesnumber3On SkeletonText: how many lines the text will take. The last runs short.

Do

  • Build the shape of the real content out of several skeletons.
  • Set aria-busy="true" on the region that will receive the content.

Do not

  • Do not drop in one grey box for a whole page. A placeholder of the wrong size only postpones the jump.
  • Do not show a skeleton for a wait under a second.

Accessibility

  • Hidden from screen readers; the region around it carries aria-busy.
  • The pulse stops for a reader who asks for less motion.

Tokens it uses

  • color.border.default
  • radius.sm
  • space.inline.2
  • space.inline.3