Switch
ブーリアン値の入力をレンダリングします。
これは制御コンポーネントであり、ユーザーのアクションをコンポーネントに反映させるためには、value
propを更新するonValueChange
コールバックが必要です。value
propが更新されない場合、コンポーネントはユーザーのアクションによって期待される結果ではなく、提供されたvalue
propをレンダリングし続けます。
使用例
リファレンス
Props
ViewのProps
ViewのPropsを継承します。
disabled
trueの場合、ユーザーはスイッチを切り替えることができなくなります。
型 | デフォルト |
---|---|
bool | false |
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 |