Spring README

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

Updated for Swift 4.2

Requires Xcode 10 and Swift 4.2.

Installation

Drop in the Spring folder to your Xcode project (make sure to enable "Copy items if needed" and "Create groups").

Or via CocoaPods:

use_frameworks!
pod 'Spring', :git => 'https://github.com/MengTo/Spring.git'

Usage with Storyboard

In Identity Inspector, connect the UIView to SpringView Class and set the animation properties in Attribute Inspector.

Usage with Code

layer.animation = "squeezeDown"
layer.animate()

Demo The Animations

Chaining Animations

layer.y = -50
animateToNext {
  layer.animation = "fall"
  layer.animateTo()
}

Functions

animate()
animateNext { ... }
animateTo()
animateToNext { ... }

Animation

shake
pop
morph
squeeze
wobble
swing
flipX
flipY
fall
squeezeLeft
squeezeRight
squeezeDown
squeezeUp
slideLeft
slideRight
slideDown
slideUp
fadeIn
fadeOut
fadeInLeft
fadeInRight
fadeInDown
fadeInUp
zoomIn
zoomOut
flash

Curve

spring
linear
easeIn
easeOut
easeInOut

Properties

force
duration
delay
damping
velocity
repeatCount
scale
x
y
rotate

* Not all properties work together. Play with the demo app.

Autostart

Allows you to animate without code. Don't need to use this if you plan to start the animation in code.

Autohide

Saves you the hassle of adding a line "layer.alpha = 0" in viewDidLoad().

Known issue

Animations won't autostart when view is reached via performSegueWithIdentifier.

Tutorials

ChangeLog

License

Spring is released under the MIT license. See LICENSE for details.

Spring (MengTo/Spring)

Searching Database…

14.1K ·GitHub
Что это такое?Spring — это библиотека на Swift для iOS, которая добавляет готовые анимации для представлений (shake, pop, swing, flip, slide, fade, zoom и другие), которые можно запускать из кода или сразу настроить в Storyboard.
Это фреймворк или просто помощник для UIView?Это лёгкая библиотека, а не полноценный фреймворк: она расширяет UIView свойствами и функциями анимации, которые вызываются в коде, а также включает класс SpringView, который можно подключить прямо в Storyboard.
Как добавить её в мой проект Xcode?Перетащите папку Spring в проект Xcode (включив опции 'Copy items if needed' и 'Create groups') или установите библиотеку через CocoaPods.
Нужна ли определённая версия Xcode или Swift?Да, эта версия Spring требует Xcode 10 и Swift 4.2.
Есть ли подводные камни при работе с анимациями?Анимации не запускаются автоматически, если представление открывается через performSegueWithIdentifier, а также не все свойства анимации (force, duration, damping, velocity и другие) работают вместе — в README рекомендуют проверять комбинации в демо-приложении.
Можно ли запустить анимацию без написания кода?Да, есть опция Autostart, которая запускает анимацию автоматически, и опция Autohide, которая избавляет от необходимости вручную задавать layer.alpha = 0 в viewDidLoad().
Можно ли объединять несколько анимаций в цепочку?Да, с помощью animateToNext можно запустить одну анимацию, а затем начать другую после её завершения, например, сначала переместить представление, а потом заставить его упасть.
Какие кривые анимации можно использовать?Spring поддерживает для своих анимаций кривые spring, linear, easeIn, easeOut и easeInOut.
Можно ли использовать Spring в проекте на Objective-C?Да, в README есть ссылка на отдельное руководство по интеграции Spring в существующие проекты на Objective-C.
Creator
MengTo
Size
0.9 MB
Stars
14.1K
Updated
CommitAug 14
Age
11y
Commits · 90 Days