mirror of
https://github.com/status-im/react-native.git
synced 2025-01-17 04:50:59 +00:00
e11d496e9d
Summary: Follow up to 9ec95673909beac7798f589e0e9821b4225f8fa9 Closes https://github.com/facebook/react-native/pull/16759 Differential Revision: D6285219 Pulled By: hramos fbshipit-source-id: 7012d257a5a6cff06cb2d94203a9379e4b7e3c4e
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-props.html)
|
|
- [`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 |
|
|
|
|
|
|
|
|
|
|
|
|
|