本文へスキップ

Button

あらゆるプラットフォームで適切にレンダリングされる基本的なボタンコンポーネントです。最小限のカスタマイズをサポートします。

このボタンがアプリに適していない場合は、Pressableを使用して独自のボタンを作成できます。参考として、Buttonコンポーネントのソースコードをご覧ください。

<Button
  onPress={onPressLearnMore}
  title="Learn More"
  color="#841584"
  accessibilityLabel="Learn more about this purple button"
/>

例​

リファレンス

プロパティ​

必須
onPress​

ユーザーがボタンをタップしたときに呼び出されるハンドラー。

型
({nativeEvent: PressEvent})

必須
title​

ボタン内に表示するテキスト。Androidでは、指定されたタイトルは大文字に変換されます。

型
文字列

accessibilityLabel​

視覚障碍者向けアクセシビリティ機能に表示するテキスト。

型
文字列

accessibilityLanguage
iOS
​

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

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

型
文字列

accessibilityActions​

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

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

型必須
配列不要

onAccessibilityAction​

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

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

型必須
関数不要

color​

テキストの色（iOS）、またはボタンの背景色（Android）。

型デフォルト
色 '#2196F3'
Android
'#007AFF'
iOS

disabled​

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

型デフォルト
ブール値false

hasTVPreferredFocus
TV
​

TV優先フォーカス。

型デフォルト
ブール値false

nextFocusDown
Android
TV
​

ユーザーが下方向に移動した際にフォーカスを受け取る次のビューを指定します。Android のドキュメントを参照してください。

型
数値

nextFocusForward
Android
TV
​

ユーザーが前方向に移動した際にフォーカスを受け取る次のビューを指定します。Android のドキュメントを参照してください。

型
数値

nextFocusLeft
Android
TV
​

ユーザーが左方向に移動した際にフォーカスを受け取る次のビューを指定します。Android のドキュメントを参照してください。

型
数値

nextFocusRight
Android
TV
​

ユーザーが右方向に移動した際にフォーカスを受け取る次のビューを指定します。Android のドキュメントを参照してください。

型
数値

nextFocusUp
Android
TV
​

ユーザーが上方向に移動した際にフォーカスを受け取る次のビューを指定します。Android のドキュメントを参照してください。

型
数値

testID​

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

型
文字列

touchSoundDisabled
Android
​

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

型デフォルト
ブール値false