react-native-wheel-pick

react-native-wheel-pick

React native wheel picker for both iOS and android.

This is not original but inspired by react-native-wheel-datepicker

Preview

Note

• For Picker of iOS use @react-native-picker/picker
• For DatePicker of iOS use @react-native-community/datetimepicker
• For Picker and DatePicker of Android use WheelPicker of AigeStudio

How to use

React Native >= 0.60+

npm install react-native-wheel-pick --save-dev --legacy-peer-deps
npm install @react-native-picker/picker --save-dev --legacy-peer-deps
npm install @react-native-community/datetimepicker --save-dev --legacy-peer-deps
npx pod-install

npx react-native start --reset-cache // clear cache

npx react-native run-ios // re-build native-code
npx react-native run-android // re-build native-code for gradle

React Native < 0.60

npm install react-native-wheel-pick
react-native link react-native-wheel-pick

Example code

import { Picker, DatePicker } from 'react-native-wheel-pick';

// use Picker
<Picker
  style={{ backgroundColor: 'white', width: 300, height: 215 }}
  selectedValue='item4'
  pickerData={['item1', 'item2', 'item3', 'item4', 'item5', 'item6', 'item7']}
  onValueChange={value => { console.log(value) }}
/>

// use DatePicker
<DatePicker
  style={{ backgroundColor: 'white', width: 370, height: 240 }} 
  onDateChange={date => { console.log(date) }}
/>

// for TypeScript
onValueChange={(value: string) => { console.log(value) }}
onDateChange={(date: Date) => { console.log(date) }}

More Example

// Set Text Color
<Picker textColor="red" />

// DatePicker set default select date
<DatePicker
  style={{ height: 215, width: 300 }}
  date={new Date('2018-06-27')} // Optional prop - default is Today
  onDateChange={date => { console.log(date) }}
/>

// DatePicker set min/max Date
<DatePicker
  style={{ height: 215, width: 300 }}
  minimumDate={new Date('2000-01-01')}
  maximumDate={new Date('2050-12-31')}
  onDateChange={date => { console.log(date) }}
/>

// pickerData also support array of object. (Optional Way)

// Normal Way
<Picker
  selectedValue='item4'
  pickerData={['item1', 'item2', 'item3', 'item4', 'item5', 'item6', 'item7']}
  onValueChange={value => { console.log(value) }}
/>

// Optional Way
// `label` only use for show Text to UI.
// You cannot get `label` from onValueChange
<Picker
  selectedValue='5765387680'
  pickerData={[
    { value : '5765387677', label : 'item1' },
    { value : '5765387678', label : 'item2' },
    { value : '5765387679', label : 'item3' },
    { value : '5765387680', label : 'item4' },
    { value : '5765387681', label : 'item5' },
    { value : '5765387682', label : 'item6' },
    { value : '5765387683', label : 'item7' },
  ]}
  onValueChange={value => { console.log(value) }} // '5765387680'
/>

// Android Only.
// These is special props for Android. (iOS and Web not work)
// You can also use these props for DatePicker, too.
<Picker
  textSize={20}

  selectTextColor='green'
  isShowSelectBackground={false} // Default is true
  selectBackgroundColor='#8080801A' // support HEXA color Style (#rrggbbaa)
  // (Please always set 'aa' value for transparent)
  
  isShowSelectLine={false} // Default is true
  selectLineColor='black'
  selectLineSize={6} // Default is 4

  isCyclic={true} // Support Infinitely Scrolling.
/>

// Android Only.
<DatePicker
  order='D-M-Y' // Default is M-D-Y
/>

// Test on Web (Platform.OS === 'Web')
<Picker style={{ height: 50 }} />
// DatePicker still not supported on Web.

How to change Font Family for Android

• Goto android/app/src/main/res/values/styles.xml
• Add this code <item name="wheel_font_path">fonts/[FONT_NAME].ttf</item>

Thanks to @RMabroukS

FYI

I rarely check this lib. (6 Months - 3 Years). Up on my life's time.

If you want to pay me coffee for quickly check & merge your request. You can sponsor me

OR you can fork this project instead.

Release Note

1.2.8 (Feb 14 2026)

[Android]

• Add support for decimal number on Native Android. Thanks to @ArnaudDerosin

1.2.6 (Jul 5 2025)

[Android]

• Add support for isCyclic property on Android. (Infinitely Scrolling) Thanks to @cip123

1.2.5 (Jun 14 2025)

[Android]

• Fix Android DatePicker time mode default selection issue and correct hour range. Thanks to @harryxu

1.2.4 (Feb 17 2025)

[Web]

• Test on Platform.OS === 'web'
• Only <Picker /> can use on Web. <DatePicker /> still not supported on Web.

1.2.3 (Feb 15 2024)

• Fix state is not updating after onValueChange in Picker Component. Thanks to @spasma
• Test on React Native Version 0.77

[Android]

• Support UIManager New Architecture of React Native
• Use Handler for fix 23 index problem. Thanks to @mykhailoperemitko @A-ANing

1.2.2 (June 7 2023)

[iOS]

• Now iOS can use textColor, too. Add missing color option for iOS @aurotones

1.2.1 (June 4 2023)

• Fix typescript warning

[Android]

• Update compileSDK to version 33.

1.2.0 (July 3 2022)

• Remove deprecated-react-native-prop-types
• Support for peer dependencies React 18 by --legacy-peer-deps

1.1.7 (June 21 2022)

[Android]

• compileSdk -> compileSdkVersion

1.1.6 (June 20 2022)

• Add more step for How to use

1.1.5 (June 20 2022)

• Change License from MIT to Apache-2.0
• Add NOTICE file for credit original author.
• Fix peerDependency do not break other version.

[Android]

• Fix WheelCurvedPicker not found for first run.
• DatePicker support order prop.

1.1.4 (June 19 2022)

• Fix Readme wrong type.

1.1.3 (June 19 2022)

• Restructure code of Picker iOS and Android.
• pickerData support array of object.

[Android]

• Update sdk support for SDK Version 30 (Google Play need sdk version 30+)
• Now android support for style of selectLine / selectBackground. Special thanks to @kaisv7n for his pull request, Update WheelPicker version, exposed more methods and fixed crash on android I changed prop name for more understandable.
• DatePicker of Android also support width.
• Deprecated some android prop that make library faster. (Atmospheric / Curved / visibleItemCount / itemSpace) If you want it back pull request are welcome.
• Change some prop name for make code more understandable.
• If update from version <= 1.1.2. You will get warning about Deprecated prop if you still use, I write some logic for make app not crash. (Please fix warning if possible.)

[IOS]

• Do not use PickerIOS and DatePickerIOS of 'react-native' anymore.

Preview for version <= 1.12

Example code for version <= 1.12

import { Platform } from 'react-native';
import { Picker, DatePicker } from 'react-native-wheel-pick';

const isIos = Platform.OS === 'ios'

// use Picker
<Picker
  style={{ backgroundColor: 'white', width: 300, height: 215 }}
  selectedValue='item4'
  pickerData={['item1', 'item2', 'item3', 'item4', 'item5', 'item6', 'item7']}
  onValueChange={value => { }}
  itemSpace={30} // this only support in android
/>

// use DatePicker
<DatePicker
  style={{ backgroundColor: 'white', height: 215, width: isIos ? 300 : undefined }} 
  // android not support width
  onDateChange={date => { }}
/>

Note for version <= 1.12

• For iOS use default PickerIOS / DatePickerIOS of React Native.
• For Android use WheelPicker of WheelPicker
• Line color is white in android. (Support Line style in future. Pull request welcome)
• Line color is grey in IOS but it has bug line not show in Picker (iOS 11.4 not sure other version).

More Example for version <= 1.12

// DatePicker set default choose date
<DatePicker
  style={{ height: 215, width: isIos ? 300 : undefined }}
  date={new Date('2018-06-27')} // Optional prop - default is Today
  onDateChange={date => { }}
/>

// DatePicker set min/max Date
<DatePicker
  style={{ height: 215, width: isIos ? 300 : undefined }}
  minimumDate={new Date('2000-01-01')}
  maximumDate={new Date('2050-12-31')}
  onDateChange={date => { }}
/>

Release Note for version <= 1.12

1.1.2 (April 13 2022)

• Edit broken url.

1.1.1 (November 20 2021)

• Edit broken url.

1.1.0 (January 14 2020)

• Use react-native.config.js instead of rnpm section. @darkbluesun

[Android]

• Add safeExtGet to get sdk version from root project.@darkbluesun

1.0.9 (June 27 2018)

[IOS]

• Fix bug props date of DatePicker is not work right.

1.0.8 (June 27 2018)

• Support props for date picker (date / minimumDate / maximumDate)

[IOS]

• Fix bug cannot read property 'getTime' of null

1.0.7 (June 25 2018)

[Android]

• Fix bug android value wrong from array

1.0.5 (June 24 2018)

• Fix Lifecycle for support React 16 (Remove componentWillMount / componentWillReceiveProps)

[Android]

• Fix bug onValueChange occur first time without change

1.0.4 (June 24 2018)

[Android]

• Support compileSDKVersion 26

License

Copyright 2022 [e-mail]

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.