Zum Hauptinhalt springen
@capgo/capacitor-textinteraction UI & System Open Source

Textinteraktion Capacitor Plugin

Deaktiviere die Textauswahl und die iOS-Lupe in der Capacitor WebView, wenn sich deine App nativ anfühlen soll, und schalte sie wieder ein, bevor der Nutzer tippen muss.

  • iOS · Unterstützt (iOS 14.5+)
  • Android · Nicht unterstützt (resolves success: false)
  • Web · Nicht unterstützt (wirft unimplemented)

Installieren

bun add @capgo/capacitor-textinteraction bunx cap sync
npm, pnpm oder yarn
  • npm install @capgo/capacitor-textinteraction
  • pnpm add @capgo/capacitor-textinteraction
  • yarn add @capgo/capacitor-textinteraction

Anleitung

Text Interaction in Capacitor nutzen

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

QR-code zur Vorschau des Text Interaction Plugins

Deaktiviere Textauswahl und die Lupe in Capacitor iOS-Apps

@capgo/capacitor-textinteraction ermöglicht es dir, die Textinteraktion für die Capacitor WebView auf iOS mit einem einzigen Aufruf ein- oder auszuschalten. Wenn sie deaktiviert ist, wird Text bei langem Drücken nicht mehr ausgewählt, es erscheint kein Kopier-Callout mehr und auch die Lupe wird nicht mehr eingeblendet, die iOS 15 wieder eingeführt hat. Deine Web-App fühlt sich nicht mehr wie eine Webseite in einer nativen Shell an.

Im Hintergrund setzt das Plugin WKPreferences.isTextInteractionEnabled on the app's WKWebView. Sonst ändert es nichts.

Wann einsetzen

  • Spiele, Kioske und Zeichen-Apps, bei denen Long-Press- und Drag-Gesten niemals Text auswählen sollen.
  • Eigene Long-Press-Menüs, die mit den nativen Auswahlgriffen und dem Callout kollidieren.
  • Media Player, Karten und Carousels, bei denen ein langsamer Swipe versehentlich die Lupe auslöst.
  • Branded, app-like UI wenn auswählbare Labels und Buttons das native Gefühl stören.

Textinteraktion auf Screens aktiv lassen, auf denen Nutzer lange Inhalte lesen, die sie kopieren möchten, oder Formulare ausfüllen.

Installieren

bun add @capgo/capacitor-textinteraction
bunx cap sync

Nein Info.plist Keys, Berechtigungen oder capacitor.config.ts Einträge erforderlich sind.

Plugin-Version Capacitor-Version Gepflegt
v8.x v8.x Ja
v7.x v7.x Bei Bedarf
v6.x und älter v6.x und älter Nein

Textinteraktion beim App-Start deaktivieren

import { Capacitor } from '@capacitor/core';
import { TextInteraction } from '@capgo/capacitor-textinteraction';

if (Capacitor.getPlatform() === 'ios') {
  const { success } = await TextInteraction.toggle({ enabled: false });
  if (!success) console.warn('Text interaction could not be changed on this device');
}

Immer übergeben enabled explizit. Die native Seite behandelt einen fehlenden Wert als false.

Vor der Texteingabe wieder aktivieren

Während die Textinteraktion deaktiviert ist, <input>, <textarea> und contenteditable Elemente akzeptieren keine Eingaben mehr. Aktiviere es für jeden Bildschirm mit einem Formular und deaktiviere es wieder, wenn der Nutzer den Bildschirm verlässt.

import { Capacitor } from '@capacitor/core';
import { TextInteraction } from '@capgo/capacitor-textinteraction';

const isIos = Capacitor.getPlatform() === 'ios';

export async function setTextInteraction(enabled: boolean) {
  if (!isIos) return false;
  const { success } = await TextInteraction.toggle({ enabled });
  return success;
}

// Entering a login, search or checkout screen
await setTextInteraction(true);

// Leaving it
await setTextInteraction(false);

Mit einem Router rufst du setTextInteraction(true) im Enter-Hook von Routen auf, die Eingabefelder enthalten (z. B. Vue Router beforeEnter, ein React useEffect, oder Angular ionViewWillEnter) und setTextInteraction(false) beim Verlassen dieser Routen.

Plugin vs. CSS

You can hide most selection with CSS:

body {
  -webkit-user-select: none;
  user-select: none;
  -webkit-touch-callout: none;
}

input,
textarea,
[contenteditable] {
  -webkit-user-select: text;
  user-select: text;
}

CSS wirkt pro Element, daher bleibt alles, was du vergisst, weiterhin markierbar, und es ändert nichts daran, wie der WebView selbst Langdrücke verarbeitet. Das Plugin arbeitet auf WebView-Ebene: Ein Aufruf deckt jeden Bildschirm ab, einschließlich der Lupe. Viele Apps nutzen beides: das Plugin für app-ähnliche Bildschirme und CSS für die Feinsteuerung innerhalb von Bildschirmen, auf denen Textinteraktion aktiv bleibt.

API-Referenz

toggle(options)

toggle(options: { enabled: boolean }): Promise<{ success: boolean }>

Aktiviert oder deaktiviert die Textinteraktion für die Capacitor WebView.

  • enabled: true stellt die Auswahl, das Callout-Menü und die Lupe wieder her. false deaktiviert diese.
  • success: true wann die Änderung angewendet wurde (iOS 14.5+ mit verfügbarer WebView). false unter Android und wenn keine WebView verfügbar ist.

getPluginVersion()

getPluginVersion(): Promise<{ version: string }>

Gibt die native Plugin-Version zurück. Gibt web im Browser zurück.

Plattformverhalten

Plattform Verhalten
iOS 14.5+ Legt fest isTextInteractionEnabled auf dem WKWebView. Gilt für alle Seiten, bis es erneut umgeschaltet wird.
Android No-op. Wird aufgelöst { success: false }. Nutze CSS, wenn du die Auswahl einschränken willst.
Web toggle wirft einen 'unimplemented'-Error. Schütze Aufrufe mit Capacitor.getPlatform().

Fehlerbehebung

  • Inputs funktionieren nicht mehr. Textinteraktion ist weiterhin deaktiviert. Rufe toggle({ enabled: true }) auf, bevor das Formular angezeigt wird.
  • Auf Android ändert sich nichts. Erwartet. Das Plugin unterstützt nur iOS.
  • TextInteraction.toggle is not available on web. Der Aufruf lief im Browser oder während der Entwicklung in einem Desktop-Browser. Pack ihn in einen Platform-Check.
  • Die Auswahl kommt nach einem App-Neustart zurück. Bei jedem Start wird eine neue WebView mit aktivierter Text-Interaction erstellt. Rufe die Methode toggle({ enabled: false }) beim App-Startup auf.

Änderung ohne App Store Review deployen

Das Umschalten der Textinteraktion erfolgt in JavaScript. Sobald das Plugin in deinem Native Build enthalten ist, kannst du mit einem Capgo live update ändern, anstatt auf die App-Store-Prüfung zu warten.

Vollständige Referenz

FAQ

Text Interaction Plugin FAQ

Wie deaktiviere ich die Textauswahl in einer Capacitor iOS-App?

Installiere @capgo/capacitor-textinteraction, führe bunx cap sync aus und rufe dann TextInteraction.toggle({ enabled: false }) auf. Das Plugin setzt isTextInteractionEnabled in der WKWebView auf false, wodurch Textauswahl und Lupe für die gesamte WebView deaktiviert werden.

Warum reicht CSS user-select: none auf iOS nicht aus?

user-select und -webkit-touch-callout unterbinden die meiste Auswahl im Seiteninhalt, aber die WKWebView kann beim Long-Press trotzdem noch die Lupe und das Auswahlverhalten anzeigen. Und jedes Element, das du nicht extra stylst, bleibt auswählbar. Das Plugin schaltet die Textinteraktion auf WebView-Ebene ab, sodass ein einziger Aufruf alle Screens abdeckt.

Können Nutzer weiterhin in Inputs tippen, wenn die Textinteraktion deaktiviert ist?

Nein. Während die Textinteraktion deaktiviert ist, funktionieren Text-Inputs, Textareas und contenteditable-Elemente nicht mehr. Rufe TextInteraction.toggle({ enabled: true }) auf, bevor du ein Formular oder Suchfeld anzeigst, und deaktiviere sie wieder, wenn der Nutzer den Screen verlässt.

Funktioniert das Plugin auch auf Android oder im Web?

Nein. Das Umschalten der Textinteraktion funktioniert nur auf iOS. Auf Android wird der Aufruf mit success: false aufgelöst und ändert nichts. Im Web wirft der Aufruf einen unimplemented-Fehler, daher mit Capacitor.getPlatform() === "ios" absichern.

Welche iOS- und Capacitor-Versionen werden unterstützt?

Das native API benötigt iOS 14.5 oder neuer. Die Major-Versionen des Plugins folgen Capacitor: Verwende Plugin v8 mit Capacitor 8 und Plugin v7 mit Capacitor 7.

Bleibt die Einstellung nach einem Neustart der App erhalten?

Die Einstellung ist an der WebView-Konfiguration hinterlegt und bleibt daher über Seiten-Navigationen hinweg aktiv, bis du toggle erneut aufrufst. Ein Neustart der App erstellt eine neue WebView mit aktiver Textinteraktion. Rufe toggle daher beim Start erneut auf, falls du sie standardmäßig deaktiviert haben möchtest.

Wie installiere ich das Text Interaction Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-textinteraction" (oder "npm install @capgo/capacitor-textinteraction") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte das native code übernehmen. Importiere es in deinem App-code aus "@capgo/capacitor-textinteraction".

Funktioniert @capgo/capacitor-textinteraction mit React, Vue und Angular?

Ja. Text Interaction ist ein Capacitor-Paket und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-textinteraction?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-textinteraction kostenlos und Open Source?

Ja. Der Quellcode von code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-textinteraction/ verfügbar, und das Paket kann kostenlos von npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit Text Interaction aktualisieren, ohne eine App-Store-Prüfung abwarten zu müssen?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Text-Interaktion-Änderungen ausrollen, ohne auf den App-Review zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo