メインコンテンツにスキップ

TouchableNativeFeedback

タッチベースの入力を処理するための、より拡張性が高く将来性のある方法をお探しの場合は、Pressable API をご覧ください。

ビューがタッチに適切に応答するようにするためのラッパーです(Androidのみ)。 Androidでは、このコンポーネントはネイティブのステートドローアブルを使用してタッチフィードバックを表示します。

現時点では、子ノードとして単一のViewインスタンスを持つことのみをサポートしています。これは、そのViewを、追加のプロパティが設定されたRCTViewノードの別のインスタンスに置き換えることによって実装されているためです。

ネイティブフィードバックタッチ可能の背景ドローアブルは、background プロパティでカスタマイズできます。


リファレンス

Props

TouchableWithoutFeedback Props

TouchableWithoutFeedback Props を継承します。


background

フィードバックを表示するために使用される背景ドローアブルのタイプを決定します。 type プロパティを持つオブジェクトと、type に応じた追加データを受け取ります。その辞書を生成するには、静的メソッドのいずれかを使用することをお勧めします。

タイプ
backgroundPropType

useForeground

リップル効果を背景ではなくビューの前景に追加するには、trueに設定します。これは、子ビューのいずれかに独自の背景がある場合、または画像などを表示していて、リップルがそれらで覆われたくない場合に便利です。

これはAndroid 6.0以降でのみ使用できるため、最初にTouchableNativeFeedback.canUseNativeForeground()を確認してください。古いバージョンでこれを使用しようとすると、警告が表示され、バックグラウンドにフォールバックします。

タイプ
bool

hasTVPreferredFocus
Android

TV優先フォーカス(Viewコンポーネントのドキュメントを参照)。

タイプ
bool

nextFocusDown
Android

TV次のフォーカスダウン(Viewコンポーネントのドキュメントを参照)。

タイプ
number

nextFocusForward
Android

TV次のフォーカスフォワード(Viewコンポーネントのドキュメントを参照)。

タイプ
number

nextFocusLeft
Android

TV次のフォーカス左(Viewコンポーネントのドキュメントを参照)。

タイプ
number

nextFocusRight
Android

TV次のフォーカス右(Viewコンポーネントのドキュメントを参照)。

タイプ
number

nextFocusUp
Android

TV次のフォーカスアップ(Viewコンポーネントのドキュメントを参照)。

タイプ
number

メソッド

SelectableBackground()

static SelectableBackground(
rippleRadius: number | null,
): ThemeAttributeBackgroundPropType;

選択可能な要素(?android:attr/selectableItemBackground)のAndroidテーマのデフォルトの背景を表すオブジェクトを作成します。 rippleRadiusパラメータは、リップル効果の半径を制御します。


SelectableBackgroundBorderless()

static SelectableBackgroundBorderless(
rippleRadius: number | null,
): ThemeAttributeBackgroundPropType;

境界線のない選択可能な要素(?android:attr/selectableItemBackgroundBorderless)のAndroidテーマのデフォルトの背景を表すオブジェクトを作成します。 Android APIレベル21+で使用可能です。 rippleRadiusパラメータは、リップル効果の半径を制御します。


Ripple()

static Ripple(
color: ColorValue,
borderless: boolean,
rippleRadius?: number | null,
): RippleBackgroundPropType;

指定された色(文字列として)のリップルドローアブルを表すオブジェクトを作成します。プロパティborderlessがtrueと評価された場合、リップルはビューの境界外にレンダリングされます(その動作の例として、ネイティブのアクションバーボタンを参照)。 この背景タイプは、Android APIレベル21+で使用可能です。

パラメータ

名前タイプ必須説明
colorstringはいリップルの色
borderlessbooleanはいリップルが境界外にレンダリングできるかどうか
rippleRadius?numberいいえリップル効果の半径を制御します

canUseNativeForeground()

static canUseNativeForeground(): boolean;