Image displays a bitmap, system symbol, or inline SVG from a URL or an asset name. Video plays remote or local video with autoplay, muting, looping, and controls options. Model3D renders an interactive 3D model with optional camera controls and auto-rotation.
Image
Displays an image from a URL, asset name, system icon, or inline SVG.ImageProps type is a union requiring exactly one image source, plus an optional contentMode:
Image component returns an extended Image interface with image-specific chainable methods in addition to the standard Component modifiers:
Makes the image resizable so it fills its frame. Required for
.frame() to affect image size.Controls how the image is rendered.
"original" preserves the image’s original colors; "template" renders as a single color using the current foreground style.Sets the interpolation quality for scaled images.
Enables or disables antialiasing on image edges. Defaults to
true if called without arguments.Sets how multi-layer system symbols are rendered.
No renderer implements
.renderingMode(), .interpolation(), .antialiased(), .symbolRenderingMode(), or .imageScale() yet. Calling them has no effect.Video
Plays video from a URL or an asset with configurable playback options.VideoProps type requires either a url or video source, plus optional playback settings:
An asset id. Only the web renderer in Studio resolves it. iOS does not play a
video string, and on Android a Video without url throws. To play an asset on every platform, pass its URL to url.Model3D
Displays an interactive 3D model from a URL.URL of a
.usdz file. The web renderer passes it to <model-viewer> for AR Quick Look in Safari on iOS. The iOS and Android renderers ignore it.The iOS renderer loads
.glb and .gltf files, not .usdz. Auto-rotate is useful for product showcases where user interaction is not required.See also
- Text — captions and overlays for media
- Markdown — render rich text alongside media
- ZStack — overlay text or controls onto media
- LinearGradient — readability gradient over images