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

Switch

ブーリアン値の入力をレンダリングします。

これは制御コンポーネントであり、ユーザーのアクションをコンポーネントに反映させるためには、value propを更新するonValueChangeコールバックが必要です。value propが更新されない場合、コンポーネントはユーザーのアクションによって期待される結果ではなく、提供されたvalue propをレンダリングし続けます。

使用例


リファレンス

Props

ViewのProps

ViewのPropsを継承します。


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