129 lines
1.8 KiB
Markdown
129 lines
1.8 KiB
Markdown
---
|
|
id: switch
|
|
title: Switch
|
|
layout: docs
|
|
category: components
|
|
permalink: docs/switch.html
|
|
next: tabbarios
|
|
previous: statusbar
|
|
---
|
|
Renders a boolean input.
|
|
|
|
This is a controlled component that requires an `onValueChange` callback that updates the `value` prop in order for the component to reflect user actions. If the `value` prop is not updated, the component will continue to render the supplied `value` prop instead of the expected result of any user actions.
|
|
|
|
@keyword checkbox
|
|
@keyword toggle
|
|
|
|
### Props
|
|
|
|
- [View props...](docs/view.html#props)
|
|
- [`disabled`](docs/switch.html#disabled)
|
|
- [`onTintColor`](docs/switch.html#ontintcolor)
|
|
- [`onValueChange`](docs/switch.html#onvaluechange)
|
|
- [`testID`](docs/switch.html#testid)
|
|
- [`thumbTintColor`](docs/switch.html#thumbtintcolor)
|
|
- [`tintColor`](docs/switch.html#tintcolor)
|
|
- [`value`](docs/switch.html#value)
|
|
|
|
|
|
|
|
---
|
|
|
|
# Reference
|
|
|
|
## Props
|
|
|
|
### `disabled`
|
|
|
|
If true the user won't be able to toggle the switch.
|
|
Default value is false.
|
|
|
|
| Type | Required |
|
|
| - | - |
|
|
| bool | No |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
### `onTintColor`
|
|
|
|
Background color when the switch is turned on.
|
|
|
|
| Type | Required |
|
|
| - | - |
|
|
| [color](docs/colors.html) | No |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
### `onValueChange`
|
|
|
|
Invoked with the new value when the value changes.
|
|
|
|
| Type | Required |
|
|
| - | - |
|
|
| function | No |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
### `testID`
|
|
|
|
Used to locate this view in end-to-end tests.
|
|
|
|
| Type | Required |
|
|
| - | - |
|
|
| string | No |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
### `thumbTintColor`
|
|
|
|
Color of the foreground switch grip.
|
|
|
|
| Type | Required |
|
|
| - | - |
|
|
| [color](docs/colors.html) | No |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
### `tintColor`
|
|
|
|
Border color on iOS and background color on Android when the switch is turned off.
|
|
|
|
| Type | Required |
|
|
| - | - |
|
|
| [color](docs/colors.html) | No |
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
### `value`
|
|
|
|
The value of the switch. If true the switch will be turned on.
|
|
Default value is false.
|
|
|
|
| Type | Required |
|
|
| - | - |
|
|
| bool | No |
|
|
|
|
|
|
|
|
|
|
|
|
|