When to use it
Use for product imagery that needs shared fitting, aspect ratio, radius, and labeling. Keep decoding, caching, network policy, placeholders, retries, and optimizer behavior in the application or platform loader.
Data displayApple
Image
Present native images with shared fit, ratio, radius, and accessibility behavior.
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 TV · tvOS 16+Apple Vision · visionOS 1+Apple Watch · watchOS 9+
Native example
Use Image
Use for product imagery that needs shared fitting, aspect ratio, radius, and labeling. Keep decoding, caching, network policy, placeholders, retries, and optimizer behavior in the application or platform loader.
LumenImage(
aspectRatio: 16 / 9,
fit: .cover,
label: "Mountain valley at sunrise"
) {
Image("mountain-valley").resizable()
}Reference
Public API
The primary shared and platform-specific options exposed by LumenImage.
| API | Values or type | Default | Description |
|---|---|---|---|
| content | Native image source or content | Required | Supplies image pixels through the platform-native delivery path. |
| fit | contain · cover | cover | Controls how the image fits its available bounds. |
| aspectRatio | CGFloat? | nil | Reserves a positive finite width-to-height ratio when provided. |
| radius | none · sm · md · lg · full | lg | Clips the image with a shared semantic corner radius. |
| label | String? | nil | Names meaningful imagery; omit only for decorative images. |
Native behavior
Design and accessibility
Accessibility
Images are decorative when their label is absent; a label exposes the complete image as one native accessibility element.
Shared component