SPConfetti
A simple solution to show the confetti to the user. Smoothly starts and stops. Allow set multiply diffrent particles at once.
You can change shapes and switch between styles. It is possible to change the size and position of emitter. Ready use arc, star, heart triangle shapes. You can set custom shapes with your image.
If you like the project, don't forget to put star ★
Check out my other libraries:
Navigate
Installation
Ready for use on iOS & tvOS 12+. Works with Swift 5+. Required Xcode 12.0 and higher.
Swift Package Manager
The Swift Package Manager is a tool for managing the distribution of Swift code. It’s integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies.
To integrate SPConfetti into your Xcode project using Xcode 12, specify it in File > Swift Packages > Add Package Dependency...:
https://github.com/ivanvorobei/SPConfetti
CocoaPods:
CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate SPConfetti into your Xcode project using CocoaPods, specify it in your Podfile:
pod 'SPConfetti'
Manually
If you prefer not to use any of dependency managers, you can integrate SPConfetti into your project manually. Put Sources/SPConfetti folder in your Xcode project. Make sure to enable Copy items if needed and Create groups.
Quick Start
For easy start confetti animation call this:
// For start animation
SPConfetti.startAnimating(.centerWidthToDown, particles: [.triangle, .arc])
// For stop animation
SPConfetti.stopAnimating()
If you want stop animation automatically in time, use it:
SPConfetti.startAnimating(.centerWidthToDown, particles: [.triangle, .arc], duration: 3)
You can manage by view SPConfettiView with custom layout if need.
Customise
Animation
For change emitter size and direction, use animation property. Now available next animations:
enum SPConfettiAnimation {
case fullWidthToDown
case fullWidthToUp
case centerWidthToDown
case centerWidthToUp
}
To change animation:
confettiView.animation = .centerWidthToDown
Particles
You can customise particles style and animation config.
// Available arc, star, heart, circle, triangle and polygon.
// You can set many styles particles.
confettiView.particles = [.star]
For set custom image use custom case:
confettiView.particles = [.custom(yourImage)]
Shared Configuration
You can set global values with configuration object. It will apply for all next configuration of confetti view by default.
// For example, available more
SPConfettiConfiguration.particles = [.star]
SPConfettiConfiguration.particlesConfig.colors = [.systemRed, .sytemBlue]
Delegate
For get notification about events, set delegate for view and implement protocol SPConfettiDelegate:
confettiView.delegate = self
Looks at protocol:
protocol SPConfettiDelegate: AnyObject {
// Caling when animation start.
func confettiDidStartAnimating()
// Caling when animation stop.
func confettiDidStopAnimating()
// Caling when animation end.
// May calling after `confettiDidStopAnimating`,
// becouse after stop emitting particles existing particles
// still available.
func confettiDidEndAnimating()
}
Other Projects
I love being helpful. Here I have provided a list of libraries that I keep up to date. For see video previews of libraries without install open opensource.ivanvorobei.by website.
I have libraries with native interface and managing permissions. Also available pack of useful extensions for boost your development process.
Russian Community
Веду каналы об iOS разработке. Один с туториалами и новостями, другой с обзором библиотек.
Со сложной задачей помогут в чате.
Видео-туториалы выклыдываю на YouTube:
650 Jan 2, 2023
9 Nov 23, 2022
30 Jan 4, 2023
0 Mar 15, 2022
17 Nov 28, 2022
0 Nov 27, 2021
1 Apr 2, 2022
22 Sep 30, 2022
1.8k Jan 6, 2023
1 Apr 16, 2022
0 Feb 4, 2022
12 Oct 19, 2022
22 Nov 14, 2022
16 Dec 21, 2022
2 Aug 17, 2022
0 Dec 29, 2021
56 Oct 4, 2022
33.7k Dec 30, 2022
25 Feb 10, 2022