.resizable()的用法

305 阅读1分钟

在 Swift 中,resizable()SwiftUI 框架中的一个修饰符(modifier),主要用于调整 Image(图片) 的尺寸和缩放行为。


作用

  • 默认情况下,SwiftUI 的 Image 会以原始尺寸显示。
  • 调用 .resizable() 后,图片会变得可伸缩,允许填充父视图或按需调整大小(类似 scaleToFillscaleToFit)。

基本用法

Image("yourImageName")  // 加载图片
    .resizable()       // 允许调整大小
    .frame(width: 200, height: 200) // 设置目标尺寸

常用搭配修饰符

  1. aspectRatio
    控制缩放比例(保持宽高比):

    .resizable()
    .aspectRatio(contentMode: .fit) // 保持比例,适应视图(可能留白)
    // 或
    .aspectRatio(contentMode: .fill) // 保持比例,填满视图(可能裁剪)
    
  2. scaledToFit() / scaledToFill()
    快捷方法,等效于 aspectRatio 的两种模式:

    .resizable()
    .scaledToFit() // 等同于 .aspectRatio(contentMode: .fit)
    

示例

import SwiftUI

struct ContentView: View {
    var body: some View {
        VStack {
            // 原始图片(固定尺寸)
            Image("dog")
                .border(Color.red) // 标记边界
            
            // 可调整大小的图片
            Image("dog")
                .resizable()
                .frame(width: 100, height: 100)
            
            // 保持比例并填满宽度
            Image("dog")
                .resizable()
                .aspectRatio(contentMode: .fit)
                .frame(width: 200)
        }
    }
}

注意事项

  1. 必须调用 resizable()
    如果直接使用 .frame() 而不调用 .resizable(),图片不会缩放。

  2. 矢量图 vs 位图

    • 矢量图(如 PDF)可无损缩放。
    • 位图(如 PNG、JPG)可能会因放大而模糊。
  3. 性能影响
    频繁调整大图片的尺寸可能会影响性能,建议预处理图片资源。


其他上下文

  • 如果是 UIKit(非 SwiftUI),类似的功能通过 UIImageViewcontentMode 实现(如 .scaleAspectFit)。
  • 在游戏开发(如 SpriteKit)中,resizable 可能用于纹理贴图的平铺模式。

如果有其他具体场景,可以进一步说明!