NVActivityIndicatorView README

The project's README from github.com/ninjaprox/NVActivityIndicatorView. As one markdown file: README.md.

NVActivityIndicatorView

Build Status Cocoapods Compatible Carthage Compatible

⚠️ Check out LoaderUI (ready to use with Swift Package Mananger supported) for SwiftUI implementation of this. 🎉

Introduction

NVActivityIndicatorView is a collection of awesome loading animations.

Demo

Animation types

Type Type Type Type
1. ballPulse 2. ballGridPulse 3. ballClipRotate 4. squareSpin
5. ballClipRotatePulse 6. ballClipRotateMultiple 7. ballPulseRise 8. ballRotate
9. cubeTransition 10. ballZigZag 11. ballZigZagDeflect 12. ballTrianglePath
13. ballScale 14. lineScale 15. lineScaleParty 16. ballScaleMultiple
17. ballPulseSync 18. ballBeat 19. lineScalePulseOut 20. lineScalePulseOutRapid
21. ballScaleRipple 22. ballScaleRippleMultiple 23. ballSpinFadeLoader 24. lineSpinFadeLoader
25. triangleSkewSpin 26. pacman 27. ballGridBeat 28. semiCircleSpin
29. ballRotateChase 30. orbit 31. audioEqualizer 32. circleStrokeSpin

Installation

Cocoapods

Cocoapods is a dependency manager for Swift and Objective-C Cocoa projects. To use NVActivityIndicatorView with CocoaPods, add it in your Podfile.

pod 'NVActivityIndicatorView'

Carthage

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.

github "ninjaprox/NVActivityIndicatorView"

Swift Package Manager

The Swift 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

dependencies: [
    .package(url: "https://github.com/ninjaprox/NVActivityIndicatorView.git")
]

Migration

Version 5.0.0 comes with breaking changes. Please refer to the release note for details.

Usage

Firstly, import NVActivityIndicatorView.

import NVActivityIndicatorView

Initialization

Then, there are two ways you can create NVActivityIndicatorView:

Note: Set Module to NVActivityIndicatorView.

NVActivityIndicatorView(frame: frame, type: type, color: color, padding: padding)

Control

Start animating.

activityIndicatorView.startAnimating()

Stop animating.

activityIndicatorView.stopAnimating()

Determine if it is animating.

animating = activityIndicatorView.isAnimating

Change properties

In storyboard, you can change all properties in Attributes inspector tab of Utilities panel.

Note: Use one of values (case-insensitive) in Animation types for Type Name.

All properties are public so you can change them after initializing.

Note: All changes must be made before calling startAnimating().

Documentation

https://nvactivityindicatorview.vinhis.me/

Acknowledgment

Thanks Connor Atherton for inspired Loaders.css and Danil Gontovnik for DGActivityIndicatorView.

License

The MIT License (MIT)

Copyright (c) 2016 Vinh Nguyen @ninjaprox

NVActivityIndicatorView (ninjaprox/NVActivityIndicatorView)

Searching Database…

Что это такое?NVActivityIndicatorView — это набор из более чем 30 готовых анимаций загрузки для приложений iOS, реализованный как готовый подкласс UIView, который можно сразу подключить.
Это представление UIKit или компонент SwiftUI?Это компонент на основе UIKit: пользовательский подкласс UIView, который можно добавить в сториборд или создать в коде. Для SwiftUI автор рекомендует отдельный проект LoaderUI.
Как добавить это в мой проект?Установите через CocoaPods, Carthage или Swift Package Manager, добавив пакет в Podfile, Cartfile или Package.swift соответственно, а затем импортируйте NVActivityIndicatorView в своём коде.
Нужны ли сначала какие-то дополнительные инструменты или библиотеки?Никаких внешних зависимостей времени выполнения не требуется, помимо выбранного менеджера пакетов (CocoaPods, Carthage или SPM), который загружает Swift-фреймворк.
Есть ли подводные камни при обновлении или использовании в Interface Builder?Версия 5.0.0 ввела несовместимые изменения, поэтому перед обновлением изучите примечания к релизу. При использовании через сториборд нужно указать для представления Module значение NVActivityIndicatorView, иначе оно отобразится некорректно.
Как запустить и остановить анимацию после настройки?Вызовите startAnimating(), чтобы начать анимацию, и stopAnimating(), чтобы её завершить; состояние можно проверить через isAnimating. Любые изменения свойств нужно вносить до вызова startAnimating().
Сколько стилей анимации включено?32 различных типа, например ballPulse, squareSpin, pacman, orbit и circleStrokeSpin; каждый из них выбирается по имени.
Можно ли настроить внешний вид анимации в Interface Builder?Да, все свойства (цвет, имя типа, толщина линии и т. д.) задаются на вкладке «Инспектор атрибутов». Поле Type Name должно совпадать с одним из предопределённых значений типа анимации (без учёта регистра).
Зачем использовать это вместо собственного спиннера?В комплекте десятки готовых и аккуратно выполненных анимаций загрузки (вдохновлённых Loaders.css и DGActivityIndicatorView), так что не нужно самостоятельно проектировать и анимировать индикатор загрузки с нуля.
Creator
ninjaprox
Size
6.2 MB
Stars
10.7K
Age
11y
Commits · 90 Days