在SwiftUI中绽放的庆贺魔法：ConfettiSwiftUI

在SwiftUI中绽放的庆贺魔法：ConfettiSwiftUI

定制化的SwiftUI庆祝动画库

ConfettiSwiftUI 是一个专为SwiftUI设计的开源库，用于创建和定制绚烂的彩纸屑动画效果。这个库不仅能够提供基础的彩纸屑形状，还能注入自定义表情符号，让您的应用在庆祝时充满惊喜。

功能概览

• 纯SwiftUI实现
• 选择默认形状或输入文本表情符号
• 配置爆炸半径和角度
• 一次状态变化触发多次动画

示例

下面是一些预设动画示例：

支持与贡献

如果你喜欢这个项目，请不要忘了给它点个“🌟”星标支持。

如果您想支持作者的工作，可以查看GitHub页面中的捐赠信息。

安装指南

Swift Package Manager

通过Swift Package Manager在Xcode 12及以上版本添加依赖：

https://github.com/simibac/ConfettiSwiftUI.git, :branch="master"

手动安装

将Sources/ConfettiSwiftUI文件夹手动添加到你的Xcode项目中，并确保勾选了"Copy items if needed"和"Create groups"。

系统要求

• iOS 14.0+ 或 macOS 11+
• Swift 5+

使用方法

首先，在需要使用ConfettiSwiftUI的Swift文件中导入库：

import ConfettiSwiftUI
import SwiftUI

然后，设置一个整型状态变量，用于触发动画，每次该变量改变时会启动新的动画：

struct ContentView: View {
    
    @State private var counter: Int = 0
    
    var body: some View {
        Button("🎉") {
            counter += 1
        }
        .confettiCannon(counter: $counter)
    }
}

参数配置

了解更多参数设置详情，如num, confettis, colors, confettiSize, rainHeight等，请参见项目的完整README。

此外，还有配置器应用程序带实时预览功能，可帮助您创建理想的动画效果或获取灵感。

特色亮点

• 易集成：SwiftUI原生，无需额外依赖。
• 高度定制化：从颜色、形状到动画重复次数，所有细节都可自由调整。
• 动态实时预览：附带的应用程序允许您直接看到配置更改的效果。
• 广泛兼容性：支持iOS和macOS平台。

立即把ConfettiSwiftUI加入到您的项目中，为每一次特别时刻增添独特的庆祝气息吧！