react-native-gesture-handler

オープンベータ版ドキュメント：本テクニカルドキュメントは、リリース前のオープンベータ版の一部としてAmazonから提供されるものです。ここで説明されている機能は、Amazonがフィードバックを受け取り、機能の開発を繰り返す過程で変更される可能性があります。最新の機能の情報については、最新のリリースノートを参照してください。

@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/（英語のみ）を参照してください。

インストール

package.jsonファイルにJavaScriptライブラリの依存関係を追加します。
クリップボードにコピーしました。
```
"dependencies": {
      ...
      "@amazon-devices/react-native-gesture-handler": "~2.0.0"
}
```
npm installコマンドを使用して、package-lock.jsonファイルを再インストールします。

APIリファレンス

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

ジェスチャータイプ

ジェスチャータイプ	説明
パン	パン（ドラッグ）ジェスチャーを認識し、その動きを追跡できる連続的なジェスチャーハンドラー。
タップ	1回または複数回のタップを認識する非連続的なジェスチャーハンドラー。
長押し	対応するビューを長押ししたときにアクティブ化される非連続的なジェスチャーハンドラー。
回転	回転ジェスチャーを認識し、その動きを追跡できる連続的なジェスチャーハンドラー。
ピンチ	ピンチジェスチャーを認識する連続的なジェスチャーハンドラー。このハンドラーは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日