levi-li-yi/react-native-roll-picker

⛏️ react-native-roller-picker

An awesome native wheel picker component for react-native.

Features

• multiple columns ✅

• looping ✅

• Native Android components for improved performance ✅

• Typescript ✅

Installation

yarn add react-native-roller-picker

Quick Start

import { Picker, PickerColumn, PickerItem } from 'react-native-roller-picker';

export const Demo = () => (
  <Picker>
    <PickerColumn>
      <PickerItem label="Monday" value="Monday" />
      <PickerItem label="Tuesday" value="Tuesday" />
      <PickerItem label="Wednesday" value="Wednesday" />
      <PickerItem label="Thursday" value="Thursday" />
      <PickerItem label="Friday" value="Friday" />
    </PickerColumn>
  </Picker>
);

Props

<Picker />

Property	Type	Description	Platform	Default
loop	boolean	Enable looping options	iOS, Android	false
style	object	View style prop	iOS, Android
onChange	function	A callback function when a value is changed in any column	iOS, Android
numberOfLines	number	The number of lines for each row in a column	iOS	1
hasCurtain	boolean	Enable the curtain to highlight the selected value	Android	true
curtainColor	string	Color of the curtain	Android	hsla(0, 0%, 0%, 0.1)
hasIndicator	boolean	Enable the indicator to highlight the selected value	Android	true
indicatorColor	string	Color of the indicator	Android	hsla(0, 0%, 0%, 0.1)
indicatorSize	number	The size of the indicator	Android	1
itemSpace	number	The amount of space between items	Android	12
textColor	string	The color of the item text	Android	#000000
textSize	number	The size of the item text	Android	20

<PickerColumn />

Property	Type	Description	Platform	Default
selectedValue	string | number	The selected value	iOS, Android
onChange	function	A callback function if the value is changed in this column	iOS, Android
width	number	The width of this column	iOS, Android	Takes up the available space

<PickerItem />

Property	Type	Description	Platform	Default
label	string	The label of the item	iOS, Android
value	string | number	The value of the item	iOS, Android
testID	string	The testID of the item	iOS
color	string	The color of the item text	iOS

Contributing

See the contributing guide to learn how to contribute to the repository and the development workflow.

License

MIT