npmpackage.info

react-native-modal-dropdown

Fork of the original https://github.com/sohobloo/react-native-modal-dropdown

1.0.2

119

MIT

JavaScript

2,774,706 3.5

Installations

npm install react-native-modal-dropdown

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Node Version

15.14.0

NPM Version

7.7.6 Score

83.8

Supply Chain

99.6

Quality

75.8

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

4

Total

40

Closed

4

Merged

32

Issues

Open

28

Total

41

Closed

13

Releases

Unable to fetch releases

Contributors

Unable to fetch Contributors

View all 29 contributors

Languages

JavaScript

Objective-C

Starlark

Java

JavaScript (88.99%)

Objective-C (6.54%)

Starlark (2.42%)

Java (2.05%)

Love this project? Help keep it running — sponsor us today! 🚀

Developer

siemiatj

Download Statistics

Total Downloads

2,774,706

Last Day

1,076

Last Week

5,179

Last Month

25,138

Last Year

393,671

GitHub Statistics

119 Stars

227 Commits

99 Forks

4 Watching

4 Branches

29 Contributors

Maintainers

Package Meta Information

Latest Version

1.0.2

Package Id

react-native-modal-dropdown@1.0.2

Size

1.32 MB

NPM Version

7.7.6

Node Version

15.14.0

Publised On

15 Sept 2021

Total Downloads

Cumulative downloads

Total Downloads

2,774,706

Last day

-8.5%

1,076

Compared to previous day

Last week

-18.4%

5,179

Compared to previous week

Last month

-7.1%

25,138

Compared to previous month

Last year

-8.3%

393,671

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

prop-types

Versions

react-native-modal-dropdown

A react-native dropdown/picker/selector component for both Android & iOS.

This is the most up to date fork of https://github.com/sohobloo/react-native-modal-dropdown and will be maintained. A discussion about that can be found here: https://github.com/sohobloo/react-native-modal-dropdown/issues/251

Features

Pure JS.
Compatible with both iOS and Android.
Auto position. (Won't be covered or clipped by the edge of screen.)
Zero configuration. (Options are needed of course or a loading indicator will show.)
Highly customizable.
Controllable with API by code. (Show/Hide/Select)
Change everything into a dropdown list trigger.

Demo

Demo 1 Demo 2 Demo 3

You can find them in the example.

Update History

v1.0.2

Fixed Issue when initialScrollIndex failed. Added missing props: ref, getItemLayout, onScrollToIndexFailed
Added keySearchObject option for search objects of array option

v1.0.1

small fixes and more styling custimizations allowed

v1.0.0

took over the package and merged user's PRs

v0.7.0

Quick fix for react native 0.60. (Thanks to @ibtesamlatif2997)

Full update history list

Installation

1npm i --save react-native-modal-dropdown

1yarn add react-native-modal-dropdown

Usage

Basic

Import this module:

1import ModalDropdown from 'react-native-modal-dropdown';

Use as a component:

1<ModalDropdown options={['option 1', 'option 2']}/>

Use as a wrapper / container:

1<ModalDropdown options={['option 1', 'option 2']}>
2  ...
3</ModalDropdown>

Customization

Give the style props as your choice:

style: Change the style of the button (basic mode) / container (wrapper mode).
textStyle: Change the style of text of the button. Invalid in wrapper mode.
dropdownStyle: Change the style of dropdown container.

You can also render your option row and row separator by implement renderRow and renderSeparator function.

API

Props

Prop	Type	Optional	Default	Description
`disabled`	bool	Yes	false	disable / enable the component.
`defaultIndex`	number	Yes	-1	Init selected index. `-1`: None is selected. This only change the highlight of the dropdown row, you have to give a `defaultValue` to change the init text.
`defaultValue`	string	Yes	Please select...	Init text of the button. Invalid in wrapper mode.
`options`	array	Yes		Options. The dropdown will show a loading indicator if `options` is `null`/`undefined`.
`animated`	bool	Yes	true	Disable / enable fade animation.
`isFullWidth`	bool	Yes	false	Disable / enable is dropdown render as full width.
`showsVerticalScrollIndicator`	bool	Yes	true	Show / hide vertical scroll indicator.
`saveScrollPosition`	bool	Yes	true	Sets the scroll position to selected index.
`style`	object	Yes		Style of the button.
`textStyle`	object	Yes		Style of the button text. Invalid in wrapper mode.
`defaultTextStyle`	object	Yes		Overried Style of the button text for default value. Invalid in wrapper mode.
`dropdownStyle`	object	Yes		Style of the dropdown list.
`dropdownTextStyle`	object	Yes		Style of the dropdown option text.
`dropdownTextHighlightStyle`	object	Yes		Style of the dropdown selected option text.
`dropdownTextProps`	object	Yes		Add custom props to the dropdown option text
`adjustFrame`	func	Yes		This is a callback after the frame of the dropdown have been calculated and before showing. You will receive a style object as argument with some of the props like `width` `height` `top` `left` and `right`. Change them to appropriate values that accord with your requirement and make the new style as the return value of this function.
`renderRow`	func	Yes		Customize render option rows: `function(option,index,isSelected)` Will render a default row if `null`/`undefined`.
`renderRowComponent`	Component	Yes	`TouchableOpacity` for iOS and `TouchableHighlight` for Android	Customize the touchable component of the rows
`renderRowProps`	object	Yes		Add custom props to the touchable component of the rows
`renderSeparator`	func	Yes		Customize render dropdown list separators. Will render a default thin gray line if `null`/`undefined`.
`renderButtonText`	func	Yes		Use this to extract and return text from option object. This text will show on button after option selected. Invalid in wrapper mode.
`renderRowText`	func	Yes		Use this to extract and return text from option object. This text will show on row Invalid in wrapper mode.
`renderButtonComponent`	Component	Yes	`TouchableOpacity`	Customize the touchable component of the button
`renderRightComponent`	Component	Yes	`View`	Custom component/Image to display on right side as dropdown icon
`renderButtonProps`	object	Yes		Add custom props to the touchable component of the button
`onDropdownWillShow`	func	Yes		Trigger when dropdown will show by touching the button. Return `false` can cancel the event.
`onDropdownWillHide`	func	Yes		Trigger when dropdown will hide by touching the button. Return `false` can cancel the event.
`onSelect`	func	Yes		Trigger when option row touched with selected `index` and `value`. Return `false` can cancel the event.
`accessible`	bool	Yes	true	Set accessibility of dropdown modal and dropdown rows
`keyboardShouldPersistTaps`	enum('always', 'never', 'handled')	Yes	'never'	See react-native `ScrollView` props
`multipleSelect`	bool	Yes	false	Remove event closing modal when calling onSelect.
`dropdownListProps`	object	Yes	null	FlatList props
`showSearch`	bool	Yes	false	Setting showSearch to true will render the list header with a search
`renderSearch`	Component	Yes	null	Allows to pass search component (required `showSearch` props )
`keySearchObject`	string	Yes	'label'	If your option is an array containing objects, option will find element via `keySearchObject`
`buttonAndRightComponentContainerStyle`	object	Yes		Prop to style the container View of the `<Text>` and the `<RightComponent />`

Methods

Method	Description
`show()`	Show the dropdown. Won't trigger `onDropdownWillShow`.
`hide()`	Hide the dropdown. Won't trigger `onDropdownWillHide`.
`select(idx)`	Select the specified option of the `idx`. Select `-1` will reset it to display `defaultValue`. Won't trigger `onSelect`.

Next version

Any suggestion is welcome.

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

License

Determines if the project has defined a license.

9

Binary-Artifacts

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

3

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 3

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/node.js.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/siemiatj/react-native-modal-dropdown/node.js.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/node.js.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/siemiatj/react-native-modal-dropdown/node.js.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/siemiatj/react-native-modal-dropdown/npm-publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/siemiatj/react-native-modal-dropdown/npm-publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/siemiatj/react-native-modal-dropdown/npm-publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/siemiatj/react-native-modal-dropdown/npm-publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/siemiatj/react-native-modal-dropdown/npm-publish.yml/master?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npm-publish.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/siemiatj/react-native-modal-dropdown/npm-publish.yml/master?enable=pin
Warn: npmCommand not pinned by hash: .github/workflows/node.js.yml:28
Info: 0 out of 8 GitHub-owned GitHubAction dependencies pinned
Info: 4 out of 5 npmCommand dependencies pinned

0

Token-Permissions

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

0

Maintained

Determines if the project is "actively maintained".

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

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

3.5

/10

Last Scanned on 2025-01-27

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-modal-dropdown

@types/react-native-modal-dropdown

1.0.5

TypeScript definitions for react-native-modal-dropdown

react-native-select-dropdown

4.0.1

react-native-select-dropdown is a highly customized dropdown | select | picker | menu for react native that works for andriod and iOS platforms.

react-native-modal-selector

2.1.2

A cross-platform (iOS / Android), selector/picker component for React Native that is highly customizable and supports sections.

rn-react-native-modal-dropdown

1.0.1

[![npm version](https://badge.fury.io/js/react-native-modal-dropdown.svg)](https://badge.fury.io/js/react-native-modal-dropdown)