跳到主要內容

Switch

渲染一個布林值輸入。

這是一個受控組件，需要一個 onValueChange 回呼函式來更新 value 屬性，組件才能反映使用者操作。如果 value 屬性未更新，組件將繼續渲染提供的 value 屬性，而不是使用者操作的預期結果。

範例​

參考

屬性​

View 屬性​

繼承 View 屬性。

disabled​

如果為 true，使用者將無法切換開關。

類型預設值
boolfalse

ios_backgroundColor
iOS
​

在 iOS 上，背景的自訂顏色。當切換鈕值為 false 或切換鈕停用（且切換鈕為半透明）時，可以看到此背景顏色。

類型
color

onChange​

當使用者嘗試變更切換鈕的值時調用。接收變更事件作為參數。如果您只想接收新值，請改用 onValueChange。

類型
function

onValueChange​

當使用者嘗試變更切換鈕的值時調用。接收新值作為參數。如果您想改為接收事件，請使用 onChange。

類型
function

thumbColor​

前景切換鈕握把的顏色。如果在 iOS 上設定此項，切換鈕握把將失去其陰影。

類型
color

trackColor​

切換軌道的自訂顏色。

iOS：當切換鈕值為 false 時，軌道會縮小到邊框內。如果您想變更縮小軌道所暴露的背景顏色，請使用 ios_backgroundColor。

類型
object: {false: color, true: color}

value​

切換鈕的值。如果為 true，切換鈕將開啟。預設值為 false。

類型
bool