npmpackage.info

Gathering detailed insights and metrics for react-native-picker-select

Other packages similar to react-native-picker-select

react-native-image-crop-picker

0.41.6

Select single or multiple images, with cropping option

react-native-image-picker

7.1.2

A React Native module that allows you to use native UI to select media from the device library or directly from the camera

@react-native-picker/picker

2.10.0

React Native Picker for iOS, Android, macOS, and Windows

react-native-modal-datetime-picker

18.0.0

A react-native datetime-picker for Android and iOS

Gathering detailed insights and metrics for react-native-picker-select

react-native-picker-select

🔽 A Picker component for React Native which emulates the native <select> interfaces for iOS and Android

9.3.1

1,765

MIT

JavaScript

19,042,620 5.2

Installations

npm install react-native-picker-select

Pull Requests

Open

12

Total

263

Closed

85

Merged

166

Issues

Open

78

Total

364

Closed

286

Releases

v9.3.1

Published on 12 Aug 2024

v9.3.0

Published on 12 Aug 2024

v9.2.0

Published on 26 Jul 2024

v9.1.3

Published on 01 Apr 2024

v9.1.2

Published on 01 Apr 2024

v9.1.1

Published on 29 Mar 2024

View all 56 releases

Developer

lawnstarter

Developer Guide

BETA

Module System

CommonJS

Min. Node Version

Typescript Support

No

Node Version

18.20.4

NPM Version

10.7.0 Statistics

1,765 Stars

311 Commits

499 Forks

21 Watching

5 Branches

50 Contributors

Updated on 27 Nov 2024

Languages

JavaScript (100%)

Total Downloads

Cumulative downloads

Total Downloads

19,042,620

Last day

-10.1%

22,035

Compared to previous day

Last week

3.7%

120,168

Compared to previous week

Last month

9.2%

511,361

Compared to previous month

Last year

28.6%

5,011,774

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Versions

react-native-picker-select

A Picker component for React Native which emulates the native <select> interfaces for iOS and Android

For iOS, by default we are wrapping an unstyled TextInput component. You can then pass down styles to customize it to your needs.

For Android, by default we are using the native Picker component. If you prefer, you can set useNativeAndroidPickerStyle to false, which will also render an unstyled TextInput component. You can then pass down styles to customize it to your needs.

For either platform, you can alternatively pass down a child element of your choice that will be wrapped in a touchable area.

iOS Example Android Example

View examples on snack.expo.io

Getting Started

Installing

This package is built around and depends on @react-native-picker/picker. Please make sure you install it correctly (as seen below in installation steps).

1npm install react-native-picker-select
2
3# React Native users
4npm install @react-native-picker/picker
5npx pod-install
6
7# Expo
8expo install @react-native-picker/picker

Basic Usage

1import RNPickerSelect from 'react-native-picker-select';
2
3export const Dropdown = () => {
4  return (
5    <RNPickerSelect
6      onValueChange={(value) => console.log(value)}
7      items={[
8        { label: 'Football', value: 'football' },
9        { label: 'Baseball', value: 'baseball' },
10        { label: 'Hockey', value: 'hockey' },
11      ]}
12    />
13  );
14};

Versioning

Version	Notes
>= 8.0.0	Uses @react-native-picker/picker. React Native 0.60 or above. If using Expo, SDK38 or above.
>= 3.0.0	React v16.3 or above.
< 3.0.0	React v16.2 or below.

Props

Name	Description	Details
`onValueChange`	Callback which returns `value, index`	required function
`items`	The items for the component to render - Each item should be in the following format: `{label: 'Orange', value: 'orange', key: 'orange', color: 'orange', inputLabel: 'Orange!', testID: 'e2e-orange'}` - `label` and `value` are required - `key`, `color`, `testID`, and `inputLabel` are optional - `key` will be set to equal `label` if not included - `value` can be any data type - If `inputLabel` exists, the TextInput will display that value instead of the `label`	required array
`placeholder`	- An override for the default placeholder object with a label of `Select an item...` and a value of `null` - An empty object can be used if you'd like to disable the placeholder entirely	object
`disabled`	Disables interaction with the component	boolean
`value`	Will attempt to locate a matching item from the `items` array by checking each item's `value` property. If found, it will update the component to show that item as selected. If the value is not found, it will default to the first item. WARNING: do not use this attribute on iOS if you plan to allow the user to modify the value from within the `Picker`, use `itemKey` instead.	any
`itemKey`	Will attempt to locate a matching item from the `items` array by checking each item's `key` property. If found, it will update the component to show that item as selected. If the key is not found, it will attempt to find a matching item by `value` as above.	string, number
`style`	Style overrides for most parts of the component. More details in styling	object
`darkTheme` iOS only	Use the dark theme for the Picker.	boolean
`pickerProps`	Additional props to pass to the Picker (some props are used in core functionality so use this carefully)	object
`Icon`	Custom icon component to be rendered. More details in styling	Component
`textInputProps`	Additional props to pass to the TextInput (some props are used in core functionality so use this carefully). This is iOS only unless `useNativeAndroidPickerStyle={false}`.	object
`touchableWrapperProps`	Additional props to pass to the touchable wrapping the TextInput (some props are used in core functionality so use this carefully)	object
`onOpen()`	Callback triggered right before the opening of the picker Not supported when `useNativeAndroidPickerStyle={true}`	function
`useNativeAndroidPickerStyle` Android only	The component defaults to using the native Android Picker in its un-selected state. Setting this flag to `false` will mimic the default iOS presentation where a tappable TextInput is displayed. More details in styling	boolean
`fixAndroidTouchableBug` Android only	Experimental flag to fix issue #354	boolean
`InputAccessoryView` iOS only	Replace the InputAcessoryView section (bar with tabbing arrown and Done button) of the opened picker with your own custom component. Can also return `null` here to hide completely. While this bar is typical on `select` elements on the web, the interface guidelines does not include it. View the snack to see examples on how this can be customized.	Component
`doneText` iOS only	"Done" default text on the modal. Can be overwritten here	string
`onUpArrow() / onDownArrow()` iOS only	Presence enables the corresponding arrow - Closes the picker - Calls the callback provided	function
`onDonePress()` iOS only	Callback when the 'Done' button is pressed	function
`onClose(Bool)` iOS only	Callback triggered right before the closing of the picker. It has one boolean parameter indicating if the done button was pressed or not	function
`modalProps` iOS only	Additional props to pass to the Modal (some props are used in core functionality so use this carefully)	object
`touchableDoneProps` iOS only	Additional props to pass to the Done touchable (some props are used in core functionality so use this carefully)	object

Styling

All properties mentioned below must be nested under the style prop. Examples of different styling options can be found on the example snack.

iOS-specific

The component wraps a TextInput without styling. You can target the TextInput styling with inputIOS.
Other styles that can be modified for iOS are named inputIOSContainer, placeholder, viewContainer, chevronContainer, chevron, chevronUp, chevronDown, chevronActive, done, modalViewTop, modalViewMiddle, and modalViewBottom

Android-specific

The native Picker in its inactive state acts looks similar to a TextInput, but it has limitations on custom styling. Any styling that is possible can be applied via inputAndroid.
You can add some styling customization to the active-state native Picker, but that requires modifying some xml files
If you set the prop useNativeAndroidPickerStyle to false, the component will allow a few other style objects: inputAndroidContainer, placeholder, and inputAndroid
Other styles that can be modified for Android are named headlessAndroidContainer and viewContainer

Web-specific

The component creates a select tag
The styling of this select tag can be modified using a nested object with the key inputWeb

Icon

If a component is passed in via the Icon prop - it will be rendered with { position: 'absolute', right: 0 } applied to its wrapping container. You can modify these values and add additional spacing to position the icon as needed by modifying iconContainer. You'll probably also want to add some paddingRight to your input styling to avoid any longer text appearing behind the icon.
You can pass a component of your choosing (css, image, svg, etc..) for use as the icon. For ease of use, consider a library such as react-native-shapes or react-native-vector-icons.
Examples of different icons and their usage can be found on the example snack.

Accessibility

If you need to add accessibility props to the rendered component, you may use pickerProps and touchableWrapperProps to pass these through.

pickerProps accepts an object of props that get passed directly to the native <Picker /> component. touchableWrapperProps also accepts an object of props, but this gets passed to a <TouchableOpacity /> that toggles the visibility of the picker.^{*note: touchableWrapperProps is not supported on web or when useNativeAndroidPickerStyle={true}}

Accessibility Example

In the example below, we render the picker with supplementary description text, but for screen readers, we omit this by passing just the title to the accessibilityLabel prop.

1const selectedItem = {
2  title: 'Selected item title',
3  description: 'Secondary long descriptive text ...',
4};
5
6export const Dropdown = () => {
7  return (
8    <RNPickerSelect
9      pickerProps={{
10        accessibilityLabel: selectedItem.title,
11      }}
12    >
13      <Text>{selectedItem.title}</Text>
14      <Text>{selectedItem.description}</Text>
15    </RNPickerSelect>
16  );
17};

Testing

Test suite included. This component has been used and tested since React Native v0.51.

License

react-native-picker-select is MIT licensed and built with :heart: in Austin, TX by the team at LawnStarter

No vulnerabilities found.

10

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Maintained

Determines if the project is "actively maintained".

10

License

Determines if the project has defined a license.

10

Packaging

Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:10: update your workflow using https://app.stepsecurity.io/secureworkflow/lawnstarter/react-native-picker-select/build.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/lawnstarter/react-native-picker-select/build.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/lawnstarter/react-native-picker-select/build.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/lawnstarter/react-native-picker-select/build.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/commitlint.yml:10: update your workflow using https://app.stepsecurity.io/secureworkflow/lawnstarter/react-native-picker-select/commitlint.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/commitlint.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/lawnstarter/react-native-picker-select/commitlint.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/main.yml:8: update your workflow using https://app.stepsecurity.io/secureworkflow/lawnstarter/react-native-picker-select/main.yml/master?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release-please.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/lawnstarter/react-native-picker-select/release-please.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-please.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/lawnstarter/react-native-picker-select/release-please.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-please.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/lawnstarter/react-native-picker-select/release-please.yml/master?enable=pin
Info: 0 out of 6 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 4 third-party GitHubAction dependencies pinned

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Reason

51 existing vulnerabilities detected

Details

Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw
Warn: Project is vulnerable to: GHSA-fwr7-v2mv-hh25
Warn: Project is vulnerable to: GHSA-cwfw-4gq5-mrqx
Warn: Project is vulnerable to: GHSA-g95f-p29q-9xw4
Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
Warn: Project is vulnerable to: GHSA-p28h-cc7q-c4fg
Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq
Warn: Project is vulnerable to: GHSA-765h-qjxv-5f44
Warn: Project is vulnerable to: GHSA-f2jv-r9rf-7988
Warn: Project is vulnerable to: GHSA-43f8-2h32-f4cj
Warn: Project is vulnerable to: GHSA-896r-f27r-55mw
Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h
Warn: Project is vulnerable to: GHSA-6c8f-qphg-qjgp
Warn: Project is vulnerable to: GHSA-4xcv-9jjx-gfj3
Warn: Project is vulnerable to: GHSA-7wpw-2hjm-89gp
Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m / GHSA-xvch-5gv4-984h
Warn: Project is vulnerable to: GHSA-fhjf-83wg-r2j9
Warn: Project is vulnerable to: GHSA-r683-j2x4-v87g
Warn: Project is vulnerable to: GHSA-w7rc-rwvf-8q5r
Warn: Project is vulnerable to: GHSA-5fw9-fq32-wv5p
Warn: Project is vulnerable to: GHSA-rp65-9cf3-cjxr
Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9
Warn: Project is vulnerable to: GHSA-4cpg-3vgw-4877
Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp
Warn: Project is vulnerable to: GHSA-rxrc-rgv4-jpvx
Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6
Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Warn: Project is vulnerable to: GHSA-m6fv-jmcg-4jfg
Warn: Project is vulnerable to: GHSA-cm22-4g7w-348p
Warn: Project is vulnerable to: GHSA-4g88-fppr-53pp
Warn: Project is vulnerable to: GHSA-4jqc-8m5r-9rpr
Warn: Project is vulnerable to: GHSA-g4rg-993r-mgx7
Warn: Project is vulnerable to: GHSA-gff7-g5r8-mg8m
Warn: Project is vulnerable to: GHSA-2m39-62fm-q8r3
Warn: Project is vulnerable to: GHSA-jgrx-mgxx-jf9v
Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3
Warn: Project is vulnerable to: GHSA-662x-fhqg-9p8v
Warn: Project is vulnerable to: GHSA-394c-5j6w-4xmx
Warn: Project is vulnerable to: GHSA-78cj-fxph-m83p
Warn: Project is vulnerable to: GHSA-fhg7-m89q-25r3
Warn: Project is vulnerable to: GHSA-cf4h-3jhx-xvhq
Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q
Warn: Project is vulnerable to: GHSA-6fc8-4gx4-v693
Warn: Project is vulnerable to: GHSA-h6q6-9hqw-rwfv
Warn: Project is vulnerable to: GHSA-5fg8-2547-mr8q
Warn: Project is vulnerable to: GHSA-crh6-fp67-6883
Warn: Project is vulnerable to: GHSA-c4w7-xm78-47vh
Warn: Project is vulnerable to: GHSA-p9pc-299p-vxgp

Score

5.2

/10

Last Scanned on 2024-11-25

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to react-native-picker-select

react-native-picker-select

Installations

Pull Requests

12

263

85

166

Issues

78

364

286

Releases

Developer

Developer Guide

CommonJS

No

18.20.4

10.7.0

Statistics

Languages

Total Downloads

19,042,620

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

react-native-picker-select

View examples on snack.expo.io

Getting Started

Installing

Basic Usage

Versioning

Props

Styling

iOS-specific

Android-specific

Web-specific

Icon

Accessibility

Accessibility Example

Testing

License

10

10

10

10

10

10

0

0

0

0

0

0

0

5.2

/10

Other packages similar to react-native-picker-select