SwiftUI Image

显示图像的视图
iOS 13.0+iPadOS 13.0+macOS 10.15+Mac Catalyst 13.0+tvOS 13.0+watchOS 6.0+

当您想将图像添加到您的 SwiftUI 应用程序时，请使用 Image 实例。 您可以从许多来源创建图像：

  • 应用资源库或捆绑包中的图像文件。 支持的类型包括 PNG、JPEG、HEIC 等。
  • 特定于平台的图像类型的实例，例如 UIImage 和 NSImage。
  • 存储在 Core Graphics CGImage 实例中的位图。
  • SF 符号集中的系统图形。

以下示例展示了如何从应用程序的资源库或捆绑包中加载图像并对其进行缩放以适应其容器：

Image("Landscape_4")
    .resizable()
    .aspectRatio(contentMode: .fit)
Text("Water wheel")
SwfitUI image sample1

您可以使用 Image 类型的方法以及标准视图修饰符来调整图像的大小以适合您的应用程序界面。 在这里，Image 类型的 resizable(capInsets:resizingMode:) 方法缩放图像以适应当前视图。 然后， aspectRatio(_:contentMode:) 视图修改器调整此调整大小行为以保持图像的原始纵横比，而不是独立缩放 x 轴和 y 轴以填充视图的所有四个边。 将图像放入可用空间一文展示了如何对不同大小的图像实例应用缩放、裁剪和平铺。

图像是后期绑定令牌，系统仅在即将在环境中使用图像时才解析其实际值。

使图像可访问

要将图像用作控件，请使用带有标签参数的初始化程序之一。 这允许系统的可访问性框架将标签用作使用 VoiceOver 等功能的用户的控件名称。 对于仅出于美学原因而存在的图像，请使用带有装饰参数的初始化程序； 无障碍系统会忽略这些图像。