Source: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/image-views. This file is a structured index of that content, snapshot 2025-02-02. Apple HIG text and imagery are © Apple Inc.; this repository provides organization and cross-referencing for AI agent consumption only.
Image views
Best practices
Use an image view when the primary purpose of the view is simply to display an image.
If you want to display an icon in your interface, consider using a symbol or interface icon instead of an image view.
Content
Take care when overlaying text on images.
Aim to use a consistent size for all images in an animated sequence.
Platform considerations
macOS
If your app needs an editable image view, use an image well.
Use an image button instead of an image view to make a clickable image.
watchOS
Use SwiftUI to create animations when possible.
<!-- hig-doctor:canonical-footer -->
For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/image-views