new APIs for responding to different cell tap events. issue jessesquires#374. update demo.

Author: jessesquires

JSQMessagesDemo/JSQDemoViewController.m

@@ -405,6 +405,8 @@ - (UICollectionViewCell *)collectionView:(JSQMessagesCollectionView *)collection
 
 #pragma mark - JSQMessages collection view flow layout delegate
 
+#pragma mark - Adjusting cell label heights
+
 - (CGFloat)collectionView:(JSQMessagesCollectionView *)collectionView
                    layout:(JSQMessagesCollectionViewFlowLayout *)collectionViewLayout heightForCellTopLabelAtIndexPath:(NSIndexPath *)indexPath
 {
@@ -452,10 +454,27 @@ - (CGFloat)collectionView:(JSQMessagesCollectionView *)collectionView
     return 0.0f;
 }
 
+#pragma mark - Responding to collection view tap events
+
 - (void)collectionView:(JSQMessagesCollectionView *)collectionView
                 header:(JSQMessagesLoadEarlierHeaderView *)headerView didTapLoadEarlierMessagesButton:(UIButton *)sender
 {
     NSLog(@"Load earlier messages!");
 }
 
+- (void)collectionView:(JSQMessagesCollectionView *)collectionView didTapAvatarImageView:(UIImageView *)avatarImageView atIndexPath:(NSIndexPath *)indexPath
+{
+    NSLog(@"Tapped avatar!");
+}
+
+- (void)collectionView:(JSQMessagesCollectionView *)collectionView didTapMessageBubbleAtIndexPath:(NSIndexPath *)indexPath
+{
+    NSLog(@"Tapped message bubble!");
+}
+
+- (void)collectionView:(JSQMessagesCollectionView *)collectionView didTapCellAtIndexPath:(NSIndexPath *)indexPath touchLocation:(CGPoint)touchLocation
+{
+    NSLog(@"Tapped cell at %@!", NSStringFromCGPoint(touchLocation));
+}
+
 @end

JSQMessagesViewController/Controllers/JSQMessagesViewController.m

@@ -516,6 +516,19 @@ - (void)messagesCollectionViewCellDidTapAvatar:(JSQMessagesCollectionViewCell *)
                                      atIndexPath:[self.collectionView indexPathForCell:cell]];
 }
 
+- (void)messagesCollectionViewCellDidTapMessageBubble:(JSQMessagesCollectionViewCell *)cell
+{
+    [self.collectionView.delegate collectionView:self.collectionView
+                  didTapMessageBubbleAtIndexPath:[self.collectionView indexPathForCell:cell]];
+}
+
+- (void)messagesCollectionViewCellDidTapCell:(JSQMessagesCollectionViewCell *)cell atPosition:(CGPoint)position
+{
+    [self.collectionView.delegate collectionView:self.collectionView
+                           didTapCellAtIndexPath:[self.collectionView indexPathForCell:cell]
+                                   touchLocation:position];
+}
+
 #pragma mark - Input toolbar delegate
 
 - (void)messagesInputToolbar:(JSQMessagesInputToolbar *)toolbar didPressLeftBarButton:(UIButton *)sender

JSQMessagesViewController/Views/JSQMessagesCollectionView.h

@@ -208,6 +208,32 @@
  didTapAvatarImageView:(UIImageView *)avatarImageView
            atIndexPath:(NSIndexPath *)indexPath;
 
+/**
+ *  Notifies the delegate that the message bubble at the specified indexPath did receive a tap event.
+ *
+ *  @param collectionView The collection view object that is notifying you of the tap event.
+ *  @param indexPath      The index path of the item for which the message bubble was tapped.
+ */
+- (void)collectionView:(JSQMessagesCollectionView *)collectionView didTapMessageBubbleAtIndexPath:(NSIndexPath *)indexPath;
+
+/**
+ *  Notifies the delegate that the cell at the specified indexPath did receive a tap event at the specified touchLocation.
+ *
+ *  @param collectionView The collection view object that is notifying you of the tap event.
+ *  @param indexPath      The index path of the item for which the message bubble was tapped.
+ *  @param touchLocation  The location of the touch event in the cell's coordinate system.
+ *
+ *  @warning This method is *only* called if position is *not* within the bounds of the cell's
+ *  avatar image view or message bubble image view. In other words, this method is *not* called when the cell's
+ *  avatar or message bubble are tapped. There are separate delegate methods for these two cases.
+ *
+ *  @see `collectionView:didTapAvatarImageView:atIndexPath:`
+ *  @see `collectionView:didTapMessageBubbleAtIndexPath:atIndexPath:`
+ */
+- (void)collectionView:(JSQMessagesCollectionView *)collectionView
+ didTapCellAtIndexPath:(NSIndexPath *)indexPath
+         touchLocation:(CGPoint)touchLocation;
+
 /**
  *  Notifies the delegate that the collection view's header did receive a tap event.
  *

JSQMessagesViewController/Views/JSQMessagesCollectionViewCell.h

@@ -31,12 +31,34 @@
 @required
 
 /**
- *  Tells the delegate that the avatarImageView of a cell has been tapped.
+ *  Tells the delegate that the avatarImageView of the cell has been tapped.
  *
- *  @param cell The cell that received the tap.
+ *  @param cell The cell that received the tap touch event.
  */
 - (void)messagesCollectionViewCellDidTapAvatar:(JSQMessagesCollectionViewCell *)cell;
 
+/**
+ *  Tells the delegate that the message bubble of the cell has been tapped.
+ *
+ *  @param cell The cell that received the tap touch event.
+ */
+- (void)messagesCollectionViewCellDidTapMessageBubble:(JSQMessagesCollectionViewCell *)cell;
+
+/**
+ *  Tells the delegate that the cell has been tapped at the point specified by position.
+ *
+ *  @param cell The cell that received the tap touch event.
+ *  @param position The location of the received touch in the cell's coordinate system.
+ *
+ *  @discussion This method is *only* called if position is *not* within the bounds of the cell's
+ *  avatar image view or message bubble image view. In other words, this method is *not* called when the cell's
+ *  avatar or message bubble are tapped.
+ *
+ *  @see `messagesCollectionViewCellDidTapAvatar:`
+ *  @see `messagesCollectionViewCellDidTapMessageBubble:`
+ */
+- (void)messagesCollectionViewCellDidTapCell:(JSQMessagesCollectionViewCell *)cell atPosition:(CGPoint)position;
+
 @end
 
 

JSQMessagesViewController/Views/JSQMessagesCollectionViewCell.m

@@ -131,7 +131,7 @@ - (void)awakeFromNib
     self.longPressGestureRecognizer = longPress;
 
     UITapGestureRecognizer *tap = [[UITapGestureRecognizer alloc] initWithTarget:self action:@selector(jsq_handleTapGesture:)];
-    [self.avatarContainerView addGestureRecognizer:tap];
+    [self addGestureRecognizer:tap];
     self.tapGestureRecognizer = tap;
 }
 
@@ -363,7 +363,17 @@ - (void)jsq_handleLongPressGesture:(UILongPressGestureRecognizer *)longPress
 
 - (void)jsq_handleTapGesture:(UITapGestureRecognizer *)tap
 {
-    [self.delegate messagesCollectionViewCellDidTapAvatar:self];
+    CGPoint touchPt = [tap locationInView:self];
+    
+    if (CGRectContainsPoint(self.avatarContainerView.frame, touchPt)) {
+        [self.delegate messagesCollectionViewCellDidTapAvatar:self];
+    }
+    else if (CGRectContainsPoint(self.messageBubbleContainerView.frame, touchPt)) {
+        [self.delegate messagesCollectionViewCellDidTapMessageBubble:self];
+    }
+    else {
+        [self.delegate messagesCollectionViewCellDidTapCell:self atPosition:touchPt];
+    }
 }
 
 #pragma mark - Notifications