按鈕

一個基礎的按鈕組件，應能在任何平台上良好渲染。支援最低限度的客製化。

如果此按鈕看起來不適合您的應用程式，您可以使用 Pressable 建立自己的按鈕。 如需靈感，請查看 Button 組件的原始碼。

tsx

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

範例

---

參考

Props

必填

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

電視

電視偏好的焦點。

類型	預設
布林值	false

---

nextFocusDown

Android

電視

指定使用者向下導航時，下一個接收焦點的視圖。 請參閱 Android 文件。

類型
數字

---

nextFocusForward

Android

電視

指定使用者向前導航時，下一個接收焦點的視圖。 請參閱 Android 文件。

類型
數字

---

nextFocusLeft

Android

電視

指定使用者向左導航時，下一個接收焦點的視圖。 請參閱 Android 文件。

類型
數字

---

nextFocusRight

Android

電視

指定使用者向右導航時，下一個接收焦點的視圖。 請參閱 Android 文件。

類型
數字

---

nextFocusUp

Android

電視

指定使用者向上導航時，下一個接收焦點的視圖。 請參閱 Android 文件。

類型
數字

---

testID

用於在端對端測試中定位此視圖。

類型
字串

---

touchSoundDisabled

Android

如果 true，則在觸摸時不播放系統聲音。

類型	預設
布林值	false