Skip to main content
196

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Web docs
Feedback

Skeleton

Reserves space during loading states.

FrameworksAstro · React · Elements

Registry commandlumen add Skeleton

InteractionNative markup

01

See it and copy it

Framework example

Choose Astro, React, or Elements to compare native usage against the shared visual output. Each example assumes the framework-level setup is already complete.

AstroCode target · live preview uses Astro
Loading profile
View Skeleton code

Framework usage

Switch targets to compare the adapter code. This live preview runs the Astro example. React and Elements use their own behavior APIs; complete the matching framework setup before copying an example.
astro
---
import { Skeleton, Stack, VisuallyHidden } from '@santi020k/lumen-astro'
---

{/* Announce a loading group once, with deterministic placeholder widths for server rendering. */}
<Stack aria-busy="true" role="status" gap="md">
  <VisuallyHidden>Loading profile</VisuallyHidden>
  <Stack direction="horizontal" gap="sm" align="center">
    <Skeleton shape="circle" width={40} />
    <Stack gap="xs" style="flex: 1;">
      <Skeleton shape="text" height="1rem" width="40%" />
      <Skeleton shape="text" width="80%" />
      <Skeleton animation="pulse" height={8} width="60%" />
    </Stack>
  </Stack>
</Stack>
<Skeleton aria-label="Loading article" height="6rem" />
Edit Skeleton in browser
02

Choose your target

Add this component

Choose the package for your runtime. All adapters share the Lumen stylesheet. Use the matching registry command when you want a local wrapper for that framework.

bash@santi020k/lumen-astro
pnpm add @santi020k/lumen-astro
pnpm add @santi020k/lumen-astro
bashAstro wrapper
lumen add Skeleton
lumen add Skeleton

API reference

Lumen-specific props and runtime attributes for the Astro primitive. Use the framework differences above and the copyable examples for React composition and Elements attributes; the public adapter types define their supported contracts.

AttributeValuesDefaultDescription
shape"rectangle" | "text" | "circle""rectangle"Text lines default to 0.75rem high; circles stay square from one width or height.
width, heightnumber | CSS length-Numbers are pixels. Strings accept lengths, percentages, and calc() or var() expressions; heights below the 1rem default are allowed.
animation"shimmer" | "pulse" | "none""shimmer"Pulse fades instead of sweeping; none is static. Reduced motion stops either animation.
aria-label, aria-labelledbystring-Makes the placeholder accessible and changes the default role to status.
aria-hiddenARIA boolean stringtrue unless labelledOverrides whether the loading placeholder is exposed to assistive technology.
roleARIA role"status" when labelledOverrides the generated status role.
class, classNamestring""Merges custom classes with the generated ui-* root classes.
...native attributesHTML attributes-Forwards standard attributes to the root element unless the component consumes them.

Web docsFull catalog