Skip to main content
161

Search Lumen

Find components, APIs, guides, and recipes.

GitHub
Apple docs
Data displayApple

Wearable metric

Present one at-a-glance wearable label, value, and optional detail.

Public APILumenWatchMetricApple / 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.

Apple Watch · watchOS 9+

Native example

Use Wearable metric

Use for one high-priority value with a short label. Avoid dashboard grids that overload small round screens.

Wearable metric rendered in the watchOS simulator Lumen playground
Verified runtime capturewatchOS simulator
swift
LumenWatchMetric("Duration", value: elapsed, tone: .brand)

Reference

Public API

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

APIValues or typeDefaultDescription
labelNative localized textRequiredNames the metric.
valueStringRequiredProvides the formatted value.
detailOptional native localized textnilAdds brief supporting context.
tonebrand · accent · success · warning · danger · neutralneutralApplies semantic value color.

Native behavior

Design and accessibility

When to use it

Use for one high-priority value with a short label. Avoid dashboard grids that overload small round screens.

Accessibility

Combines label, value, and optional detail into one concise readable metric.

Shared component

Available on other platforms

Android / Compose
Apple docsSwiftUI package