一个库,用于重新创建iOS Apple Music现在播放过渡
甲板过渡
DeckTransition尝试重现iOS 10 Apple Music和iMessage应用程序中的卡片状过渡。
这是一个显示它实际效果的 GIF。
Requirements
- Swift 5.0
- iOS 9 or later
Installation
CocoaPods
To install DeckTransition using CocoaPods, add the following line to your Podfile:
pod 'DeckTransition', '~> 2.0'
Carthage
To install DeckTransition using Carthage, add the following line to your Cartfile:
github "HarshilShah/DeckTransition" ~> 2.0
Documentation
You can find the docs here. Documentation is generated with Jazzy, and hosted on GitHub Pages.
Usage
Basics
Set to in your modal view controller, and override the variable to return .modalPresentationCapturesStatusBarAppearance
true
preferredStatusBarStyle
.lightContent
Additionally, the instances which should be tracked for the swipe-to-dismiss gesture should have their set to .UIScrollView
backgroundColor
.clear
Presentation
The transition can be called from code or using a storyboard.
To use via storyboards, just setup a custom segue ( set to ), and set the to .kind
custom
class
DeckSegue
Hereʼs a snippet showing usage via code. Just replace with your view controller's class and youʼre good to go.ModalViewController()
Dismissal
By default, DeckTransition has a swipe-to-dismiss gesture which is automatically enabled when your modalʼs main is scrolled to the top.UIScrollView
You can opt-out of this behaviour by passing in for the parameter while initialising your .false
isSwipeToDismissEnabled
DeckTransitioningDelegate
UIScrollView
detection
DeckTransition has an internal heuristic to determine which should be tracked for the swipe-to-dismiss gesture. In general, this should be sufficient for and cover most use cases.UIScrollView
However there are some edge cases, and should you run into one, these can we worked around by making your modal view controller conform to the protocol. More information about this can be found in the documentation page about UIScrollView detection.DeckTransitionViewControllerProtocol
Snapshots
For a variety of reasons, and especially because of iOS 11's safe area layout, DeckTransition uses a snapshot of your presenting view controller's view instead of using the view directly. This view is automatically updated whenever the frame is resized.
However, there can be some cases where you might want to update the snapshot view by yourself, and this can be achieved using the following one line snippet:
All this does is request the presentation controller to update the snapshot.
You can also choose to update snapshot directly from the presenting view controller, as follows:
It's worth noting that updating the snapshot is an expensive process and should only be used if necessary, for example if you are updating your entire app's theme.
Apps Using DeckTransition
- Petty by Zach Simone
- Bitbook by Sammy Gutierrez
- What's Open for iOS by Mason SRCT
- Manabi Reader by Alex Ehlke
Feel free to submit a PR if you’re using this library in your apps
Author
Written by Harshil Shah
License
DeckTransition is available under the MIT license. See the LICENSE file for more info.