Need help with Context-Menu.iOS?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

Yalantis
1.9K Stars 261 Forks Apache License 2.0 56 Commits 3 Opened issues

Description

You can easily add awesome animated context menu to your app.

Services available

!
?

Need anything else?

Contributors list

Context-Menu.iOS

You can easily add awesome animated context menu to your app.

Made in Yalantis

Check this project on dribbble

Check this project on Behance

ContextMenu

Installation

CocoaPods

pod 'ContextMenu.iOS', '~> 1.1.0'

Manually

Copy all files from

YALContextMenu
folder to your xcode project.

Usage

Objective-C

You are welcome to see the sample of the project for fully operating sample in the Example folder.

  • Add folder YALContextMenu to your project.
  • #import “YALContextMenuTableView.h”
    to your view controller
  • Create custom UITableViewCell with UIView property for rotation animation and UIView property for fade out animation.
  • Your custom cell should implement YALContextMenuCell protocol
@protocol YALContextMenuCell 

  • (UIView *)animatedIcon;
  • (UIView *)animatedContent;

@end

  • Use the following code sample to start menu
- (IBAction)presentMenuButtonTapped:(UIBarButtonItem *)sender {
// init YALContextMenuTableView tableView
if (!self.contextMenuTableView) {
self.contextMenuTableView = [[YALContextMenuTableView alloc]initWithTableViewDelegateDataSource:self];
self.contextMenuTableView.animationDuration = 0.15;
//optional - implement custom YALContextMenuTableView custom protocol
self.contextMenuTableView.yalDelegate = self;
//optional - implement menu items layout
self.contextMenuTableView.menuItemsSide = Right;
self.contextMenuTableView.menuItemsAppearanceDirection = FromTopToBottom;

//register nib UINib *cellNib = [UINib nibWithNibName:@"ContextMenuCell" bundle:nil]; [self.contextMenuTableView registerNib:cellNib forCellReuseIdentifier:@"contextMenuCellReuseId"]; }

// it is better to use this method only for proper animation [self.contextMenuTableView showInView:self.navigationController.view withEdgeInsets:UIEdgeInsetsZero animated:YES]; }

  • Use default UITableViewDataSource methods for additional set up and customisation of the cell.
  • Сall
    updateAlongsideRotation
    method before the rotation animation started and
    reloadData
    method after rotation animation finished or in UIViewControllerTransitionCoordinator's
    animateAlongsideTransition
    block for proper rotation animation.
- (void)didRotateFromInterfaceOrientation:(UIInterfaceOrientation)fromInterfaceOrientation{
//should be called after rotation animation completed
[self.contextMenuTableView reloadData];
}

  • (void)willRotateToInterfaceOrientation:(UIInterfaceOrientation)toInterfaceOrientation duration:(NSTimeInterval)duration { [super willRotateToInterfaceOrientation:toInterfaceOrientation duration:duration];

[self.contextMenuTableView updateAlongsideRotation]; }

  • (void)viewWillTransitionToSize:(CGSize)size withTransitionCoordinator:(id)coordinator {

[super viewWillTransitionToSize:size withTransitionCoordinator:coordinator];

[coordinator animateAlongsideTransition:nil completion:^(id context) { //should be called after rotation animation completed [self.contextMenuTableView reloadData]; }]; [self.contextMenuTableView updateAlongsideRotation];

}

Swift

You should add the following line to your bridging header:

@import ContextMenu_iOS;

Customisation

To customise menu items side position you can specify a 'menuItemsSide' property. When it set to 'Right' the first cell will be opened from right to left and selected cell will be closed vice versa and when it set to 'Left' the first cell will be opened from left to right and selected cell will be closed vice versa. Default - Right.

Also, to customise menu items appearance direction you can specify 'menuItemsAppearanceDirection' property. Default - FromTopToBottom.

To customise cell set up your custom drawables in the animated icon. Actually the cell design and layout is completely at your choice.

animationDuration is to be used for animation speed in seconds.

Compatibility

iOS 7, iOS 8, iOS 9

Version: 1.1.0

Let us know!

We’d be really happy if you sent us links to your projects where you use our component. Just send an email to [email protected] And do let us know if you have any questions or suggestion regarding the animation.

P.S. We’re going to publish more awesomeness wrapped in code and a tutorial on how to make UI for iOS (Android) better than better. Stay tuned!

License

Copyright 2017, Yalantis

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.