CachedNetworkImage

一个轻量级、与SwiftUI兼容的库，用于高效地从网络URL加载、缓存和显示图像。CachedNetworkImage通过缓存图像来减少冗余的网络请求，并支持可自定义的占位符、错误处理和可选的调整大小，以提高性能。

特性

图像缓存：通过缓存下载的图像来避免不必要的网络请求。
可自定义的占位符：在图像加载时显示占位符。
错误处理：定义自定义视图来处理错误。
调整大小选项：可以选择下载高分辨率图像或调整大小以优化性能。
缓存过期：可配置缓存图像的生存时间 (TTL)。

安装

Swift Package Manager

在 Xcode 中，转到File > Add Packages。
输入此仓库的 URL。
选择该库并将其集成到您的项目中。

用法

基本示例

import SwiftUI
import CachedNetworkImage

struct ContentView: View {
    var body: some View {
        CachedNetworkImage(
            url: URL(string: "https://example.com/image.jpg"),
            imageView: { $0.resizable() },
            placeholder: { ProgressView() },
            errorView: { error in Text("Error: \(error.localizedDescription)") }
        )
        .scaledToFit()
        .frame(width: 200, height: 200)
    }
}

参数

参数	类型	描述
url	URL?	要加载的图像的 URL
highRes	Bool	是否在获取图像后缩小图像尺寸
cacheTime	TimeInterval	缓存图像的生存时间。默认为 1 小时
imageView	(Image) -> some View	当图像传递时使用的 ViewBuilder
placeholder	() -> some View	图像正在加载时使用的 ViewBuilder。默认为 ProgressView
errorView	(any Error) -> some View	发生错误时使用的 ViewBuilder

高级用法

自定义占位符和错误视图

CachedNetworkImage(
    url: URL(string: "https://example.com/image.jpg"),
    keepFullRes: false,
    cacheTime: 600, // 10 minutes
    imageView: { $0.resizable().aspectRatio(contentMode: .fit) },
    placeholder: {
        VStack {
            ProgressView()
            Text("Loading image...")
        }
    },
    errorView: { error in
        VStack {
            Image(systemName: "exclamationmark.triangle.fill")
                .foregroundColor(.red)
            Text("Failed to load image")
        }
    }
)

许可证

本项目采用 MIT 许可证。有关详细信息，请参阅 LICENSE 文件。

贡献

欢迎贡献！请按照以下步骤操作

Fork 该仓库。
创建一个包含您的功能或错误修复的新分支。
提交一个包含有关您的更改的详细信息的拉取请求