This is SVG animation presentation kit for iOS.
## Usage
You can display the svg image with animation.
**We are supportted two animation formats😎**
The format is below.
- Animation in SVG
- Animation in CSS
Usage is difference by the format.
### SVGView initialization
This is initialization SVGView for format 1 (Animation in SVG) usage.
```swift
SVGView(named: "svg-filename", animationOwner: .svg)
```
This is initialization SVGView for format 2 (Animation in CSS) usage.
```swift
SVGView(named: "svg-filename", animationOwner: .css, style: .cssFile(name: "css-filename"))
```
### Show in your ViewController
And, you initialized view, you have to do is only add view to parent view, and start animation like below.
```swift
class ViewController: UIViewController {
let svgView = SVGView(named: "image", animationOwner: .svg)
override func viewDidLoad() {
super.viewDidLoad()
view.addSubview(svgView)
svgView.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
svgView.centerXAnchor.constraint(equalTo: view.centerXAnchor),
svgView.centerYAnchor.constraint(equalTo: view.centerYAnchor),
svgView.widthAnchor.constraint(equalToConstant: 400),
svgView.heightAnchor.constraint(equalToConstant: 400),
])
svgView.startAnimation()
// svgView.stopAnimation() // Stop animation.
// svgView.isAnimate { [weak self] (value, error) in
// if let error = error {
// print(error)
// }
// guard let value = value else { return } // value means whether animation is moving.
// }
}
}
```
### Show in SwiftUI
SwiftUI support is available on iOS 14.0 and later.
```swift
import SwiftUI
import Elephant
struct ContentView: View {
@StateObject private var controller = AnimatedSVGViewController()
var body: some View {
VStack {
AnimatedSVGView(
named: "image",
animationOwner: .svg,
controller: controller
)
.frame(width: 240, height: 240)
HStack {
Button("Play") {
controller.startAnimation()
}
Button("Pause") {
controller.stopAnimation()
}
}
}
}
}
```
## Requirements
- Xcode 26.4
- Swift 6.0 package tools
- iOS 14.0+
## Installation
### [Swift package manager](https://github.com/apple/swift-package-manager)
Add the following to the dependencies of your Package.swift:
``` swift
dependencies: [
.package(url: "https://github.com/s2mr/Elephant.git", from: "Elephant version"),
]
```
### [CocoaPods](https://cocoapods.org)
Add this to `Podfile`
```ruby
pod 'Elephant'
```
```bash
$ pod install
```
## Author
[Kazumasa Shimomura](https://www.kazuringo.xyz)
## License
Elephant is available under the Apache v2. See the LICENSE file for more info.
[](https://app.fossa.io/projects/git%2Bgithub.com%2Fs2mr%2FElephant?ref=badge_large)
## Star History