Skip to content

Latest commit

 

History

History
117 lines (80 loc) · 4.47 KB

File metadata and controls

117 lines (80 loc) · 4.47 KB

React Native Segmented Control 2

React Native Segmented Control 2

npm version npm Platform - Android and iOS License: MIT styled with prettier

React Native Segmented Control 2

Installation

Add the dependency:

npm i react-native-segmented-control-2

Peer Dependencies

Zero Dependency 🥳

Usage

Import

import SegmentedControl from "react-native-segmented-control-2";

Fundamental Usage

<SegmentedControl
  tabs={["Label 1", "Label 2", "Label 3"]}
  onChange={(index: number) => console.log("Index: ", index)}
/>

Customized Usage

<SegmentedControl
  style={{ marginTop: 32, backgroundColor: "#ffe0e0" }}
  activeTabColor="#ff2929"
  activeTextColor="#fff"
  tabs={["Label 1", "Label 2", "Label 3"]}
  onChange={(index: number) => console.log("Index: ", index)}
/>

Any Component Usage

You can use the segmented control with any component. All you need to do is that put any component into the tabs props. Please check out the example for its usage

Example Project 😍

You can checkout the example project 🥰

Simply run

  • npm i
  • react-native run-ios/android

should work of the example project.

Configuration - Props

Fundamentals

Property Type Default Description
tabs any[] undefined set the array for tabs
onChange function undefined set your own logic when the tab is pressed / changed

Customization (Optionals)

Property Type Default Description
style ViewStyle default set or override the style object for the main container
width number ScreenWidth * 0.9 change the width of the main segmented control
initialIndex number 0 set the initial index
activeTextColor string #000 change the active tab's text color
activeTabColor string #FFF change the active tab's color
extraSpacing number 0 set extra spacing for animation horizontal value
tabStyle ViewStyle default set or override the style object for the tab
selectedTabStyle ViewStyle default set or override the style object for the selected tab
textStyle TextStyle default set or override the style object for tab's text

Future Plans

  • LICENSE
  • Write an article about the lib on Medium

Credits

Heavily inspired by these libraries:

I created this library because they're really not maintain actively and this is a pure javascript written library

Author

FreakyCoder, [email protected]

License

React Native Segmented Control 2 is available under the MIT license. See the LICENSE file for more info.