npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@teambuildr/react-native-select-dropdown

v3.3.3

Published

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

Downloads

63

Readme

react-native-select-dropdown

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

Installation

# Using npm

npm install react-native-select-dropdown

# Using yarn

yarn add react-native-select-dropdown

Demo

Code provided in Examples folder.

Search Functionality (Code provided in Examples folder).

Usage

import SelectDropdown from 'react-native-select-dropdown'
...
const countries = ["Egypt", "Canada", "Australia", "Ireland"]
...
<SelectDropdown
	data={countries}
	onSelect={(selectedItem, index) => {
		console.log(selectedItem, index)
	}}
	buttonTextAfterSelection={(selectedItem, index) => {
		// text represented after item is selected
		// if data array is an array of objects then return selectedItem.property to render after item is selected
		return selectedItem
	}}
	rowTextForSelection={(item, index) => {
		// text represented for each item in dropdown
		// if data array is an array of objects then return item.property to represent item in dropdown
		return item
	}}
/>

Props

Methods


data

array of data that will be represented in dropdown 'can be array of objects

| Type | Required | | ----- | -------- | | array | Yes |


onSelect

function recieves selected item and its index in data array

| Type | Required | | -------- | -------- | | function | Yes |


defaultButtonText

default button text when no item is selected

| Type | Required | | ------ | -------- | | String | No |


buttonTextAfterSelection

function recieves selected item and its index, this function should return a string that will be represented in button after item is selected

| Type | Required | | -------- | -------------------------------------------------------------------- | | function | Yes "unless you customized button using renderCustomizedButtonChild" |


rowTextForSelection

function recieves item and index for each row in dropdown, this function shoud return a string that will be represented in each row in dropdown

| Type | Required | | -------- | ----------------------------------------------------------------- | | function | Yes "unless you customized button using renderCustomizedRowChild" |


defaultValue

default selected item in dropdown ( check examples in Demo1)

| Type | Required | | ---- | -------- | | any | No |


defaultValueByIndex

default selected item index

| Type | Required | | ------- | -------- | | integer | No |


disabled

disable dropdown

| Type | Required | | ------- | -------- | | boolean | No |


disableAutoScroll

disable auto scroll to selected value

| Type | Required | | ------- | -------- | | boolean | No |


disabledIndexs

disable choose all Rows index in the list

| Type | Required | | ----- | -------- | | array | No |


onFocus

function fires when dropdown is opened

| Type | Required | | -------- | -------- | | function | No |


onBlur

function fires when dropdown is closed

| Type | Required | | -------- | -------- | | function | No |


onScrollEndReached

function fires when dropdown scrolls to the end (for paginations)

| Type | Required | | -------- | -------- | | function | No |


buttonStyle

style object for button

| Type | Required | | ------ | -------- | | object | Yes |


buttonTextStyle

style object for button text

| Type | Required | | ------ | -------- | | object | No |


renderCustomizedButtonChild

function recieves selected item and its index, this function should return a React component as a child for dropdown button buttonStyle should be used for parent button view style.

# check examples folder to make things clear

| Type | Required | | -------- | -------- | | function | No |


renderDropdownIcon

function that should return a React component for dropdown icon

| Type | Required | | -------- | -------- | | function | No |


dropdownIconPosition

dropdown icon position "left" || "right"

| Type | Required | | ------ | -------- | | string | No |


statusBarTranslucent

required to set true when statusbar is translucent (android only)

| Type | Required | | ------- | -------- | | boolean | No |


dropdownStyle

style object for dropdown view

| Type | Required | | ------ | -------- | | object | No |


dropdownOverlayColor

backdrop color when dropdown is opened

| Type | Required | | ------ | -------- | | string | No |


showsVerticalScrollIndicator

When true, shows a vertical scroll indicator.

| Type | Required | | ------- | -------- | | boolean | No |


rowStyle

style object for row

| Type | Required | | ------ | -------- | | object | Yes |


rowTextStyle

style object for row text

| Type | Required | | ------ | -------- | | object | No |


selectedRowStyle

style object for selected row

| Type | Required | | ------ | -------- | | object | Yes |


selectedRowTextStyle

style object for selected row text

| Type | Required | | ------ | -------- | | object | No |


renderCustomizedRowChild

function recieves item and its index, this function should return React component as a child for customized row rowStyle should be used for parent row view style.

# check examples folder to make things clear

| Type | Required | | -------- | -------- | | function | No |


search

enable search functionality

| Type | Required | | ------- | -------- | | boolean | No |


searchInputStyle

style object for search input

| Type | Required | | ------ | -------- | | object | No |


searchInputTxtColor

text color for search input

| Type | Required | | ------ | -------- | | string | No |


searchInputTxtStyle

style object for search input text

| Type | Required | | ------ | -------- | | object | No |


searchPlaceHolder

placeholder text for search input

| Type | Required | | ------ | -------- | | string | No |


searchPlaceHolderColor

text color for search input placeholder

| Type | Required | | ------ | -------- | | string | No |


renderSearchInputLeftIcon

function returns React component for search input icon

| Type | Required | | -------- | -------- | | function | No |


renderSearchInputRightIcon

function returns React component for search input icon

| Type | Required | | -------- | -------- | | function | No |


onChangeSearchInputText

function callback when the search input text changes, this will automatically disable the dropdown's internal search to be implemented manually outside the component

| Type | Required | | -------- | -------- | | function | No |


| Method | Description | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | reset() | Remove selection & reset it to display defaultButtonText check https://github.com/AdelRedaa97/react-native-select-dropdown/pull/1#issuecomment-818307624. | | openDropdown() | Open the dropdown. | | closeDropdown() | Close the dropdown. | | selectIndex(index) | Select a specific item by index. |


License

MIT