Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/liufengting/ftpopovermenu
FTPopOverMenu is a pop over menu for iOS which is maybe the easiest one to use. Supports both portrait and landscape. It can show from any UIView, any UIBarButtonItem and any CGRect.
https://github.com/liufengting/ftpopovermenu
button cocoapods menu navigation-items pop popover
Last synced: 29 days ago
JSON representation
FTPopOverMenu is a pop over menu for iOS which is maybe the easiest one to use. Supports both portrait and landscape. It can show from any UIView, any UIBarButtonItem and any CGRect.
- Host: GitHub
- URL: https://github.com/liufengting/ftpopovermenu
- Owner: liufengting
- License: mit
- Created: 2016-04-06T12:27:16.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-11-10T05:49:56.000Z (about 1 year ago)
- Last Synced: 2024-05-15T19:53:32.959Z (6 months ago)
- Topics: button, cocoapods, menu, navigation-items, pop, popover
- Language: Objective-C
- Homepage:
- Size: 3.32 MB
- Stars: 1,033
- Watchers: 30
- Forks: 172
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# FTPopOverMenu
[](http://twitter.com/liufengting)
[](https://raw.githubusercontent.com/liufengting/FTPopOverMenu/master/LICENSE)
[](http://cocoapods.org/pods/FTPopOverMenu)
[](https://codebeat.co/projects/github-com-liufengting-ftpopovermenu)
[](http://cocoapods.org/pods/FTPopOverMenu)
[](http://cocoapods.org/pods/FTPopOverMenu)
[](http://cocoapods.org/pods/FTPopOverMenu)
[](https://travis-ci.org/liufengting/FTPopOverMenu)
[](https://github.com/liufengting/FTPopOverMenu/stargazers)
[](https://gitter.im/liufengting/FTPopOverMenu?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
`FTPopOverMenu` is a pop over menu for `iOS` which is maybe the easiest one to use, supports both `portrait` and `landscape`. It can show from any `UIView`, any `UIBarButtonItem` and any `CGRect`. Simplest APIs, enable you to change the style in one line of code.
### menu array supports following context:
* image name (NSString, only main bundle),
* image (UIImage),
* image remote URL string (NSString),
* image remote URL (NSURL),
* model (FTPopOverMenuModel, select state support)
### ⚠️ Big API Change from `1.3.6` to `2.0.0` (See [CHANGELOG](https://github.com/liufengting/FTPopOverMenu/blob/master/CHANGELOG.md) for more info)
* supports separated configuration.
* change 'tintColor' to 'backgroundColor'
# About Swift Version
`FTPopOverMenu_Swift` is now published. [Take a look at it now](https://github.com/liufengting/FTPopOverMenu_Swift). The swift version has same APIs with this OC version.
# ScreenShots
## Recently UrbanHooker added round arrow support, I changed a little bit.
# Installation
## Manually
* clone this repo.
* Simply drop the '/FTPopOverMenu' folder into your project.
* import 'FTPopOverMenu.h'
## CocoaPods
`FTPopOverMenu` is available through [CocoaPods](http://cocoapods.org). To install it, simply add the following line to your Podfile:
```ruby
pod 'FTPopOverMenu'
```
# Usage
## Customize
Do any of the following settings to set the style (Only set the ones you want to change) before showing.
```objective-c
FTPopOverMenuConfiguration *configuration = [FTPopOverMenuConfiguration defaultConfiguration];
configuration.menuRowHeight = ...
configuration.menuWidth = ...
configuration.textColor = ...
configuration.textFont = ...
configuration.tintColor = ...
configuration.borderColor = ...
configuration.borderWidth = ...
configuration.textAlignment = ...
configuration.ignoreImageOriginalColor = ...;// set 'ignoreImageOriginalColor' to YES, images color will be same as textColor
configuration.allowRoundedArrow = ...// Default is 'NO', if sets to 'YES', the arrow will be drawn with round corner.
configuration.separatorColor = ...
configuration.shadowColor = ... // Default is black
configuration.shadowOpacity = ... // Default is 0 - choose anything between 0 to 1 to show actual shadow, e.g. 0.2
configuration.shadowRadius = ... // Default is 5
configuration.shadowOffsetX = ...
configuration.shadowOffsetY = ...
```
## ~~setTintColor, default is gray color.~~ deprecated after 1.2.0
```objective-c
[FTPopOverMenu setTintColor:[UIColor redColor]];
```
## ~~setTextColor, default is white color.~~ deprecated after 1.2.0
```objective-c
[FTPopOverMenu setTextColor:[UIColor blackColor]];
```
## ~~setPreferedWidth, default is 120, should not be less than 50.~~ deprecated after 1.2.0
```objective-c
[FTPopOverMenu setPreferedWidth:200];
```
## From SenderView, Menu Without Images.
```objective-c
[FTPopOverMenu showForSender:sender
withMenu:@[@"MenuOne",@"MenuTwo",@"MenuThr"]
doneBlock:^(NSInteger selectedIndex) {
} dismissBlock:^{
}];
```
## From SenderView, Menu With Images.
```objective-c
[FTPopOverMenu showForSender:sender
withMenu:@[@"MenuOne",@"MenuTwo",@"MenuThr"]
imageNameArray:@[@"setting_icon",@"setting_icon",@"setting_icon"]
doneBlock:^(NSInteger selectedIndex) {
} dismissBlock:^{
}];
```
## From SenderView, Menu With Images, custom configuration.
```objective-c
[FTPopOverMenu showForSender:sender
withMenu:@[@"MenuOne",@"MenuTwo",@"MenuThr"]
imageNameArray:@[@"setting_icon",@"setting_icon",@"setting_icon"]
configuration:customConfiguration
doneBlock:^(NSInteger selectedIndex) {
} dismissBlock:^{
}];
```
## From SenderFrame/NavigationItem, Menu Without Images.
```objective-c
[FTPopOverMenu showFromSenderFrame:CGRectMake(self.view.frame.size.width - 40, 20, 40, 40)
withMenu:@[@"123",@"234",@"345"]
doneBlock:^(NSInteger selectedIndex) {
} dismissBlock:^{
}];
```
## From SenderFrame/NavigationItem, Menu With Images.
```objective-c
[FTPopOverMenu showFromSenderFrame:CGRectMake(self.view.frame.size.width - 40, 20, 40, 40)
withMenu:@[@"123",@"234",@"345"]
imageNameArray:@[@"setting_icon",@"setting_icon",@"setting_icon"]
doneBlock:^(NSInteger selectedIndex) {
} dismissBlock:^{
}];
```
## From SenderFrame/NavigationItem, Menu With Images, custom configuration.
```objective-c
[FTPopOverMenu showFromSenderFrame:CGRectMake(self.view.frame.size.width - 40, 20, 40, 40)
withMenu:@[@"123",@"234",@"345"]
imageNameArray:@[@"setting_icon",@"setting_icon",@"setting_icon"]
configuration:customConfiguration
doneBlock:^(NSInteger selectedIndex) {
} dismissBlock:^{
}];
```
## From barButtonItems .
- First: add action with event to you barButtonItems
```objective-c
[self.navigationItem setRightBarButtonItem:[[UIBarButtonItem alloc] initWithTitle:@"Edit" style:UIBarButtonItemStyleDone target:self action:@selector(onNavButtonTapped:event:)]];
```
- Second: implement the action, also supports custom configuration.
```objective-c
-(void)onNavButtonTapped:(UIBarButtonItem *)sender event:(UIEvent *)event
{
[FTPopOverMenu showFromEvent:event
withMenu:@[@"123",@"234",@"345"]
imageNameArray:@[@"setting_icon",@"setting_icon",@"setting_icon"]
configuration:customConfiguration
doneBlock:^(NSInteger selectedIndex) {
} dismissBlock:^{
}];
}
```
# CHANGELOG
[CHANGELOG](https://github.com/liufengting/FTPopOverMenu/blob/master/CHANGELOG.md)
# More
* Logo Designed by @Tobaloidee
* Images in the demo from [https://www.iconfinder.com/iconsets/pokemon-go](https://www.iconfinder.com/iconsets/pokemon-go).
* If you like it, or maybe wanna use it in your own projects, please give me a `star`.
* Looking for another way of doing this? Take a look at my another [FTPopMenu at here](https://github.com/liufengting/FTPopMenu). It was another way of showing pop over menus, which is wrapped from `UIPopoverViewController`, and more genetic and more good-looking. Feel free to try it.
# License
`FTPopOverMenu` is available under the `MIT` license. See the `LICENSE` file for more info.