@astrocreep/capacitor-textinteraction

Toggle text interaction in Capacitor based iOS apps.

Background: Apple reintroduced the magnifier lens with iOS 15. There are two different ways how this function is triggered. Either by longpressing on a text element or by double tap and hold. You can disable the longpress version in CSS via -webkit-user-select: none;, but this won't work for the double tap and hold. As I'm using Capacitor for games, the lens is the last thing I want to pop up while playing the game 😇

Install

npm install @astrocreep/capacitor-textinteraction
npx cap sync

API

• toggle(...)
• Interfaces

toggle(...)

toggle(options: TextInteractionOptions) => Promise<TextInteractionResult>

Toggle text interaction (selection) on the Capacitor WebView.

⚠️ As long as you disable text interaction, you won't be able to use any input fields in the WebView. Either disable while text input is active or use native text input overlays.

| Param | Type | | ------------- | ------------------------------------------------------------------------- | | options | TextInteractionOptions |

Returns: Promise<TextInteractionResult>

Since: 1.0.0

Interfaces

TextInteractionResult

| Prop | Type | Description | Since | | ------------- | -------------------- | ------------------------------------------------ | ----- | | success | boolean | true if supported (>= iOS 14.5), false if not | 1.0.0 |

TextInteractionOptions

| Prop | Type | Description | Since | | ------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ----- | | enabled | boolean | Whether text interaction should be enabled or disabled. Disabling suppresses the magnifier lens that Apple reintroduced with iOS 15. iOS only | 1.0.0 |