FeedbackApple

Skeleton

Represent loading text, rectangles, and circles with quiet semantic placeholders.

Public APILumenSkeletonApple / SwiftUISwift product: LumenUI

Apple availability

Supported native targets

Import LumenUI in the target that uses this component. iPad support follows the iOS package baseline and uses native iPad layout behavior.

iPhone · iOS 16+iPad · iPadOS 16+Mac · macOS 13+Apple Vision · visionOS 1+

Native example

Use Skeleton

Use several decorative shapes inside one labeled loading region, or label a single skeleton when it is the only loading indicator. Do not announce every placeholder line.

Skeleton rendered in the iPhone simulator Lumen playground — Verified runtime captureiPhone simulator

LumenSkeleton(
    height: 16,
    label: "Loading profile"
)

Reference

Public API

The primary shared and platform-specific options exposed by LumenSkeleton.

API	Values or type	Default	Description
shape	`text · rectangle · circle`	`text`	Selects the placeholder geometry.
width	`CGFloat?`	`Fill width`	Controls native width; circles use their height when omitted.
height	`CGFloat`	`16`	Provides a positive finite height; invalid values normalize to 16.
label	`String?`	`nil`	Exposes an indeterminate loading state instead of decorative content.

Native behavior

Design and accessibility

When to use it

Use several decorative shapes inside one labeled loading region, or label a single skeleton when it is the only loading indicator. Do not announce every placeholder line.

Accessibility

The placeholder is decorative by default. A concise label exposes one indeterminate loading state when surrounding content does not already do so.

Shared component

Available on other platforms

React Native Android / Compose