react-native-advanced-text 0.2.15 → 0.2.17

package/README.md

@@ -38,6 +38,11 @@ import { AdvancedText } from "react-native-advanced-text";
       highlightColor: '#6baeffb5',
       borderRadius: 6,
     },
+    {
+      index: 7,
+      highlightColor: '#818CF8',
+      underline: true, // a line under the word instead of a background
+    },
   ]}
   fontSize={24}
   color={'#FFFFFF'}
@@ -47,6 +52,22 @@ import { AdvancedText } from "react-native-advanced-text";
 />
 ```
 
+## Word gestures
+
+| Prop | Fires on | Notes |
+| --- | --- | --- |
+| `onWordPress` | a tap on a word | `{ word, index }` |
+| `onWordDoublePress` | a double tap on a word | `{ word, index }`. A double tap never selects text. While this is set, a single tap waits out the double-tap delay (~300 ms) before `onWordPress`, so a double tap doesn't also fire it. |
+| `onWordLongPress` | a long press on a word | `{ word, index }`. Text selection still starts as usual. |
+| `onSelection` | the selection menu | `{ selectedText, event, startWordIndex, endWordIndex }`: the menu option, and the first and last word index the selection touches (`-1` if none). |
+
+## Underlined words
+
+An entry in `highlightedWords` with `underline: true` draws a line under the
+word in `highlightColor` instead of filling its background (`borderRadius` is
+ignored). A word can be both highlighted and underlined: list it twice, once
+with `underline: true` and once without.
+
 ## Sizing
 
 `AdvancedText` measures its own height, like React Native's built‑in `<Text>`.

package/android/src/main/java/com/advancedtext/AdvancedTextView.kt

@@ -24,6 +24,7 @@ import android.view.Menu
 import android.view.MenuItem
 import android.view.View
 import android.view.MotionEvent
+import android.view.ViewConfiguration
 import android.view.accessibility.AccessibilityNodeInfo
 import android.widget.TextView
 import com.facebook.react.bridge.Arguments
@@ -40,6 +41,8 @@ class AdvancedTextView : TextView {
     private var highlightedWords: List<HighlightedWord> = emptyList()
     private var menuOptions: List<String> = emptyList()
     private var lastSelectedText: String = ""
+    // First and last word index the selection touches, -1 for none.
+    private var lastSelectedWords: Pair<Int, Int> = -1 to -1
     private var customActionMode: ActionMode? = null
     private var currentText: String = ""
     private var textColor: String = "#000000"
@@ -66,6 +69,24 @@ class AdvancedTextView : TextView {
     private val rangePath = Path()
     private val lineClipPath = Path()
     private val rangeBounds = RectF()
+    private val underlineBounds = RectF()
+
+    // Double taps are only told apart while the app handles them
+    // (onWordDoublePress); otherwise a tap fires onWordPress at once.
+    private var wordDoublePressEnabled = false
+    private val doubleTapTimeout = ViewConfiguration.getDoubleTapTimeout().toLong()
+    private var doubleTapSlopSquare = 0
+    private var lastTapUpTime = 0L
+    private var lastTapUpX = 0f
+    private var lastTapUpY = 0f
+    // From a double tap's second touch down to its up. The TextView never sees
+    // those events, so it can't select the word as it would on a double tap.
+    private var handlingDoubleTap = false
+    // A tap's onWordPress, held back while a second tap could still come.
+    private var pendingWordPress: Runnable? = null
+    private var lastDownX = 0f
+    private var lastDownY = 0f
+    private var longPressed = false
 
     constructor(context: Context?) : super(context) { init() }
     constructor(context: Context?, attrs: AttributeSet?) : super(context, attrs) { init() }
@@ -92,6 +113,19 @@ class AdvancedTextView : TextView {
 
         movementMethod = SmartMovementMethod
 
+        val slop = ViewConfiguration.get(context).scaledDoubleTapSlop
+        doubleTapSlopSquare = slop * slop
+
+        // Reports the word, then returns false so the TextView still starts a
+        // selection as usual.
+        setOnLongClickListener {
+            longPressed = true
+            wordAt(lastDownX, lastDownY)?.let {
+                sendWordEvent("onWordLongPress", it.word, it.index)
+            }
+            false
+        }
+
         customSelectionActionModeCallback = object : ActionMode.Callback {
             override fun onCreateActionMode(mode: ActionMode?, menu: Menu?): Boolean {
                 customActionMode = mode
@@ -106,6 +140,7 @@ class AdvancedTextView : TextView {
 
                 if (selectionStart >= 0 && selectionEnd >= 0 && selectionStart != selectionEnd) {
                     lastSelectedText = text.subSequence(selectionStart, selectionEnd).toString()
+                    lastSelectedWords = wordIndexRange(selectionStart, selectionEnd)
 
                     menuOptions.forEachIndexed { index, option ->
                         menu?.add(0, index, index, option)
@@ -394,14 +429,25 @@ class AdvancedTextView : TextView {
 
         highlightedWords.forEach { highlightedWord ->
             val wordPos = wordPositions.find { it.index == highlightedWord.index } ?: return@forEach
-            drawRangeBackground(
-                canvas,
-                currentLayout,
-                wordPos.start,
-                wordPos.extendedEnd.coerceAtMost(currentText.length),
-                parseColor(highlightedWord.highlightColor),
-                highlightedWord.borderRadius * density
-            )
+            if (highlightedWord.underline) {
+                // The word, but not the space after it.
+                drawRangeUnderline(
+                    canvas,
+                    currentLayout,
+                    wordPos.start,
+                    wordPos.end.coerceAtMost(currentText.length),
+                    parseColor(highlightedWord.highlightColor)
+                )
+            } else {
+                drawRangeBackground(
+                    canvas,
+                    currentLayout,
+                    wordPos.start,
+                    wordPos.extendedEnd.coerceAtMost(currentText.length),
+                    parseColor(highlightedWord.highlightColor),
+                    highlightedWord.borderRadius * density
+                )
+            }
         }
 
         // Draw indicator background only in Highlight mode
@@ -420,10 +466,7 @@ class AdvancedTextView : TextView {
         }
     }
 
-    // Fills the background of text[start, end), one box per line. The edges
-    // come from Layout.getSelectionPath, which follows the text's direction:
-    // a right-to-left word (Arabic) starts at its right edge, so treating
-    // getPrimaryHorizontal(start) as the left edge drew boxes in the wrong place.
+    // Fills the background of text[start, end), one box per line.
     private fun drawRangeBackground(
         canvas: Canvas,
         layout: Layout,
@@ -432,8 +475,44 @@ class AdvancedTextView : TextView {
         color: Int,
         radius: Float
     ) {
-        if (start >= end) return
         highlightPaint.color = color
+        forEachLineOfRange(layout, start, end) {
+            canvas.drawRoundRect(rangeBounds, radius, radius, highlightPaint)
+        }
+    }
+
+    // Draws a line under text[start, end), one per line it spans, just below
+    // the baseline like a text underline.
+    private fun drawRangeUnderline(
+        canvas: Canvas,
+        layout: Layout,
+        start: Int,
+        end: Int,
+        color: Int
+    ) {
+        val density = resources.displayMetrics.density
+        val thickness = UNDERLINE_THICKNESS_DP * density
+        val gap = UNDERLINE_GAP_DP * density
+        highlightPaint.color = color
+        forEachLineOfRange(layout, start, end) { line ->
+            val top = layout.getLineBaseline(line) + totalPaddingTop + gap
+            underlineBounds.set(rangeBounds.left, top, rangeBounds.right, top + thickness)
+            canvas.drawRoundRect(underlineBounds, thickness / 2, thickness / 2, highlightPaint)
+        }
+    }
+
+    // Calls draw for each line text[start, end) spans, with rangeBounds set to
+    // that line's part of the range in view coordinates. The edges come from
+    // Layout.getSelectionPath, which follows the text's direction: a
+    // right-to-left word (Arabic) starts at its right edge, so treating
+    // getPrimaryHorizontal(start) as the left edge put boxes in the wrong place.
+    private inline fun forEachLineOfRange(
+        layout: Layout,
+        start: Int,
+        end: Int,
+        draw: (line: Int) -> Unit
+    ) {
+        if (start >= end) return
 
         val startLine = layout.getLineForOffset(start)
         val endLine = layout.getLineForOffset(end - 1)
@@ -461,7 +540,7 @@ class AdvancedTextView : TextView {
             if (rangeBounds.isEmpty) continue
 
             rangeBounds.offset(totalPaddingLeft.toFloat(), totalPaddingTop.toFloat())
-            canvas.drawRoundRect(rangeBounds, radius, radius, highlightPaint)
+            draw(line)
         }
     }
 
@@ -480,6 +559,8 @@ class AdvancedTextView : TextView {
             val event = Arguments.createMap().apply {
                 putString("selectedText", selectedText)
                 putString("event", eventType)
+                putInt("startWordIndex", lastSelectedWords.first)
+                putInt("endWordIndex", lastSelectedWords.second)
             }
 
             reactContext.getJSModule(RCTEventEmitter::class.java)
@@ -496,7 +577,18 @@ class AdvancedTextView : TextView {
 
         override fun onClick(widget: View) {
             Log.d(TAG, "Word clicked: '$word' (index=$wordIndex)")
-            sendWordPressEvent(word, wordIndex)
+            if (!wordDoublePressEnabled) {
+                sendWordEvent("onWordPress", word, wordIndex)
+                return
+            }
+            // Wait to see whether this is the first tap of a double tap.
+            cancelPendingWordPress()
+            val press = Runnable {
+                pendingWordPress = null
+                sendWordEvent("onWordPress", word, wordIndex)
+            }
+            pendingWordPress = press
+            postDelayed(press, doubleTapTimeout)
         }
 
         // Skips super, which would paint the word in the link color and
@@ -506,7 +598,8 @@ class AdvancedTextView : TextView {
         }
     }
 
-    private fun sendWordPressEvent(word: String, index: Int) {
+    // onWordPress, onWordDoublePress or onWordLongPress.
+    private fun sendWordEvent(eventName: String, word: String, index: Int) {
         try {
             val reactContext = context as? ReactContext ?: return
             val event = Arguments.createMap().apply {
@@ -515,10 +608,102 @@ class AdvancedTextView : TextView {
             }
 
             reactContext.getJSModule(RCTEventEmitter::class.java)
-                .receiveEvent(id, "onWordPress", event)
+                .receiveEvent(id, eventName, event)
         } catch (e: Exception) {
-            Log.e(TAG, "Error sending word press event", e)
+            Log.e(TAG, "Error sending $eventName event", e)
+        }
+    }
+
+    fun setWordDoublePressEnabled(enabled: Boolean) {
+        if (wordDoublePressEnabled == enabled) return
+        wordDoublePressEnabled = enabled
+        lastTapUpTime = 0L
+        // A tap held back for a double tap fires now instead of being lost.
+        pendingWordPress?.let {
+            removeCallbacks(it)
+            it.run()
+        }
+    }
+
+    override fun onTouchEvent(event: MotionEvent): Boolean {
+        when (event.actionMasked) {
+            MotionEvent.ACTION_DOWN -> {
+                lastDownX = event.x
+                lastDownY = event.y
+                longPressed = false
+                if (wordDoublePressEnabled && isSecondTap(event)) {
+                    cancelPendingWordPress()
+                    handlingDoubleTap = true
+                    return true
+                }
+            }
+            MotionEvent.ACTION_UP -> if (handlingDoubleTap) {
+                handlingDoubleTap = false
+                lastTapUpTime = 0L
+                wordAt(event.x, event.y)?.let {
+                    sendWordEvent("onWordDoublePress", it.word, it.index)
+                }
+                return true
+            }
+            MotionEvent.ACTION_CANCEL -> if (handlingDoubleTap) {
+                handlingDoubleTap = false
+                lastTapUpTime = 0L
+                return true
+            }
         }
+        if (handlingDoubleTap) return true
+
+        val handled = super.onTouchEvent(event)
+        if (event.actionMasked == MotionEvent.ACTION_UP) {
+            // A long press isn't the first tap of a double tap.
+            if (longPressed) {
+                lastTapUpTime = 0L
+            } else {
+                lastTapUpTime = event.eventTime
+                lastTapUpX = event.x
+                lastTapUpY = event.y
+            }
+        }
+        return handled
+    }
+
+    override fun onDetachedFromWindow() {
+        cancelPendingWordPress()
+        super.onDetachedFromWindow()
+    }
+
+    private fun isSecondTap(down: MotionEvent): Boolean {
+        if (lastTapUpTime == 0L || down.eventTime - lastTapUpTime > doubleTapTimeout) {
+            return false
+        }
+        val dx = down.x - lastTapUpX
+        val dy = down.y - lastTapUpY
+        return dx * dx + dy * dy < doubleTapSlopSquare
+    }
+
+    private fun cancelPendingWordPress() {
+        pendingWordPress?.let { removeCallbacks(it) }
+        pendingWordPress = null
+    }
+
+    // The word under a point in view coordinates, or null for blank space,
+    // including the space past the end of a line.
+    private fun wordAt(x: Float, y: Float): WordPosition? {
+        val currentLayout = layout ?: return null
+        val line = currentLayout.getLineForVertical((y - totalPaddingTop + scrollY).toInt())
+        val lineX = x - totalPaddingLeft + scrollX
+        if (lineX < currentLayout.getLineLeft(line) || lineX > currentLayout.getLineRight(line)) {
+            return null
+        }
+        val offset = getOffsetForPosition(x, y)
+        return wordPositions.find { offset >= it.start && offset <= it.end }
+    }
+
+    // First and last word text[start, end) touches, or -1 to -1 for none.
+    private fun wordIndexRange(start: Int, end: Int): Pair<Int, Int> {
+        val touched = wordPositions.filter { it.start < end && it.end > start }
+        if (touched.isEmpty()) return -1 to -1
+        return touched.first().index to touched.last().index
     }
 
     fun clearSelection() {
@@ -589,5 +774,10 @@ class AdvancedTextView : TextView {
 data class HighlightedWord(
     val index: Int,
     val highlightColor: String,
-    val borderRadius: Float = 0f
+    val borderRadius: Float = 0f,
+    // Draws a line under the word instead of filling its background.
+    val underline: Boolean = false
 )
+
+private const val UNDERLINE_THICKNESS_DP = 1.5f
+private const val UNDERLINE_GAP_DP = 2.5f

package/android/src/main/java/com/advancedtext/AdvancedTextViewManager.kt

@@ -54,7 +54,10 @@ class AdvancedTextViewManager : SimpleViewManager<AdvancedTextView>() {
                                 wordMap.getDouble("borderRadius").toFloat()
                             } else {
                                 0f
-                            }
+                            },
+                            underline = wordMap.hasKey("underline") &&
+                                !wordMap.isNull("underline") &&
+                                wordMap.getBoolean("underline")
                         )
                     )
                 }
@@ -158,9 +161,16 @@ class AdvancedTextViewManager : SimpleViewManager<AdvancedTextView>() {
         view?.setAdvancedLetterSpacing(letterSpacing)
     }
 
+    @ReactProp(name = "wordDoublePressEnabled")
+    fun setWordDoublePressEnabled(view: AdvancedTextView?, enabled: Boolean) {
+        view?.setWordDoublePressEnabled(enabled)
+    }
+
     override fun getExportedCustomDirectEventTypeConstants(): Map<String, Any> {
         return mapOf(
             "onWordPress" to mapOf("registrationName" to "onWordPress"),
+            "onWordDoublePress" to mapOf("registrationName" to "onWordDoublePress"),
+            "onWordLongPress" to mapOf("registrationName" to "onWordLongPress"),
             "onSelection" to mapOf("registrationName" to "onSelection")
         )
     }

package/ios/AdvancedTextView.mm

@@ -31,6 +31,9 @@ static UIFont *ATResolveFont(NSString *family, CGFloat size)
 
 @property (nonatomic, strong) NSMutableArray<NSDictionary *> *wordRanges;
 @property (nonatomic, strong) NSMutableDictionary<NSNumber *, NSDictionary *> *highlightStyles;
+// Underline colors by word index, kept apart from highlightStyles so a word
+// can be both highlighted and underlined.
+@property (nonatomic, strong) NSMutableDictionary<NSNumber *, UIColor *> *underlineStyles;
 @property (nonatomic, strong) NSArray<NSString *> *menuOptions;
 @property (nonatomic, assign) CGFloat fontSize;
 @property (nonatomic, strong) NSString *fontWeight;
@@ -88,6 +91,11 @@ static UIFont *ATResolveFont(NSString *family, CGFloat size)
 @interface AdvancedTextView () <RCTAdvancedTextViewViewProtocol, UIGestureRecognizerDelegate, UITextViewDelegate>
 
 @property (nonatomic, strong) CustomTextView *textView;
+@property (nonatomic, strong) UITapGestureRecognizer *singleTapGesture;
+@property (nonatomic, strong) UITapGestureRecognizer *doubleTapGesture;
+@property (nonatomic, strong) UILongPressGestureRecognizer *longPressGesture;
+// On while the app handles double taps (onWordDoublePress).
+@property (nonatomic, assign) BOOL wordDoublePressEnabled;
 
 @end
 
@@ -109,6 +117,7 @@ static UIFont *ATResolveFont(NSString *family, CGFloat size)
 
             _wordRanges = [NSMutableArray array];
             _highlightStyles = [NSMutableDictionary dictionary];
+            _underlineStyles = [NSMutableDictionary dictionary];
             _fontSize = 16.0;
             _fontWeight = @"normal";
             _textColor = [UIColor labelColor];
@@ -173,6 +182,24 @@ static UIFont *ATResolveFont(NSString *family, CGFloat size)
                                               action:@selector(handleTap:)];
         tapGesture.delegate = self;
         [_textView addGestureRecognizer:tapGesture];
+        _singleTapGesture = tapGesture;
+
+        // Off until the app handles double taps, so taps aren't delayed.
+        UITapGestureRecognizer *doubleTapGesture = [[UITapGestureRecognizer alloc]
+                                                    initWithTarget:self
+                                                    action:@selector(handleDoubleTap:)];
+        doubleTapGesture.numberOfTapsRequired = 2;
+        doubleTapGesture.delegate = self;
+        doubleTapGesture.enabled = NO;
+        [_textView addGestureRecognizer:doubleTapGesture];
+        _doubleTapGesture = doubleTapGesture;
+
+        UILongPressGestureRecognizer *longPressGesture = [[UILongPressGestureRecognizer alloc]
+                                                          initWithTarget:self
+                                                          action:@selector(handleLongPress:)];
+        longPressGesture.delegate = self;
+        [_textView addGestureRecognizer:longPressGesture];
+        _longPressGesture = longPressGesture;
 
         NSLog(@"[AdvancedTextView] Gesture recognizers setup successful");
     } @catch (NSException *exception) {
@@ -224,6 +251,11 @@ static UIFont *ATResolveFont(NSString *family, CGFloat size)
             styleChanged = YES;
         }
 
+        if (oldViewProps.wordDoublePressEnabled != newViewProps.wordDoublePressEnabled) {
+            _wordDoublePressEnabled = newViewProps.wordDoublePressEnabled;
+            _doubleTapGesture.enabled = _wordDoublePressEnabled;
+        }
+
         if (oldViewProps.text != newViewProps.text) {
             textChanged = YES;
             NSLog(@"[AdvancedTextView] Text changed");
@@ -237,7 +269,8 @@ static UIFont *ATResolveFont(NSString *family, CGFloat size)
                 const auto &newHW = newViewProps.highlightedWords[i];
                 if (oldHW.index != newHW.index ||
                     oldHW.highlightColor != newHW.highlightColor ||
-                    oldHW.borderRadius != newHW.borderRadius) {
+                    oldHW.borderRadius != newHW.borderRadius ||
+                    oldHW.underline != newHW.underline) {
                     highlightsChanged = YES;
                     break;
                 }
@@ -410,6 +443,7 @@ static UIFont *ATResolveFont(NSString *family, CGFloat size)
           highlightedWords.size());
     @try {
         [_highlightStyles removeAllObjects];
+        [_underlineStyles removeAllObjects];
 
         for (const auto &hw : highlightedWords) {
             NSInteger index = hw.index;
@@ -417,7 +451,9 @@ static UIFont *ATResolveFont(NSString *family, CGFloat size)
             UIColor *color = [self hexStringToColor:colorString];
             CGFloat borderRadius = static_cast<CGFloat>(hw.borderRadius);
 
-            if (color) {
+            if (color && hw.underline) {
+                _underlineStyles[@(index)] = color;
+            } else if (color) {
                 _highlightStyles[@(index)] = @{
                     @"color": color,
                     @"borderRadius": @(MAX(borderRadius, 0.0))
@@ -499,6 +535,7 @@ static UIFont *ATResolveFont(NSString *family, CGFloat size)
 
 
         [self applyWordColorsToString:attributedString];
+        [self applyUnderlinesToString:attributedString];
 
         _textView.attributedText = attributedString;
         [_textView setNeedsDisplay];
@@ -545,6 +582,29 @@ static UIFont *ATResolveFont(NSString *family, CGFloat size)
     }
 }
 
+// A text underline under each underlined word, but not the space after it.
+- (void)applyUnderlinesToString:(NSMutableAttributedString *)string
+{
+    if (_underlineStyles.count == 0) {
+        return;
+    }
+
+    for (NSDictionary *wordInfo in _wordRanges) {
+        UIColor *color = _underlineStyles[wordInfo[@"index"]];
+        if (!color) {
+            continue;
+        }
+        NSRange wordRange = [wordInfo[@"range"] rangeValue];
+        if (NSMaxRange(wordRange) > string.length) {
+            break;
+        }
+        [string addAttributes:@{
+            NSUnderlineStyleAttributeName: @(NSUnderlineStyleSingle),
+            NSUnderlineColorAttributeName: color
+        } range:wordRange];
+    }
+}
+
 // Recolors the live textStorage instead of reassigning attributedText, so the
 // indicator can advance while the user is selecting text: attribute-only
 // edits keep selectedRange and the edit menu, assigning attributedText resets them.
@@ -661,6 +721,89 @@ static UIFont *ATResolveFont(NSString *family, CGFloat size)
     }
 }
 
+- (void)handleDoubleTap:(UITapGestureRecognizer *)gesture
+{
+    @try {
+        if (gesture.state != UIGestureRecognizerStateEnded) return;
+
+        // In case the text view selected anything before giving way.
+        _textView.selectedTextRange = nil;
+
+        NSInteger wordIndex = [self wordIndexAtPoint:[gesture locationInView:_textView]];
+        if (wordIndex >= 0 && wordIndex < _wordRanges.count) {
+            [self emitWordEvent:@"doublePress" word:_wordRanges[wordIndex][@"word"] index:wordIndex];
+        }
+    } @catch (NSException *exception) {
+        NSLog(@"[AdvancedTextView] Exception in handleDoubleTap: %@", exception);
+    }
+}
+
+// Only reports the word: the text view's own long press still starts a selection.
+- (void)handleLongPress:(UILongPressGestureRecognizer *)gesture
+{
+    @try {
+        if (gesture.state != UIGestureRecognizerStateBegan) return;
+
+        NSInteger wordIndex = [self wordIndexAtPoint:[gesture locationInView:_textView]];
+        if (wordIndex >= 0 && wordIndex < _wordRanges.count) {
+            [self emitWordEvent:@"longPress" word:_wordRanges[wordIndex][@"word"] index:wordIndex];
+        }
+    } @catch (NSException *exception) {
+        NSLog(@"[AdvancedTextView] Exception in handleLongPress: %@", exception);
+    }
+}
+
+#pragma mark - UIGestureRecognizerDelegate
+
+// While double taps are handled, a single tap waits to see whether a second
+// one follows, so a double tap doesn't also fire onWordPress.
+- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer
+    shouldRequireFailureOfGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer
+{
+    return _wordDoublePressEnabled &&
+        gestureRecognizer == _singleTapGesture &&
+        otherGestureRecognizer == _doubleTapGesture;
+}
+
+// The text view's own double tap selects the word. It waits for ours, which
+// wins on every double tap, so a double tap never selects text.
+- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer
+    shouldBeRequiredToFailByGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer
+{
+    if (!_wordDoublePressEnabled || gestureRecognizer != _doubleTapGesture) {
+        return NO;
+    }
+    if (![otherGestureRecognizer isKindOfClass:[UITapGestureRecognizer class]]) {
+        return NO;
+    }
+    return ((UITapGestureRecognizer *)otherGestureRecognizer).numberOfTapsRequired >= 2;
+}
+
+// The long press runs alongside the text view's own, which starts the selection.
+- (BOOL)gestureRecognizer:(UIGestureRecognizer *)gestureRecognizer
+    shouldRecognizeSimultaneouslyWithGestureRecognizer:(UIGestureRecognizer *)otherGestureRecognizer
+{
+    return gestureRecognizer == _longPressGesture || otherGestureRecognizer == _longPressGesture;
+}
+
+// The first and last word a character range touches, or -1 for none.
+- (void)wordIndexesForRange:(NSRange)range first:(NSInteger *)first last:(NSInteger *)last
+{
+    *first = -1;
+    *last = -1;
+    for (NSDictionary *wordInfo in _wordRanges) {
+        NSRange wordRange = [wordInfo[@"range"] rangeValue];
+        if (NSIntersectionRange(wordRange, range).length == 0) {
+            continue;
+        }
+        NSInteger index = [wordInfo[@"index"] integerValue];
+        if (*first < 0) {
+            *first = index;
+        }
+        *last = index;
+    }
+}
+
 #pragma mark - UITextViewDelegate
 
 - (void)textViewDidChangeSelection:(UITextView *)textView
@@ -783,6 +926,29 @@ static UIFont *ATResolveFont(NSString *family, CGFloat size)
     }
 }
 
+// onWordDoublePress ("doublePress") or onWordLongPress ("longPress").
+- (void)emitWordEvent:(NSString *)type word:(NSString *)word index:(NSInteger)index
+{
+    @try {
+        if (!_eventEmitter) return;
+        auto emitter = std::static_pointer_cast<const AdvancedTextViewEventEmitter>(_eventEmitter);
+
+        if ([type isEqualToString:@"doublePress"]) {
+            AdvancedTextViewEventEmitter::OnWordDoublePress event;
+            event.word = [word UTF8String];
+            event.index = static_cast<int>(index);
+            emitter->onWordDoublePress(event);
+        } else {
+            AdvancedTextViewEventEmitter::OnWordLongPress event;
+            event.word = [word UTF8String];
+            event.index = static_cast<int>(index);
+            emitter->onWordLongPress(event);
+        }
+    } @catch (NSException *exception) {
+        NSLog(@"[AdvancedTextView] Exception in emitWordEvent: %@", exception);
+    }
+}
+
 - (void)emitSelectionEvent:(NSString *)selectedText menuOption:(NSString *)option
 {
     NSLog(@"[AdvancedTextView] emitSelectionEvent: %@ with option: %@", selectedText, option);
@@ -790,9 +956,15 @@ static UIFont *ATResolveFont(NSString *family, CGFloat size)
         if (_eventEmitter) {
             auto emitter = std::static_pointer_cast<const AdvancedTextViewEventEmitter>(_eventEmitter);
 
+            NSInteger firstWord = -1;
+            NSInteger lastWord = -1;
+            [self wordIndexesForRange:_textView.selectedRange first:&firstWord last:&lastWord];
+
             AdvancedTextViewEventEmitter::OnSelection event;
             event.selectedText = [selectedText UTF8String];
             event.event = [option UTF8String];
+            event.startWordIndex = static_cast<int>(firstWord);
+            event.endWordIndex = static_cast<int>(lastWord);
 
             emitter->onSelection(event);
         }

package/lib/module/AdvancedText.js

@@ -9,6 +9,8 @@ export const AdvancedText = ({
   highlightedWords,
   menuOptions,
   onWordPress,
+  onWordDoublePress,
+  onWordLongPress,
   onSelection,
   ...restProps
 }) => {
@@ -19,7 +21,12 @@ export const AdvancedText = ({
     highlightedWords: highlightedWords,
     menuOptions: menuOptions,
     onWordPress: onWordPress,
+    onWordDoublePress: onWordDoublePress,
+    onWordLongPress: onWordLongPress,
     onSelection: onSelection
+    // Only apps that handle double taps pay the single-tap delay.
+    ,
+    wordDoublePressEnabled: !!onWordDoublePress
   });
 };
 //# sourceMappingURL=AdvancedText.js.map

package/lib/module/AdvancedText.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","AdvancedTextViewNativeComponent","jsx","_jsx","AdvancedText","text","style","highlightedWords","menuOptions","onWordPress","onSelection","restProps"],"sourceRoot":"../../src","sources":["AdvancedText.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,OAAOC,+BAA+B,MAE/B,mCAAmC;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAE3C,OAAO,MAAMC,YAAmC,GAAGA,CAAC;EAClDC,IAAI;EACJC,KAAK;EACLC,gBAAgB;EAChBC,WAAW;EACXC,WAAW;EACXC,WAAW;EACX,GAAGC;AACL,CAAC,KAAK;EACJ,oBACER,IAAA,CAACF,+BAA+B;IAAA,GAC1BU,SAAS;IACbL,KAAK,EAAEA,KAAM;IACbD,IAAI,EAAEA,IAAK;IACXE,gBAAgB,EAAEA,gBAAiB;IACnCC,WAAW,EAAEA,WAAY;IACzBC,WAAW,EAAEA,WAAY;IACzBC,WAAW,EAAEA;EAAY,CAC1B,CAAC;AAEN,CAAC","ignoreList":[]}
+{"version":3,"names":["React","AdvancedTextViewNativeComponent","jsx","_jsx","AdvancedText","text","style","highlightedWords","menuOptions","onWordPress","onWordDoublePress","onWordLongPress","onSelection","restProps","wordDoublePressEnabled"],"sourceRoot":"../../src","sources":["AdvancedText.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,OAAOC,+BAA+B,MAE/B,mCAAmC;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAE3C,OAAO,MAAMC,YAAmC,GAAGA,CAAC;EAClDC,IAAI;EACJC,KAAK;EACLC,gBAAgB;EAChBC,WAAW;EACXC,WAAW;EACXC,iBAAiB;EACjBC,eAAe;EACfC,WAAW;EACX,GAAGC;AACL,CAAC,KAAK;EACJ,oBACEV,IAAA,CAACF,+BAA+B;IAAA,GAC1BY,SAAS;IACbP,KAAK,EAAEA,KAAM;IACbD,IAAI,EAAEA,IAAK;IACXE,gBAAgB,EAAEA,gBAAiB;IACnCC,WAAW,EAAEA,WAAY;IACzBC,WAAW,EAAEA,WAAY;IACzBC,iBAAiB,EAAEA,iBAAkB;IACrCC,eAAe,EAAEA,eAAgB;IACjCC,WAAW,EAAEA;IACb;IAAA;IACAE,sBAAsB,EAAE,CAAC,CAACJ;EAAkB,CAC7C,CAAC;AAEN,CAAC","ignoreList":[]}

package/lib/module/AdvancedTextViewNativeComponent.ts

@@ -8,6 +8,9 @@ interface HighlightedWord {
   index: Int32;
   highlightColor: string;
   borderRadius?: Float;
+  // Underlines the word in highlightColor instead of filling its background.
+  // A word can have both: list it once with and once without.
+  underline?: boolean;
 }
 
 export interface NativeProps extends ViewProps {
@@ -15,7 +18,21 @@ export interface NativeProps extends ViewProps {
   highlightedWords?: ReadonlyArray<HighlightedWord>;
   menuOptions?: ReadonlyArray<string>;
   onWordPress?: DirectEventHandler<{ word: string; index: Int32 }>;
-  onSelection?: DirectEventHandler<{ selectedText: string; event: string }>;
+  // A double tap on a word. It never selects text.
+  onWordDoublePress?: DirectEventHandler<{ word: string; index: Int32 }>;
+  // A long press on a word. Text selection still starts as usual.
+  onWordLongPress?: DirectEventHandler<{ word: string; index: Int32 }>;
+  // startWordIndex/endWordIndex: the first and last word the selection
+  // touches, or -1 when it touches none.
+  onSelection?: DirectEventHandler<{
+    selectedText: string;
+    event: string;
+    startWordIndex: Int32;
+    endWordIndex: Int32;
+  }>;
+  // Set by AdvancedText when onWordDoublePress is given. While on, a single
+  // tap waits out the double-tap delay before firing onWordPress.
+  wordDoublePressEnabled?: boolean;
   fontSize?: Int32;
   fontWeight?: string;
   color?: string;

package/lib/typescript/src/AdvancedText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdvancedText.d.ts","sourceRoot":"","sources":["../../../src/AdvancedText.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAwC,EACtC,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAE3C,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CAoB9C,CAAC"}
+{"version":3,"file":"AdvancedText.d.ts","sourceRoot":"","sources":["../../../src/AdvancedText.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAwC,EACtC,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAE3C,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,CA0B9C,CAAC"}

package/lib/typescript/src/AdvancedTextViewNativeComponent.d.ts

@@ -4,6 +4,7 @@ interface HighlightedWord {
     index: Int32;
     highlightColor: string;
     borderRadius?: Float;
+    underline?: boolean;
 }
 export interface NativeProps extends ViewProps {
     text: string;
@@ -13,10 +14,21 @@ export interface NativeProps extends ViewProps {
         word: string;
         index: Int32;
     }>;
+    onWordDoublePress?: DirectEventHandler<{
+        word: string;
+        index: Int32;
+    }>;
+    onWordLongPress?: DirectEventHandler<{
+        word: string;
+        index: Int32;
+    }>;
     onSelection?: DirectEventHandler<{
         selectedText: string;
         event: string;
+        startWordIndex: Int32;
+        endWordIndex: Int32;
     }>;
+    wordDoublePressEnabled?: boolean;
     fontSize?: Int32;
     fontWeight?: string;
     color?: string;

package/lib/typescript/src/AdvancedTextViewNativeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AdvancedTextViewNativeComponent.d.ts","sourceRoot":"","sources":["../../../src/AdvancedTextViewNativeComponent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAG,KAAK,EAAG,MAAM,2CAA2C,CAAC;AAEpG,UAAU,eAAe;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAClD,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,kBAAkB,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IACjE,WAAW,CAAC,EAAE,kBAAkB,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,kBAAkB,CAAC,EAAE,KAAK,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;;AAED,wBAAuE"}
+{"version":3,"file":"AdvancedTextViewNativeComponent.d.ts","sourceRoot":"","sources":["../../../src/AdvancedTextViewNativeComponent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAG,KAAK,EAAG,MAAM,2CAA2C,CAAC;AAEpG,UAAU,eAAe;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,KAAK,CAAC;IAGrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAClD,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,WAAW,CAAC,EAAE,kBAAkB,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IAEjE,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IAEvE,eAAe,CAAC,EAAE,kBAAkB,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;IAGrE,WAAW,CAAC,EAAE,kBAAkB,CAAC;QAC/B,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,EAAE,KAAK,CAAC;QACtB,YAAY,EAAE,KAAK,CAAC;KACrB,CAAC,CAAC;IAGH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,kBAAkB,CAAC,EAAE,KAAK,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;;AAED,wBAAuE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-advanced-text",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "description": " Advanced text component for React Native with custom select options.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/AdvancedText.tsx

@@ -9,6 +9,8 @@ export const AdvancedText: React.FC<NativeProps> = ({
   highlightedWords,
   menuOptions,
   onWordPress,
+  onWordDoublePress,
+  onWordLongPress,
   onSelection,
   ...restProps
 }) => {
@@ -20,7 +22,11 @@ export const AdvancedText: React.FC<NativeProps> = ({
       highlightedWords={highlightedWords}
       menuOptions={menuOptions}
       onWordPress={onWordPress}
+      onWordDoublePress={onWordDoublePress}
+      onWordLongPress={onWordLongPress}
       onSelection={onSelection}
+      // Only apps that handle double taps pay the single-tap delay.
+      wordDoublePressEnabled={!!onWordDoublePress}
     />
   );
 };

package/src/AdvancedTextViewNativeComponent.ts

@@ -8,6 +8,9 @@ interface HighlightedWord {
   index: Int32;
   highlightColor: string;
   borderRadius?: Float;
+  // Underlines the word in highlightColor instead of filling its background.
+  // A word can have both: list it once with and once without.
+  underline?: boolean;
 }
 
 export interface NativeProps extends ViewProps {
@@ -15,7 +18,21 @@ export interface NativeProps extends ViewProps {
   highlightedWords?: ReadonlyArray<HighlightedWord>;
   menuOptions?: ReadonlyArray<string>;
   onWordPress?: DirectEventHandler<{ word: string; index: Int32 }>;
-  onSelection?: DirectEventHandler<{ selectedText: string; event: string }>;
+  // A double tap on a word. It never selects text.
+  onWordDoublePress?: DirectEventHandler<{ word: string; index: Int32 }>;
+  // A long press on a word. Text selection still starts as usual.
+  onWordLongPress?: DirectEventHandler<{ word: string; index: Int32 }>;
+  // startWordIndex/endWordIndex: the first and last word the selection
+  // touches, or -1 when it touches none.
+  onSelection?: DirectEventHandler<{
+    selectedText: string;
+    event: string;
+    startWordIndex: Int32;
+    endWordIndex: Int32;
+  }>;
+  // Set by AdvancedText when onWordDoublePress is given. While on, a single
+  // tap waits out the double-tap delay before firing onWordPress.
+  wordDoublePressEnabled?: boolean;
   fontSize?: Int32;
   fontWeight?: string;
   color?: string;