@react-native-segmented-control/segmented-control
React Native SegmentedControl library. Use SegmentedControl to render a UISegmentedControl iOS.
For Android and Web, it has a js implementation that mocks iOS 13 style of UISegmentedControl.
Supported React Native Version react-native-segmented-control react-native v2.2.0 >= 0.62 <= v2.2.0 >= 0.57This module is NOT supported in the Expo Go app on iOS, because it requires custom native code. You need to use a custom development client or eject into bare workflow in order to use this module on iOS.
Install the library using your package manager:
pnpm:
pnpm install --save @react-native-segmented-control/segmented-control
yarn:
yarn add @react-native-segmented-control/segmented-control
npm:
npm install --save @react-native-segmented-control/segmented-control
The package is automatically linked when building the app. All you need to do is:
For android, no linking is needed, as the module is implemented in js.
For React Native version 0.59 or older ### React Native <= 0.59run react-native link @react-native-segmented-control/segmented-control
or you can follow the instructions to manually link this package.
Upgrading to React Native 0.60+New React Native comes with autolinking
feature, which automatically links Native Modules in your project. In order to get it to work, make sure you unlink Segmented Control
first:
react-native unlink @react-native-segmented-control/segmented-control
react-native
module
This module was created when the segmentedControlIos was split out from the core of React Native. To migrate to this module you need to follow the installation instructions above and then change you imports from:
import {SegmentedControlIOS} from 'react-native';
to:
import SegmentedControl from '@react-native-segmented-control/segmented-control';
Start by importing the library:
Use SegmentedControl
to render a UISegmentedControl iOS.
The selected index can be changed on the fly by assigning the selectedIndex prop to a state variable, then changing that variable. Note that the state variable would need to be updated as the user selects a value and changes the index, as shown in the example below.
import SegmentedControl from '@react-native-segmented-control/segmented-control'; return ( <SegmentedControl values={['One', 'Two']} selectedIndex={this.state.selectedIndex} onChange={(event) => { this.setState({selectedIndex: event.nativeEvent.selectedSegmentIndex}); }} /> );
Inherits View Props.
If false the user won't be able to interact with the control. Default value is true.
If true, then selecting a segment won't persist visually. The onValueChange
callback will still work as expected.
Callback that is called when the user taps a segment; passes the event as an argument
Type Required function NoCallback that is called when the user taps a segment; passes the segment's value as an argument
Type Required function NoThe index in props.values
of the segment to be (pre)selected.
Accent color of the control.
Background color color of the control. (iOS 13+ only)
Type Required Supported Version string No iOS 13+The labels for the control's segment buttons, in order.
Type Required (string number(iOS 13+ only) Overrides the control's appearance irrespective of the OS theme
Type Required Platform 'dark', 'light' No iOS, Android, Web(iOS 13+ only)
Type Required Platform object No iOS, Android, WebAn object container
color
: color of segment textfontSize
: font-size of segment textfontFamily
: font-family of segment textfontWeight
: font-weight of segment text(iOS 13+ only)
Type Required Platform object No iOS, Android, Webcolor
: overrides color of selected segment textfontSize
: overrides font-size of selected segment textfontFamily
: overrides font-family of selected segment textfontWeight
: overrides font-weight of selected segment text(Android and Web only) Styles the clickable surface which is responsible to change tabs
Type Required Platform object No Android, WebExtends ViewStyles
(Android and Web only) Styles the slider component (Animated.View)
Type Required Platform object No Android, WebExtends ViewStyles
How can I increase the height of the tab ?For android and IOS, simply pass prop.style
:
For react-native-web, additionally pass :
{ "paddingVertical": number, or "height": number }Adding padding makes text disappear on Android
If padding amount exceeds the fixed height of the container, it will shrink the text. So either increase the height or reduce your padding.
Please see the contributing guide
.
The library is released under the MIT licence. For more information see LICENSE
.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4