README.zh-cn.md

Hero是一个iOS界面切换库。它代替了UIKit本身的转场动画接口，使制作自定义的转场动画(View Controller Transition)非常简单！

特点

你可以使用这些效果来拼凑出你想要的转场动画。

Hero很像Keynote的“神奇移动”过渡(Magic Move)。在界面切换时，Hero会把开始界面的视图与结束界面的视图配对，假如他能找到一对儿有着一样的heroID的视图的话，Hero便会自动为此视图创建动画，从它一开始的状态移动到结束时的状态。

不仅如此，Hero还可以为没有配对的视图制作动画。每一个视图都可以轻易的用heroModifiers来告诉Hero你想为这个视图所创造的动画。交互式动画(interactive transition)也是支持的哟。

Hero还参照Google的Material Design Motion Guide来提供动态的动画长度与时间曲线。你不需要告诉Hero动画的长度与时间曲线，Hero会参照视图的移动长度和大小来自动选择最适合的参数。

无论你使用怎样的方法制作和布局你的视图，Hero都能帮你省去很多时间制作动画。Hero支持 auto layout, programmatic layout, UICollectionView, UITableView, UINavigationController, UITabBarController, 等等。。

视频

1. 实例介绍。Example Project.
2. 自带的校错程序介绍, 可以显示时间轴，曲线路线，和3D视图。built-in debugger

安装方法与用法

Hero可以用Carthage或者Cocoapods安装，具体用法请见**Usage Guide**。

注: 因为一个苹果的bug，Hero 不能在iPhone 7 Simulators上使用。 请使用其他版本的Simulator或者使用真机。

简单实例 1

View Controller 1

redView.heroID = "foo"
greyView.heroID = "bar"

View Controller 2

isHeroEnabled = true
redView.heroID = "foo"
greyView.heroID = "bar"
greenView.heroModifiers = [.translate(x:0, y:100), .scale(0.5)]

简单实例 2

View Controller 1

greyView.heroID = "foo"

View Controller 2

isHeroEnabled = true
greyView.heroID = "foo"

// collectionView 是所有红色视图的父视图
collectionView.heroModifiers = [.cascade]
for cell in redCells {
	cell.heroModifiers = [.fade, .scale(0.5)]
}

Hero 还支持 storyboard。 你可以在Storyboard右边的Identity Inspector来使用HeroID与HeroModifiers。

Contribute

We welcome any contributions. Please read the Contribution Guide.

License

Hero is available under the MIT license. See the LICENSE file for more info.