Awesome
<p align="center"> <img src="/images/animation.gif" /> </p>- Contextual menus with delightful animations and styles
- Total control over menu contents using your own
UIViewController
s - Tons of feature and interaction customizations
Installation
Just add ContextMenu
to your Podfile and pod install
. Done!
pod 'ContextMenu'
For Carthage, just add GitHawkApp/ContextMenu
to your Cartfile and carthage bootstrap
.
github "GitHawkApp/ContextMenu"
Usage
Show the menu from one of your UIViewController
s:
ContextMenu.shared.show(
sourceViewController: self,
viewController: MyContentViewController()
)
You must provide a custom UIViewController
to display in the menu. The only requirement is that you must set preferredContentSize
to size your content.
class MyContentViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
title = "Demo"
preferredContentSize = CGSize(width: 200, height: 200)
}
}
<img src="/images/basic.png" />
Customizations
Display from a Source View
Animate the menu out from a button or view. ContextMenu
will take care of layout so that your menu doesn't clip the screen.
@IBAction func onButton(_ sender: UIButton) {
ContextMenu.shared.show(
sourceViewController: self,
viewController: MyContentViewController(),
sourceView: sender
)
}
Container Style & Display
Use ContextMenu.Options
to change the appearance of the containing view.
ContextMenu.shared.show(
sourceViewController: self,
viewController: MenuViewController(),
options: ContextMenu.Options(containerStyle: ContextMenu.ContainerStyle(backgroundColor: .blue)),
sourceView: button
)
<img src="/images/blue.png" />
There's plenty more you can customize with ContextMenu.ContainerStyle
:
cornerRadius
: The corner radius of the menushadowRadius
andshadowOpacity
: Appearance of the container shadowxPadding
,yPadding
,edgePadding
: Padding from the source view and screen edgeoverlayColor
: The color of the backgroundmotionEffect
: Respond to device gyroscope changes, similar to app icons on Springboard.app.
If you want more customizations, we will gladly accept a Pull Request!
Acknowledgements
- Inspiration from Things 3
- Created with ❤️ by Ryan Nystrom