LayoutAndroid

Surface

Compose content on semantic native backgrounds with shared padding and radius roles.

Public APILumenSurfaceAndroid / Compose

Native example

Use Surface

Use surfaces to express hierarchy through semantic canvas, surface, muted, and strong roles. Do not hardcode a parallel set of background colors.

LumenSurface(
    tone = LumenSurfaceTone.Muted,
    padding = LumenSurfacePadding.Lg
) {
    LumenText("Workspace")
}

Reference

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

API	Values or type	Default	Description
tone	`canvas · surface · muted · strong`	`surface`	Selects the semantic background role.
padding	`none · sm · md · lg`	`md`	Applies generated platform spacing.
radius	`none · sm · md · lg`	`md`	Applies a generated corner radius.
modifier	`Native composition API`	`—`	Composes or lays out the surface with native APIs.

Native behavior

Use surfaces to express hierarchy through semantic canvas, surface, muted, and strong roles. Do not hardcode a parallel set of background colors.

A surface does not add an accessibility role by itself. Descendant controls and content retain their native semantics.

Shared component