react-native-gesture-handler

@amazon-devices/react-native-gesture-handlerライブラリは、プラットフォームのネイティブなタッチおよびジェスチャーシステムをReact Nativeに公開する宣言型APIです。

React Native Gesture Handlerは、React Nativeで最適なタッチベースのエクスペリエンスを構築するための、ネイティブ駆動のジェスチャー管理APIを提供します。

このライブラリを使用すると、ジェスチャーはJavaScriptレスポンダーシステムによって制御されるのではなく、UIスレッドで認識されて追跡されるようになります。このライブラリにより、タッチ操作とジェスチャートラッキングがスムーズになるのに加えて、信頼性と確度が向上します。

このライブラリはシステムにデプロイされるため、別途インストールプロセスを必要とすることなくVega向けReact Nativeアプリで利用できます。ライブラリは自動リンクされており、アプリは実行時にリンクします。このライブラリは、そのライブラリがビルドされたVega向けReact Nativeのバージョンとのみ互換性があることが保証されています。

アプリのVega向けReact Nativeのバージョンをアップレベルするときは、ライブラリの依存関係をアップレベルするベストプラクティスを検討してください。

このライブラリとAPIの詳細については、Software Mansionの公式ドキュメントのhttps://docs.swmansion.com/react-native-gesture-handler/docs/（英語のみ）を参照してください。

インストール

1. package.jsonファイルにJavaScriptライブラリの依存関係を追加します。

   コードをコピー クリップボードにコピーしました。

   "dependencies": {
         ...
         "@amazon-devices/react-native-gesture-handler": "~2.0.0"
   }
   

2. npm installコマンドを使用して、package-lock.jsonファイルを再インストールします。

APIリファレンス

VegaのGesture-Handlerライブラリは、公式ドキュメント（英語のみ）に記載されているすべてのジェスチャータイプ（英語のみ）とネイティブコンポーネント（英語のみ）に対するサポートを追加します。

ジェスチャー

ジェスチャー	タイプ	説明
パン	連続的	パン（ドラッグ）ジェスチャーを認識し、その動きを追跡します。
タップ	離散的	つまたは複数のタップを認識します。
長押し	離散的	対応するビューを十分に長く押すとアクティブになります。
回転	連続的	回転ジェスチャーを認識し、その動きを追跡します。
ピンチ	連続的	ピンチジェスチャーを認識し、2本の指の間の距離を追跡します。このハンドラーはその情報を使用してコンテンツを拡大または縮小します。
フリング	離散的	動きが十分に長く、速いときにアクティブになります。
手動	プレーン	特定のアクティベーション基準やイベントデータセットはありません。アプリ開発者は、ジェスチャー状態マネージャー（英語のみ）を使用して、アプリロジックで状態をプログラム的に処理する必要があります。

ネイティブコンポーネント

ネイティブコンポーネント	説明
RNGestureHandlerButton	ジェスチャーハンドラーライブラリには、ボタンとして機能するネイティブコンポーネントが用意されています。これらは、RNコアのTouchableHighlightまたはTouchableOpacityを置き換えるものとして使用できます。

サポートされているバージョン

パッケージ名	Amazon NPMライブラリのバージョン	Vega OSのビルド番号	Vega SDKバージョン	リリースノート
@amazon-devices/react-native-gesture-handler	2.0.0+2.13.0	OS 1.1 (201010435950)	0.19
@amazon-devices/react-native-gesture-handler	2.0.0+2.13.0	OS 1.1 (201010438050)	0.20

関連トピック

サポート対象のサードパーティのライブラリとサービス

---

Last updated: 2025年9月30日