Material Motion

Reactive motion driven by Core Animation.

This library includes a variety of ready-to-use interactions. Interactions are registered to an instance of MotionRuntime:

// Store me for as long as the interactions should take effect.
let runtime = MotionRuntime(containerView: <#view#>)

	Interaction	Snippet
	`ArcMove`	`let arcMove = ArcMove() arcMove.from.value = <#from#> arcMove.to.value = <#to#> runtime.add(arcMove, to: <#view#>)`
	`ChangeDirection`	`runtime.add(ChangeDirection(withVelocityOf: gesture), to: <#direction#>)`
	`DirectlyManipulable`	`runtime.add(DirectlyManipulable(), to: <#view#>)`
	`Draggable`	`runtime.add(Draggable(), to: <#view#>)`
	`Rotatable`	`runtime.add(Rotatable(), to: <#view#>)`
	`Scalable`	`runtime.add(Scalable(), to: <#view#>)`
	`SetPositionOnTap`	`runtime.add(SetPositionOnTap(), to: runtime.get(<#view#>.layer).position)`
	`Spring`	`let spring = Spring() spring.destination.value = <#initial destination#> runtime.add(spring, to: <#view#>)`
	`Tossable`	`let tossable = Tossable() tossable.spring.destination.value = <#initial destination#> runtime.add(tossable, to: <#view#>)`
	`Tween`	`runtime.add(Tween(duration: 0.5, values: [1, 0]), to: runtime.get(<#view#>.layer).opacity)`

Installation

Installation with CocoaPods

CocoaPods is a dependency manager for Objective-C and Swift libraries. CocoaPods automates the process of using third-party libraries in your projects. See the Getting Started guide for more information. You can install it with the following command:
gem install cocoapods

Add MaterialMotion to your Podfile:

pod 'MaterialMotion'

You will need to add use_frameworks! to your Podfile in order use Material Motion in your swift app.

A simple Podfile might look like so:

project 'MyApp/MyApp.xcodeproj'

use_frameworks!

target 'MyApp' do
  pod 'MaterialMotion'
end

Then run the following command:

pod install

Usage

Import the framework:

import MaterialMotion

You will now have access to all of the APIs.

Example apps/unit tests

Check out a local copy of the repo to access the Catalog application by running the following commands:

git clone https://github.com/material-motion/material-motion-swift.git
cd material-motion-swift
pod install
open MaterialMotion.xcworkspace

Case studies

Carousel

A carousel with pages that scale in and fade out in reaction to their scroll position.

View the source.

Contextual transition

A contextual view can be used to create continuity during transitions between view controllers. In this case study the selected photo is the contextual view. It's possible to flick the view to dismiss it using the tossable interaction.