0.1.0 • Published 5 years ago

react-native-modal-dropdown-flat v0.1.0

Weekly downloads
15
License
MIT
Repository
github
Last release
5 years ago

npm version

"author": "sohobloo sohobloo@live.cn (https://github.com/sohobloo)",

react-native-modal-dropdown-flat

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

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

You can find them in the example.

Installation

npm i rreact-native-modal-dropdown-flat -save

Usage

Basic

Import this module:

import ModalDropdown from "react-native-modal-dropdown-flat";

Use as a component:

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

Use as a wrapper / container:

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

API

Props

PropTypeOptionalDefaultDescription
disabledboolYesfalsedisable / enable the component.
defaultIndexnumberYes-1Init 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.
defaultValuestringYesPlease select...Init text of the button. Invalid in wrapper mode.
optionsarrayYesOptions. The dropdown will show a loading indicator if options is null/undefined.
animatedboolYestrueDisable / enable fade animation.
showsVerticalScrollIndicatorboolYestrueShow / hide vertical scroll indicator.
styleobjectYesStyle of the button.
textStyleobjectYesStyle of the button text. Invalid in wrapper mode.
dropdownStyleobjectYesStyle of the dropdown list.
dropdownTextStyleobjectYesStyle of the dropdown option text.
dropdownTextHighlightStyleobjectYesStyle of the dropdown selected option text.
adjustFramefuncYesThis 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.
renderRowfuncYesCustomize render option rows: function(option,index,isSelected) Will render a default row if null/undefined.
renderSeparatorfuncYesCustomize render dropdown list separators. Will render a default thin gray line if null/undefined.
renderButtonTextfuncYesUse this to extract and return text from option object. This text will show on button after option selected. Invalid in wrapper mode.
onDropdownWillShowfuncYesTrigger when dropdown will show by touching the button. Return false can cancel the event.
onDropdownWillHidefuncYesTrigger when dropdown will hide by touching the button. Return false can cancel the event.
onSelectfuncYesTrigger when option row touched with selected index and value. Return false can cancel the event.
accessibleboolYestrueSet accessibility of dropdown modal and dropdown rows
keyboardShouldPersistTapsenum('always', 'never', 'handled')Yes'never'See react-native ScrollView props
0.1.0

5 years ago

0.0.9

5 years ago

0.0.8

5 years ago

0.0.5

5 years ago

0.0.4

5 years ago

0.0.7

5 years ago

0.0.6

5 years ago

0.0.3

5 years ago

0.0.2

5 years ago

0.0.1

5 years ago