@pranjal-jain/react-native-chooser

2.0.0 • Public • Published

React Native Chooser

npm npm Travis Commitizen friendly

Simple yet fully customizable select menu for React Native.

  • Simple: Alot of optional inputs makes it easier to use as you only need to pass inn data for a simple version.
  • Customizable: All elements can be changed to you what you need. Custom components can be added.
  • Standards: Everything is after React`s latest standards.
  • iOS and Android: Supports both platforms out of the box.

PLEASE NOTE: BREAKING CHANGES IN V2.

Version 1 documentation here

Migration from v1 to v2 here

Installation

npm i react-native-chooser --save

or

yarn add react-native-chooser

Usage


import React, { Component } from 'react';
import {Select, Option} from "react-native-chooser";

import {
  AppRegistry,
  StyleSheet,
  Text,
  View
} from 'react-native';

export default class AwesomeProject extends Component {

  onSelect(data) {
    alert(data);
  }

  render() {
    return (
      <View style={styles.container}>
        <Select
            onSelect = {this.onSelect.bind(this)}
            defaultText  = "Select Me Please"
            style = {{borderWidth : 1, borderColor : "green"}}
            textStyle = {{}}
            backdropStyle  = {{backgroundColor : "#d3d5d6"}}
            optionListStyle = {{backgroundColor : "#F5FCFF"}}
          >
          <Option value = {{name : "azhar"}}>Azhar</Option>
          <Option value = "johnceena">Johnceena</Option>
          <Option value = "undertaker">Undertaker</Option>
          <Option value = "Daniel">Daniel</Option>
          <Option value = "Roman">Roman</Option>
          <Option value = "Stonecold">Stonecold</Option>
          <Option value = "Rock">Rock</Option>
          <Option value = "Sheild">Sheild</Option>
          <Option value = "Orton">Orton</Option>

        </Select>
      </View>
    );
  }
}

Props

Props for Select

Prop Name Data Type Default Values Description
onSelect function null function that executes on selection of an option
defaultText string Click To Select Text to show as default text
style object null To style the select box.
backdropStyle object null To style the overlay
textStyle object null To style the text shown in the box
optionListStyle object null To style the selection box
transparent boolean false To set the transparent prop on Modal
animationType string "none" To set the animationType prop on Modal
indicator string "none", "up" or "down" "none"
indicatorColor string "black" The color of the indicator arrow
indicatorSize number 10 The size of the indicator arrow
indicatorStyle object null To style the indicator arrow
selected string null Give it same value as you give to Option
selectedStyle object null Apply styles to the selected Option

Functions for Select

Function Name Description
setSelectedText(text) Set default text in the select option, often used to reset text.

Props for Option

Prop Name Data Type Default Values Description
style object null To style each option
styleText object null To style the text shown in the option

Demo

IOS and Android:

Contributions

Your contributions and suggestions are heartily♡ welcome. (✿◠‿◠)

Package Sidebar

Install

npm i @pranjal-jain/react-native-chooser

Weekly Downloads

0

Version

2.0.0

License

MIT

Last publish

Collaborators

  • pranjal-jain