GithubHelp home page GithubHelp logo

kottidev / react-native-modal-dropdown Goto Github PK

View Code? Open in Web Editor NEW

This project forked from sohobloo/react-native-modal-dropdown

0.0 2.0 0.0 1.59 MB

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

License: MIT License

JavaScript 72.37% Python 6.16% Java 4.94% Objective-C 16.53%

react-native-modal-dropdown's Introduction

npm version

react-native-modal-dropdown

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

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

v0.4.0

  • New feature: #10 Support touchable component in renderRow.
  • New feature: #11 Open renderSeparator prop API.
  • New feature: Add adjustFrame prop for user to adjust the frame style of the dropdown in case the component calculate a mistake frame. (refer to #9) (code sample)
  • Enhancement: Compatible with react-native v0.36.0 which has a break change causes the default button with zero size.
  • Enhancement: #16 Prevent from warnings if array of styles is used instead of stylesheet or object. Thanks to @NikolaBorislavovHristov .

v0.3.2

  • Fix bug: #9 undefined is not an object (evaluating '_this.updatePosition.bind') in v0.3.1.
  • Fix bug: Wrong width of dropdown in very few cases.

v0.3.1

  • Fix bug: #6 Can not specify height style for dropdownStyle.
  • Remove updatePosition function.

v0.3.0

  • Auto update position before show.
  • Mark updatePosition function as depreciated. (May be removed in next version.)

v0.2.0

  • Add wrapper / container support

Now you can use these component as a wrapper / container. Anything wrapped in it can be the trigger of the dropdown.

Demo 4

Installation

npm i react-native-modal-dropdown -S

Usage

Basic

Import this module:

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

Use as a component:

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

Use as a wrapper / container:

<ModalDropdown options={['option 1', 'option 2']}>
  ...
</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 arrayOf(string) Yes Options. The dropdown will show a loading indicator if options is null/undefined.
style object Yes Style of the button.
textStyle object Yes Style of the button text. Invalid in wrapper mode.
dropdownStyle object Yes Style of the dropdown list.
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. Will render a default row if null/undefined.
renderSeparator func Yes Customize render dropdown list separators. Will render a default thin gray line if null/undefined.
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.

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.

react-native-modal-dropdown's People

Contributors

cmmobiraoxin avatar nklhtv avatar sohobloo avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.