• Stars
    star
    526
  • Rank 84,247 (Top 2 %)
  • Language
    Objective-C
  • License
    MIT License
  • Created over 11 years ago
  • Updated over 6 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Drop-in solution to achieve the "More" button in an UITableView's "Swipe to Delete" menu (as seen in Mail.app under iOS 7)

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.

Screenshot

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

  1. Add MSCMoreOptionTableViewCell.xcodeproj as subproject.
  2. Add MSCMoreOptionTableViewCell's root folder to your project's header search paths.
  3. Add MSCMoreOptionTableViewCell to your target's dependencies (Target >> Build Phases >> Target Dependencies).
  4. Add MSCMoreOptionTableViewCell to your target's linked frameworks (Target >> Summary >> Linked Frameworks and Libraries).
  5. 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