本文へスキップ

TouchableWithoutFeedback

より包括的で将来性のあるタッチベース入力の処理方法をお探しなら、Pressable APIをご覧ください。

非常に正当な理由がない限り使用しないでください。プレスに応答するすべての要素は、タッチされたときに視覚的なフィードバックを表示する必要があります。

TouchableWithoutFeedbackは、子要素を1つだけサポートします。複数の子コンポーネントが必要な場合は、それらをViewでラップしてください。重要なのは、TouchableWithoutFeedbackは子要素を複製してレスポンダプロパティを適用することによって機能することです。したがって、中間コンポーネントがそれらのプロパティを基になるReact Nativeコンポーネントに渡すことが必要です。

使用方法​

function MyComponent(props: MyComponentProps) {
  return (
    <View {...props} style={{flex: 1, backgroundColor: '#fff'}}>
      <Text>My Component</Text>
    </View>
  );
}

<TouchableWithoutFeedback onPress={() => alert('Pressed!')}>
  <MyComponent />
</TouchableWithoutFeedback>;

例​

参照

プロパティ​

accessibilityIgnoresInvertColors​

型
Boolean

accessible​

trueの場合、ビューがアクセシビリティ要素であることを示します。デフォルトでは、すべてのタッチ可能な要素はアクセシブルです。

型
bool

accessibilityLabel​

ユーザーが要素と対話するときにスクリーンリーダーによって読み取られるテキストをオーバーライドします。デフォルトでは、ラベルはすべての子をトラバースし、スペースで区切られたすべてのTextノードを累積することによって構築されます。

型
string

accessibilityLanguage
iOS
​

ユーザーが要素と対話するときにスクリーンリーダーが使用する言語を示す値です。BCP 47仕様に従う必要があります。

詳細については、iOSのaccessibilityLanguageドキュメントを参照してください。

型
string

accessibilityHint​

アクセシビリティヒントは、アクセシビリティラベルからは結果が明確でない場合に、ユーザーがアクセシビリティ要素でアクションを実行するときに何が起こるかを理解するのに役立ちます。

型
string

accessibilityRole​

accessibilityRoleは、支援技術のユーザーにコンポーネントの目的を伝えます。

accessibilityRoleは、次のいずれかになります。

  • 'none' - 要素に役割がない場合に使用します。
  • 'button' - 要素をボタンとして扱う場合に使用します。
  • 'link' - 要素をリンクとして扱う場合に使用します。
  • 'search' - テキストフィールド要素を検索フィールドとしても扱う場合に使用します。
  • 'image' - 要素を画像として扱う場合に使用します。たとえば、ボタンまたはリンクと組み合わせることができます。
  • 'keyboardkey' - 要素がキーボードキーとして機能する場合に使用します。
  • 'text' - 要素を変更できない静的なテキストとして扱う場合に使用します。
  • 'adjustable' - 要素を「調整」できる場合（例：スライダー）に使用します。
  • 'imagebutton' - 要素をボタンとして扱い、画像でもある場合に使用します。
  • 'header' - 要素がコンテンツセクションの見出しとして機能する場合（例：ナビゲーションバーのタイトル）に使用します。
  • 'summary' - アプリが最初に起動したときに、アプリの現在の状態の簡単な概要を提供するために要素を使用できる場合に使用します。
  • 'alert' - ユーザーに提示する重要なテキストを含む要素の場合に使用します。
  • 'checkbox' - チェックボックス、チェック解除、または混合チェック状態を持つことができる要素を表す場合に使用します。
  • 'combobox' - ユーザーが複数の選択肢から選択できるコンボボックスを表す要素の場合に使用します。
  • 'menu' - コンポーネントが選択肢のメニューの場合に使用します。
  • 'menubar' - コンポーネントが複数のメニューのコンテナの場合に使用します。
  • 'menuitem' - メニュー内のアイテムを表すために使用します。
  • 'progressbar' - タスクの進捗状況を示すコンポーネントを表すために使用します。
  • 'radio' - ラジオボタンを表すために使用します。
  • 'radiogroup' - ラジオボタンのグループを表すために使用します。
  • 'scrollbar' - スクロールバーを表すために使用します。
  • 'spinbutton' - 選択肢のリストを開くボタンを表すために使用します。
  • 'switch' - オンとオフを切り替えることができるスイッチを表すために使用します。
  • 'tab' - タブを表すために使用します。
  • 'tablist' - タブのリストを表すために使用します。
  • 'timer' - タイマーを表すために使用します。
  • 'toolbar' - ツールバー（アクションボタンまたはコンポーネントのコンテナ）を表すために使用します。
型
string

accessibilityState​

支援技術のユーザーにコンポーネントの現在の状態を説明します。

詳細については、アクセシビリティガイドを参照してください。

型
object: {disabled: bool, selected: bool, checked: bool or 'mixed', busy: bool, expanded: bool}

accessibilityActions​

アクセシビリティアクションにより、支援技術はコンポーネントのアクションをプログラムで呼び出すことができます。accessibilityActionsプロパティには、アクションオブジェクトのリストを含める必要があります。各アクションオブジェクトには、フィールド名とラベルを含める必要があります。

詳細については、アクセシビリティガイドを参照してください。

型
array

aria-busy​

要素が変更されており、支援技術は変更が完了するまで待機してから、ユーザーに変更を知らせる必要があることを示します。

型デフォルト
booleanfalse

aria-checked​

チェック可能な要素の状態を示します。このフィールドは、ブール値または「mixed」文字列を使用して、混合チェックボックスを表すことができます。

型デフォルト
boolean, 'mixed'false

aria-disabled​

要素が認識可能だが無効であるため、編集したり操作したりできないことを示します。

型デフォルト
booleanfalse

aria-expanded​

展開可能な要素が現在展開されているか折りたたまれているかを示します。

型デフォルト
booleanfalse

aria-hidden​

このアクセシビリティ要素に含まれるアクセシビリティ要素が非表示かどうかを示します。

たとえば、兄弟ビューAとBを含むウィンドウでは、ビューBでaria-hiddenをtrueに設定すると、VoiceOverはビューBの要素を無視します。

型デフォルト
booleanfalse

aria-label​

対話型要素にラベルを付ける文字列値を定義します。

型
string

aria-live
Android
​

要素が更新されることを示し、ライブリージョンからユーザーエージェント、支援技術、ユーザーが期待できる更新の種類を説明します。

  • off アクセシビリティサービスはこのビューの変更を発表しません。
  • polite アクセシビリティサービスはこのビューの変更を発表します。
  • assertive アクセシビリティサービスは、進行中の音声に割り込んで、このビューの変更をすぐに発表します。
型デフォルト
enum('assertive', 'off', 'polite')'off'

aria-modal
iOS
​

VoiceOverがレシーバーの兄弟であるビュー内の要素を無視するかどうかを示すブール値です。accessibilityViewIsModalプロパティよりも優先されます。

型デフォルト
booleanfalse

aria-selected​

選択可能な要素が現在選択されているかどうかを示します。

型
boolean

onAccessibilityAction​

ユーザーがアクセシビリティアクションを実行したときに呼び出されます。この関数の引数は、実行するアクションの名前を含むイベントのみです。

詳細については、アクセシビリティガイドを参照してください。

型
関数

accessibilityValue​

コンポーネントの現在の値を表します。コンポーネントの値のテキスト説明、またはスライダーやプログレスバーなどの範囲ベースのコンポーネントの場合は、範囲情報（最小値、現在値、最大値）が含まれます。

詳細については、アクセシビリティガイドを参照してください。

型
オブジェクト: {min: 数値, max: 数値, now: 数値, text: 文字列}

aria-valuemax​

スライダーやプログレスバーなどの範囲ベースのコンポーネントの最大値を表します。accessibilityValueプロップのmax値よりも優先されます。

型
数値

aria-valuemin​

スライダーやプログレスバーなどの範囲ベースのコンポーネントの最小値を表します。accessibilityValueプロップのmin値よりも優先されます。

型
数値

aria-valuenow​

スライダーやプログレスバーなどの範囲ベースのコンポーネントの現在値を表します。accessibilityValueプロップのnow値よりも優先されます。

型
数値

aria-valuetext​

コンポーネントのテキスト説明を表します。accessibilityValueプロップのtext値よりも優先されます。

型
string

delayLongPress​

onPressInからonLongPressが呼び出されるまでの時間（ミリ秒単位）。

型
数値

delayPressIn​

タッチ開始からonPressInが呼び出されるまでの時間（ミリ秒単位）。

型
数値

delayPressOut​

タッチの解放からonPressOutが呼び出されるまでの時間（ミリ秒単位）。

型
数値

disabled​

trueの場合、このコンポーネントのすべてのインタラクションを無効にします。

型
bool

hitSlop​

タッチがボタンからどの程度離れた位置から開始できるかを定義します。ボタンから離れる際にpressRetentionOffsetに追加されます。

タッチ領域は親ビューの境界を超えることはなく、タッチが2つの重なっているビューにヒットした場合、常に兄弟ビューのZインデックスが優先されます。

型
Rectまたは数値

id​

ネイティブコードからこのビューを見つけるために使用されます。nativeIDプロップよりも優先されます。

型
string

onBlur​

アイテムがフォーカスを失ったときに呼び出されます。

型
関数

onFocus​

アイテムがフォーカスを受け取ったときに呼び出されます。

型
関数

onLayout​

マウント時とレイアウト変更時に呼び出されます。

型
({nativeEvent: LayoutEvent}) => void

onLongPress​

onPressInの後、370ミリ秒以上経過した場合に呼び出されます。この時間はdelayLongPressでカスタマイズできます。

型
関数

onPress​

タッチが解放されたときに呼び出されますが、キャンセルされた場合は呼び出されません（例：レスポンダロックを盗むスクロール）。最初の関数引数はPressEvent形式のイベントです。

型
関数

onPressIn​

タッチ可能な要素が押されたとすぐに呼び出され、onPressよりも先に呼び出されます。ネットワークリクエストを行う際に便利です。最初の関数引数はPressEvent形式のイベントです。

型
関数

onPressOut​

タッチが解放されるとすぐに、onPressよりも先に呼び出されます。最初の関数引数はPressEvent形式のイベントです。

型
関数

pressRetentionOffset​

スクロールビューが無効になっている場合、ボタンを非アクティブにする前に、タッチがボタンからどの程度離れて移動できるかを定義します。非アクティブ化された後、戻してみてください。ボタンは再びアクティブになります！スクロールビューが無効になっている間に、数回前後に移動してみてください。メモリ割り当てを減らすために定数を渡してください。

型
Rectまたは数値

nativeID​

型
string

testID​

エンドツーエンドテストでこのビューを見つけるために使用されます。

型
string

touchSoundDisabled
Android
​

trueの場合、タッチ時にシステムサウンドを再生しません。

型
Boolean