Added public API to show the left and right utility buttons programmatically (related to #97).

SWTableViewCell/PodFiles/SWTableViewCell.h

@@ -41,6 +41,8 @@ typedef NS_ENUM(NSInteger, SWCellState)
 
 - (id)initWithStyle:(UITableViewCellStyle)style reuseIdentifier:(NSString *)reuseIdentifier containingTableView:(UITableView *)containingTableView leftUtilityButtons:(NSArray *)leftUtilityButtons rightUtilityButtons:(NSArray *)rightUtilityButtons;
 
+- (void)showLeftUtilityButtonsAnimated:(BOOL)animated;
+- (void)showRightUtilityButtonsAnimated:(BOOL)animated;
 - (void)hideUtilityButtonsAnimated:(BOOL)animated;
 
 @end

SWTableViewCell/PodFiles/SWTableViewCell.m

@@ -34,6 +34,7 @@ - (CGFloat)utilityButtonsPadding;
 
 - (CGPoint)contentOffsetForCellState:(SWCellState)state;
 - (void)updateCellState;
+- (void)finishScrollingToCellState:(SWCellState)targetState;
 
 - (BOOL)shouldHighlight;
 
@@ -198,6 +199,8 @@ - (void)setContainingTableView:(UITableView *)containingTableView
     }
 }
 
+#pragma mark - Public API
+
 - (void)setLeftUtilityButtons:(NSArray *)leftUtilityButtons
 {
     _leftUtilityButtons = leftUtilityButtons;
@@ -216,6 +219,24 @@ - (void)setRightUtilityButtons:(NSArray *)rightUtilityButtons
     [self layoutIfNeeded];
 }
 
+- (void)showLeftUtilityButtonsAnimated:(BOOL)animated
+{
+    [self.cellScrollView setContentOffset:[self contentOffsetForCellState:kCellStateLeft] animated:animated];
+    [self finishScrollingToCellState:kCellStateLeft];
+}
+
+- (void)showRightUtilityButtonsAnimated:(BOOL)animated
+{
+    [self.cellScrollView setContentOffset:[self contentOffsetForCellState:kCellStateRight] animated:animated];
+    [self finishScrollingToCellState:kCellStateRight];
+}
+
+- (void)hideUtilityButtonsAnimated:(BOOL)animated
+{
+    [self.cellScrollView setContentOffset:[self contentOffsetForCellState:kCellStateCenter] animated:animated];
+    [self finishScrollingToCellState:kCellStateCenter];
+}
+
 #pragma mark - UITableViewCell overrides
 
 - (void)didMoveToSuperview
@@ -395,20 +416,31 @@ - (void)leftUtilityButtonHandler:(id)sender
     }
 }
 
-- (void)hideUtilityButtonsAnimated:(BOOL)animated
+- (void)finishScrollingToCellState:(SWCellState)targetState
 {
-    if (_cellState != kCellStateCenter)
+    if (_cellState != targetState)
     {
-        [self.cellScrollView setContentOffset:[self contentOffsetForCellState:kCellStateCenter] animated:YES];
-
         if ([self.delegate respondsToSelector:@selector(swipeableTableViewCell:scrollingToState:)])
         {
-            [self.delegate swipeableTableViewCell:self scrollingToState:kCellStateCenter];
+            [self.delegate swipeableTableViewCell:self scrollingToState:targetState];
+        }
+
+        if (targetState != kCellStateCenter)
+        {
+            if ([self.delegate respondsToSelector:@selector(swipeableTableViewCellShouldHideUtilityButtonsOnSwipe:)])
+            {
+                for (SWTableViewCell *cell in self.containingTableView.visibleCells)
+                {
+                    if (cell != self && [cell isKindOfClass:[SWTableViewCell class]] && [self.delegate swipeableTableViewCellShouldHideUtilityButtonsOnSwipe:cell])
+                    {
+                        [cell hideUtilityButtonsAnimated:YES];
+                    }
+                }
+            }
         }
     }
 }
 
-
 #pragma mark - Geometry helpers
 
 - (CGFloat)leftUtilityButtonsWidth
@@ -490,26 +522,28 @@ - (void)updateCellState
 
 - (void)scrollViewWillEndDragging:(UIScrollView *)scrollView withVelocity:(CGPoint)velocity targetContentOffset:(inout CGPoint *)targetContentOffset
 {
+    SWCellState targetState;
+
     if (velocity.x >= 0.5f)
     {
         if (_cellState == kCellStateLeft)
         {
-            _cellState = kCellStateCenter;
+            targetState = kCellStateCenter;
         }
         else
         {
-            _cellState = kCellStateRight;
+            targetState = kCellStateRight;
         }
     }
     else if (velocity.x <= -0.5f)
     {
         if (_cellState == kCellStateRight)
         {
-            _cellState = kCellStateCenter;
+            targetState = kCellStateCenter;
         }
         else
         {
-            _cellState = kCellStateLeft;
+            targetState = kCellStateLeft;
         }
     }
     else
@@ -519,36 +553,22 @@ - (void)scrollViewWillEndDragging:(UIScrollView *)scrollView withVelocity:(CGPoi
 
         if (targetContentOffset->x > rightThreshold)
         {
-            _cellState = kCellStateRight;
+            targetState = kCellStateRight;
         }
         else if (targetContentOffset->x < leftThreshold)
         {
-            _cellState = kCellStateLeft;
+            targetState = kCellStateLeft;
         }
         else
         {
-            _cellState = kCellStateCenter;
+            targetState = kCellStateCenter;
         }
     }
-
-    if ([self.delegate respondsToSelector:@selector(swipeableTableViewCell:scrollingToState:)])
-    {
-        [self.delegate swipeableTableViewCell:self scrollingToState:_cellState];
-    }
-
-    if (_cellState != kCellStateCenter)
-    {
-        if ([self.delegate respondsToSelector:@selector(swipeableTableViewCellShouldHideUtilityButtonsOnSwipe:)])
-        {
-            for (SWTableViewCell *cell in [self.containingTableView visibleCells]) {
-                if (cell != self && [cell isKindOfClass:[SWTableViewCell class]] && [self.delegate swipeableTableViewCellShouldHideUtilityButtonsOnSwipe:cell]) {
-                    [cell hideUtilityButtonsAnimated:YES];
-                }
-            }
-        }
-    }
-
-    *targetContentOffset = [self contentOffsetForCellState:_cellState];
+
+    *targetContentOffset = [self contentOffsetForCellState:targetState];
+
+    // Fire the delegate messages and hide other open buttons if required.
+    [self finishScrollingToCellState:targetState];
 }
 
 - (void)scrollViewDidScroll:(UIScrollView *)scrollView

SWTableViewCell/ViewController.m

@@ -16,9 +16,15 @@ @interface ViewController () {
 }
 
 @property (nonatomic, weak) IBOutlet UITableView *tableView;
+@property (nonatomic, weak) IBOutlet UISwitch *tapToRevealSwitch;
 @property (nonatomic) BOOL useCustomCells;
 @property (nonatomic, weak) UIRefreshControl *refreshControl;
 
+- (IBAction)toggleCells:(id)sender;
+
+- (NSArray *)leftButtons;
+- (NSArray *)rightButtons;
+
 @end
 
 @implementation ViewController
@@ -61,38 +67,42 @@ - (void)viewDidLoad {
     }
 }
 
-#pragma mark UITableViewDataSource
+#pragma mark -
 
-- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
-    return _testArray.count;
-}
-
-- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
-    return [_testArray[section] count];
-}
-
-- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
-    NSLog(@"cell selected at index path %ld:%ld", (long)indexPath.section, (long)indexPath.row);
-    NSLog(@"selected cell index path is %@", [self.tableView indexPathForSelectedRow]);
+- (NSArray *)rightButtons
+{
+    NSMutableArray *rightUtilityButtons = [NSMutableArray new];
+    [rightUtilityButtons sw_addUtilityButtonWithColor:
+     [UIColor colorWithRed:0.78f green:0.78f blue:0.8f alpha:1.0]
+                                                title:@"More"];
+    [rightUtilityButtons sw_addUtilityButtonWithColor:
+     [UIColor colorWithRed:1.0f green:0.231f blue:0.188 alpha:1.0f]
+                                                title:@"Delete"];
 
-    [tableView deselectRowAtIndexPath:indexPath animated:YES];
+    return rightUtilityButtons;
 }
 
-- (NSString *)tableView:(UITableView *)tableView titleForHeaderInSection:(NSInteger)section {
-    return _sections[section];
+- (NSArray *)leftButtons
+{
+    NSMutableArray *leftUtilityButtons = [NSMutableArray new];
+
+    [leftUtilityButtons sw_addUtilityButtonWithColor:
+     [UIColor colorWithRed:0.07 green:0.75f blue:0.16f alpha:1.0]
+                                                icon:[UIImage imageNamed:@"check.png"]];
+    [leftUtilityButtons sw_addUtilityButtonWithColor:
+     [UIColor colorWithRed:1.0f green:1.0f blue:0.35f alpha:1.0]
+                                                icon:[UIImage imageNamed:@"clock.png"]];
+    [leftUtilityButtons sw_addUtilityButtonWithColor:
+     [UIColor colorWithRed:1.0f green:0.231f blue:0.188f alpha:1.0]
+                                                icon:[UIImage imageNamed:@"cross.png"]];
+    [leftUtilityButtons sw_addUtilityButtonWithColor:
+     [UIColor colorWithRed:0.55f green:0.27f blue:0.07f alpha:1.0]
+                                                icon:[UIImage imageNamed:@"list.png"]];
+
+    return leftUtilityButtons;
 }
 
-// Show index titles
-
-//- (NSArray *)sectionIndexTitlesForTableView:(UITableView *)tableView {
-//    return [[UILocalizedIndexedCollation currentCollation] sectionIndexTitles];
-//}
-//
-//- (NSInteger)tableView:(UITableView *)tableView sectionForSectionIndexTitle:(NSString *)title atIndex:(NSInteger)index {
-//    return [[UILocalizedIndexedCollation currentCollation] sectionForSectionIndexTitleAtIndex:index];
-//}
-
-#pragma mark - UIRefreshControl Selector
+#pragma mark - IBActions
 
 - (void)toggleCells:(UIRefreshControl*)refreshControl
 {
@@ -110,7 +120,19 @@ - (void)toggleCells:(UIRefreshControl*)refreshControl
     [refreshControl endRefreshing];
 }
 
-#pragma mark - UIScrollViewDelegate
+#pragma mark - UITableViewDataSource
+
+- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {
+    return _testArray.count;
+}
+
+- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
+    return [_testArray[section] count];
+}
+
+- (NSString *)tableView:(UITableView *)tableView titleForHeaderInSection:(NSInteger)section {
+    return _sections[section];
+}
 
 - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
 
@@ -145,59 +167,36 @@ - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(N
         cell.textLabel.backgroundColor = [UIColor whiteColor];
         cell.detailTextLabel.backgroundColor = [UIColor whiteColor];
         cell.detailTextLabel.text = @"Some detail text";
-
+        
         return cell;
     }
-
 }
 
-- (NSArray *)rightButtons
-{
-    NSMutableArray *rightUtilityButtons = [NSMutableArray new];
-    [rightUtilityButtons sw_addUtilityButtonWithColor:
-     [UIColor colorWithRed:0.78f green:0.78f blue:0.8f alpha:1.0]
-                                                title:@"More"];
-    [rightUtilityButtons sw_addUtilityButtonWithColor:
-     [UIColor colorWithRed:1.0f green:0.231f blue:0.188 alpha:1.0f]
-                                                title:@"Delete"];
-
-    return rightUtilityButtons;
-}
+#pragma mark - UITableViewDelegate
 
-- (NSArray *)leftButtons
+- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
 {
-    NSMutableArray *leftUtilityButtons = [NSMutableArray new];
-
-    [leftUtilityButtons sw_addUtilityButtonWithColor:
-     [UIColor colorWithRed:0.07 green:0.75f blue:0.16f alpha:1.0]
-                                                icon:[UIImage imageNamed:@"check.png"]];
-    [leftUtilityButtons sw_addUtilityButtonWithColor:
-     [UIColor colorWithRed:1.0f green:1.0f blue:0.35f alpha:1.0]
-                                                icon:[UIImage imageNamed:@"clock.png"]];
-    [leftUtilityButtons sw_addUtilityButtonWithColor:
-     [UIColor colorWithRed:1.0f green:0.231f blue:0.188f alpha:1.0]
-                                                icon:[UIImage imageNamed:@"cross.png"]];
-    [leftUtilityButtons sw_addUtilityButtonWithColor:
-     [UIColor colorWithRed:0.55f green:0.27f blue:0.07f alpha:1.0]
-                                                icon:[UIImage imageNamed:@"list.png"]];
-
-    return leftUtilityButtons;
-}
-
-// Set row height on an individual basis
+    NSLog(@"cell selected at index path %ld:%ld", (long)indexPath.section, (long)indexPath.row);
+    NSLog(@"selected cell index path is %@", [self.tableView indexPathForSelectedRow]);
 
-//- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath{
-//    return [self rowHeightForIndexPath:indexPath];
-//}
-//
-//- (CGFloat)rowHeightForIndexPath:(NSIndexPath *)indexPath {
-//    return ([indexPath row] * 10) + 60;
-//}
+    [tableView deselectRowAtIndexPath:indexPath animated:YES];
 
-- (void)tableView:(UITableView *)tableView willDisplayCell:(UITableViewCell *)cell forRowAtIndexPath:(NSIndexPath *)indexPath {
-    // Set background color of cell here if you don't want default white
+    if (self.tapToRevealSwitch.isOn)
+    {
+        SWTableViewCell *cell = (SWTableViewCell *)[tableView cellForRowAtIndexPath:indexPath];
+
+        if (arc4random() % 2)
+        {
+            [cell showLeftUtilityButtonsAnimated:YES];
+        }
+        else
+        {
+            [cell showRightUtilityButtonsAnimated:YES];
+        }
+    }
 }
 
+
 #pragma mark - SWTableViewDelegate
 
 - (void)swipeableTableViewCell:(SWTableViewCell *)cell didTriggerLeftUtilityButtonWithIndex:(NSInteger)index {