MSCMoreOptionTableViewCell
Fully compatible to iOS 7 & iOS 8
Drop-in solution to achieve the "More" button in an UITableView's "swipe to delete"-menu (as seen in the Mail.app) by extending Apple's own "swipe to delete"-implementation and not rewriting it, so UITableView's standard behaviour isn't changed.
Integration
If you are using a custom UITableViewCell subclass then change it to inherit from MSCMoreOptionTableViewCell instead of UITableViewCell. If your are using UITableViewCell itself just replace it with MSCMoreOptionTableViewCell (take a look at the following snippet for details). Then set the cell's delegate to your UITableViewController and you're ready to go!
- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
static NSString *identifier = @"MSCMoreOptionTableViewCell";
MSCMoreOptionTableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:identifier];
if (!cell) {
cell = [[MSCMoreOptionTableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:identifier];
cell.delegate = self;
}
cell.textLabel.text = @"Cell";
return cell;
}
If you are using Storyboards in your project then take a look at the demo project which includes a working example using a Storyboard.
Add to your project
- Add MSCMoreOptionTableViewCell.xcodeproj as subproject.
- Add MSCMoreOptionTableViewCell's root folder to your project's header search paths.
- Add MSCMoreOptionTableViewCell to your target's dependencies (Target >> Build Phases >> Target Dependencies).
- Add MSCMoreOptionTableViewCell to your target's linked frameworks (Target >> Summary >> Linked Frameworks and Libraries).
- Import "MSCMoreOptionTableViewCell.h" either in Prefix.pch or separately in any file you use it.
Detect when button gets pressed
'More'
The optional delegate method is called if the more button is pressed.
- (void)tableView:(UITableView *)tableView moreOptionButtonPressedInRowAtIndexPath:(NSIndexPath *)indexPath;
'Delete'
The tapped delete button is signaled via the standard -tableView:commitEditingStyle:forRowAtIndexPath:
method of UITableViewDataSource
.
Customizing
Delegate
There are several optional delegate methods to customize the "Delete" and the "More" button. Check out MSCMoreOptionTableViewCellDelegate.h
inline documentation for details.
Block based
Both buttons can be completely customized using the configurationBlock
:
[cell setConfigureButtonsBlock:^(UIButton *deleteButton, UIButton *moreOptionButton, CGFloat *deleteButtonWitdh, CGFloat *moreOptionButtonWidth) {
// Hide delete button every second row
*deleteButtonWitdh = (indexPath.row - 1) % 2 == 0? 0.f : *deleteButtonWitdh;
// Give the 'More' button a orange background every third row
moreOptionButton.backgroundColor = (indexPath.row - 2) % 3 == 0 ? [UIColor orangeColor] : moreOptionButton.backgroundColor;
// Set a trash icon as 'Delete' button content
[deleteButton setTitle:nil forState:UIControlStateNormal];
[deleteButton setImage:[UIImage imageNamed:@"Trash.png"] forState:UIControlStateNormal];
[deleteButton setImageEdgeInsets:UIEdgeInsetsMake(0.f, 20.f, 0.f, 20.f)];
];
By default deleteButtonWidth
and moreOptionButtonWidth
will be MSCMoreOptionTableViewCellButtonWidthSizeToFit
the button's width will be calculated like contentSize + edgeInsets
.
To hide a button set it's width to 0.
Compatibility and Requirements
- iOS 7 and iOS 8
- Xcode 5 or newer
As many other solutions that extend existing functionalities MSCMoreOptionTableViewCell depends on existing vendor code, therefore if Apple changes it's "swipe to delete"-implementation significant in future iOS releases, it could happen that the "More" button doesn't appear until MSCMoreOptionTableViewCell gets adopted. But it's important for you as developer to know that MSCMoreOptionTableViewCell can't break your App or UITableView's standard functionality because of changes on the "swipe to delete"-implementation from Apple.
Alternative Solutions
iOS 7
As pointed out by @steipete there's a solution to achieve the "More" button without any third party code and private API usage. It's a pretty streamlined way but you have to consider that it's undocumented behaviour and the "Delete" and "More" buttons aren't customizable.
iOS 8 (>= beta 2)
Apple added a real cool method in beta 2 which makes it easier than ever to achieve custom buttons in the 'swipe to delete' menu. Check out my gist for an working example.
Credits
MSCMoreOptionTableViewCell was created by Manfred Scheiner (@scheinem - scheinem.com). Of course there is also a full list of all contributors available.
License
MSCMoreOptionTableViewCell is available under the MIT license. See the LICENSE file for more info. For usage without attribution contact Manfred Scheiner.
Apps which are or were using MSCMoreOptionTableViewCell
- Chefkoch
- Fantastical 2
- Where To?
- Pomotodo
- If your app is missing here just add it and send a pull request :)