1.0.0 • Published 5 months ago

@dpelkey98/react-native-picker v1.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
5 months ago

React Native Picker

A dead simple, performant React Native Picker using Shopify's FlashList and React Native Reanimated


Preview

As many items as you wantSupports disabled items

Installation

npm install @dpelkey98/react-native-picker

Expo

The picker uses Reanimated under the hood. In order for it to work with Expo you need to install your specific SDK version

npx expo install react-native-reanimated

Refer to Reanimated's getting started guide


Methods

MethodParamsDescription
.setValue()ValueSet the currently selected value of the picker

Props

PropValueDefaultDescription
dataPickerData[]Data to render in your picker; value must be unique
defaultValue?ValueundefinedAutomatically scrolls and selects the specified value
disabled?booleanfalseDisable the picker
onChange?(PickerItem) => voidundefinedCallback function passed with a PickerItem
itemHeight?number40Height of each item in the picker
numberOfItems?3 \| 5 \| 75Height of the picker; numberOfItems*itemHeight
showsBar?booleantrueWhether or not to display the center bar (grey bar in the videos above)
barStyle?ViewStyleundefinedStyles to apply to center bar
barColor?string#efefefConvenience prop to only change the bar color
itemTextStyle?TextStyleundefinedStyles to apply to each picker item's text component
itemDisabledTextStyle?TextStyleundefinedStyles to apply to each disabled picker item's text component
itemStyle?Omit<ViewStyle, "height">undefinedStyles to apply to each picker item's container component
itemDisabledStyle?Omit<ViewStyle, "height">undefinedStyles to apply to each disabled picker item's container component
style?Omit<ViewStyle, "height">undefinedStyles to apply to the picker's container component

Types

Value

string | number

PickerItem

{
  label?: string;
  value: Value;
  disabled?: boolean;
}

PickerData

Provided for convenience

PickerItem[]