6 图像

原文链接: https://developer.apple.com/documentation/swiftui/images

6 图像

在应用界面中添加图像和符号。

概述

用 Image 视图显示图像，包括 SF Symbols、存储在资源目录中的图像，以及存储在磁盘上的图像。

对于获取需要时间的图像——例如从网络端点加载图像——请用 AsyncImage 异步加载。你可以让该视图在加载期间显示占位内容。

关于设计指导，参见 Human Interface Guidelines 中的图像。

创建图像

• Image —— 显示图像的视图。

配置图像

• 让图像适配可用空间 —— 通过应用视图修饰符，调整应用界面中图像的尺寸与形状。
• imageScale(_:) —— 按可用的相对尺寸之一（包括小、中、大图像尺寸）缩放视图内的图像。
• imageScale —— 该环境的图像缩放比例。
• Image.Scale —— 相对于文本应用于矢量图像的缩放比例。
• Image.Orientation —— 图像的方向。
• Image.ResizingMode —— SwiftUI 用来调整图像大小以适配其容器视图的模式。

异步加载图像

• AsyncImage —— 异步加载并显示图像的视图。
• AsyncImagePhase —— 异步图像加载操作的当前阶段。

设置符号变体

• symbolVariant(_:) —— 让视图中的符号显示某个特定变体。
• symbolVariants —— 该环境中使用的符号变体。
• SymbolVariants —— 符号的变体。

管理符号效果

• symbolEffect(_:options:isActive:) —— 返回一个添加了符号效果的新视图。
• symbolEffect(_:options:value:) —— 返回一个添加了符号效果的新视图。
• symbolEffectsRemoved(_:) —— 返回一个新视图，其继承的符号图像效果被移除或保持不变。
• SymbolEffectTransition —— 创建一个过渡，把出现、消失、绘制或擦除的符号动画应用到被插入或移除的视图层级中的符号图像上。

设置符号渲染模式

• symbolRenderingMode(_:) —— 设置该视图中符号图像的渲染模式。
• symbolRenderingMode —— 当前的符号渲染模式；为 nil 表示模式会根据当前图像和前景样式自动选择。
• SymbolRenderingMode —— 符号渲染模式。
• SymbolColorRenderingMode —— 填充符号图像中某一层的方法。
• SymbolVariableValueMode —— 渲染符号图像变量值的方法。

从视图渲染图像

• ImageRenderer —— 从 SwiftUI 视图创建图像的对象。