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

TouchableNativeFeedback

ヒント

タッチベースの入力を処理するための、より広範で将来性のある方法をお探しなら、Pressable APIをチェックしてください。

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

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

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


リファレンス

Props

TouchableWithoutFeedback Props

TouchableWithoutFeedback Props を継承します。


background

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

backgroundPropType

useForeground

リップル効果を背景ではなくビューのフォアグラウンドに追加するには、trueに設定します。これは、子ビューのいずれかが独自の背景を持っている場合や、画像をE.g.表示していて、リップルがそれらによって覆われたくない場合に役立ちます。

これは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

Methods

SelectableBackground()

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

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


SelectableBackgroundBorderless()

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

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


Ripple()

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

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

パラメータ

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

canUseNativeForeground()

tsx
static canUseNativeForeground(): boolean;