{"id":2234,"url":"https://github.com/ninjaprox/NVActivityIndicatorView","last_synced_at":"2025-08-06T15:30:37.872Z","repository":{"id":35193822,"uuid":"39452201","full_name":"ninjaprox/NVActivityIndicatorView","owner":"ninjaprox","description":"A collection of awesome loading animations","archived":false,"fork":false,"pushed_at":"2024-04-17T15:35:05.000Z","size":6224,"stargazers_count":10630,"open_issues_count":14,"forks_count":1164,"subscribers_count":203,"default_branch":"master","last_synced_at":"2024-10-29T10:53:32.872Z","etag":null,"topics":["animation","carthage","cocoapods","ios","ios-animation","ios-lib","ios-swift","ios-thirdparty","ios-ui","loader","loaders","loading-animations","swift","swift-library"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ninjaprox.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-07-21T15:01:17.000Z","updated_at":"2024-10-29T06:33:30.000Z","dependencies_parsed_at":"2022-07-15T21:17:10.635Z","dependency_job_id":"50817e79-c552-453d-9ba2-f55a3d74bd95","html_url":"https://github.com/ninjaprox/NVActivityIndicatorView","commit_stats":{"total_commits":509,"total_committers":49,"mean_commits":"10.387755102040817","dds":"0.14341846758349708","last_synced_commit":"e36ea122fa831ac587f82dbc3fb3af37a6de35fb"},"previous_names":[],"tags_count":48,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ninjaprox%2FNVActivityIndicatorView","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ninjaprox%2FNVActivityIndicatorView/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ninjaprox%2FNVActivityIndicatorView/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ninjaprox%2FNVActivityIndicatorView/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ninjaprox","download_url":"https://codeload.github.com/ninjaprox/NVActivityIndicatorView/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228915461,"owners_count":17991409,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["animation","carthage","cocoapods","ios","ios-animation","ios-lib","ios-swift","ios-thirdparty","ios-ui","loader","loaders","loading-animations","swift","swift-library"],"created_at":"2024-01-05T20:16:08.404Z","updated_at":"2024-12-09T15:30:51.823Z","avatar_url":"https://github.com/ninjaprox.png","language":"Swift","readme":"# NVActivityIndicatorView\n\n[![Build Status](https://github.com/ninjaprox/NVActivityIndicatorView/actions/workflows/ios.yml/badge.svg?event=push)](https://github.com/ninjaprox/NVActivityIndicatorView/actions/workflows/ios.yml)\n[![Cocoapods Compatible](https://img.shields.io/cocoapods/v/NVActivityIndicatorView.svg)](https://img.shields.io/cocoapods/v/NVActivityIndicatorView.svg)\n[![Carthage Compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)\n\n⚠️ Check out [LoaderUI](https://github.com/ninjaprox/LoaderUI) (ready to use with Swift Package Mananger supported) for SwiftUI implementation of this. 🎉\n\n## Introduction\n\n`NVActivityIndicatorView` is a collection of awesome loading animations.\n\n![Demo](https://raw.githubusercontent.com/ninjaprox/NVActivityIndicatorView/master/Demo.gif)\n\n## Animation types\n\n| Type                   | Type                        | Type                   | Type                       |\n| ---------------------- | --------------------------- | ---------------------- | -------------------------- |\n| 1. ballPulse           | 2. ballGridPulse            | 3. ballClipRotate      | 4. squareSpin              |\n| 5. ballClipRotatePulse | 6. ballClipRotateMultiple   | 7. ballPulseRise       | 8. ballRotate              |\n| 9. cubeTransition      | 10. ballZigZag              | 11. ballZigZagDeflect  | 12. ballTrianglePath       |\n| 13. ballScale          | 14. lineScale               | 15. lineScaleParty     | 16. ballScaleMultiple      |\n| 17. ballPulseSync      | 18. ballBeat                | 19. lineScalePulseOut  | 20. lineScalePulseOutRapid |\n| 21. ballScaleRipple    | 22. ballScaleRippleMultiple | 23. ballSpinFadeLoader | 24. lineSpinFadeLoader     |\n| 25. triangleSkewSpin   | 26. pacman                  | 27. ballGridBeat       | 28. semiCircleSpin         |\n| 29. ballRotateChase    | 30. orbit                   | 31. audioEqualizer     | 32. circleStrokeSpin       |\n\n## Installation\n\n### Cocoapods\n\n[Cocoapods](https://cocoapods.org/#install) is a dependency manager for Swift and Objective-C Cocoa projects. To use NVActivityIndicatorView with CocoaPods, add it in your `Podfile`.\n\n```ruby\npod 'NVActivityIndicatorView'\n```\n\n### Carthage\n\n[Carthage](https://github.com/Carthage/Carthage#installing-carthage) is intended to be the simplest way to add frameworks to your Cocoa application. To use NVActivityIndicatorView with Carthage, add it in your `Cartfile`.\n\n```ruby\ngithub \"ninjaprox/NVActivityIndicatorView\"\n```\n\n### Swift Package Manager\n\nThe [Swift Package Manager](https://swift.org/package-manager/) is a tool for managing the distribution of Swift code. To use NVActivityIndicatorView with Swift Package Manger, add it to `dependencies` in your `Package.swift`\n\n```swift\ndependencies: [\n    .package(url: \"https://github.com/ninjaprox/NVActivityIndicatorView.git\")\n]\n```\n\n## Migration\n\nVersion [5.0.0](https://github.com/ninjaprox/NVActivityIndicatorView/releases/tag/5.0.0) comes with breaking changes. Please refer to the release note for details.\n\n## Usage\n\nFirstly, import `NVActivityIndicatorView`.\n\n```swift\nimport NVActivityIndicatorView\n```\n\n### Initialization\n\nThen, there are two ways you can create `NVActivityIndicatorView`:\n\n-   By storyboard, changing class of any `UIView` to `NVActivityIndicatorView`.\n\n_**Note:** Set `Module` to `NVActivityIndicatorView`._\n\n-   By code, using initializer. All parameters other than `frame` are optional and [`NVActivityIndicatorView.DEFAULT_*`](https://nvactivityindicatorview.vinhis.me/Classes/NVActivityIndicatorView.html) are used as default values.\n\n```swift\nNVActivityIndicatorView(frame: frame, type: type, color: color, padding: padding)\n```\n\n### Control\n\nStart animating.\n\n```swift\nactivityIndicatorView.startAnimating()\n```\n\nStop animating.\n\n```swift\nactivityIndicatorView.stopAnimating()\n```\n\nDetermine if it is animating.\n\n```swift\nanimating = activityIndicatorView.isAnimating\n```\n\n### Change properties\n\nIn storyboard, you can change all properties in Attributes inspector tab of Utilities panel.\n\n_**Note:** Use one of values (case-insensitive) in [Animation types](#animation-types) for `Type Name`._\n\nAll properties are public so you can change them after initializing.\n\n_**Note:** All changes must be made before calling `startAnimating()`._\n\n## Documentation\n\nhttps://nvactivityindicatorview.vinhis.me/\n\n## Acknowledgment\n\nThanks [Connor Atherton](https://github.com/ConnorAtherton) for inspired [Loaders.css](https://github.com/ConnorAtherton/loaders.css) and [Danil Gontovnik](https://github.com/gontovnik) for [DGActivityIndicatorView](https://github.com/gontovnik/DGActivityIndicatorView).\n\n## License\n\nThe MIT License (MIT)\n\nCopyright (c) 2016 Vinh Nguyen [@ninjaprox](http://twitter.com/ninjaprox)\n","funding_links":[],"categories":["UI","Libs","Progress","Swift","UI/UX","HarmonyOS","UI Components","Content","UI [🔝](#readme)","iOS","ALL"],"sub_categories":["Activity Indicator","UI","Other free courses","Windows Manager","NVActivityIndicatorView"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fninjaprox%2FNVActivityIndicatorView","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fninjaprox%2FNVActivityIndicatorView","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fninjaprox%2FNVActivityIndicatorView/lists"}