ContextMenu
ContextMenu copied to clipboard
An iOS context menu UI inspired by Things 3.
- 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)
}
}
![](https://github.com/GitHawkApp/ContextMenu/raw/master/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
)
![](https://github.com/GitHawkApp/ContextMenu/raw/master/images/blue.png)
There's plenty more you can customize with ContextMenu.ContainerStyle
:
-
cornerRadius
: The corner radius of the menu -
shadowRadius
andshadowOpacity
: Appearance of the container shadow -
xPadding
,yPadding
,edgePadding
: Padding from the source view and screen edge -
overlayColor
: The color of the background -
motionEffect
: 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