Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/chymtt/ReactNativeDropdownAndroid

A simple wrapper for Android's Spinner in react-native
https://github.com/chymtt/ReactNativeDropdownAndroid

Last synced: about 1 month ago
JSON representation

A simple wrapper for Android's Spinner in react-native

Lists

README 

        
# react-native-dropdown-android



A simple wrapper for Android's Spinner



## Installation Android

1. `npm install --save react-native-dropdown-android`

2. In `android/settings.gradle`



    ```gradle

    ...

    include ':ReactNativeDropdownAndroid', ':app'

    project(':ReactNativeDropdownAndroid').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-dropdown-android/android')

    ```



3. In `android/app/build.gradle`



    ```gradle

    ...

    dependencies {

        ...

        compile project(':ReactNativeDropdownAndroid')

    }

    ```



4. Register module (in MainActivity.java)



    4.1. With RN < 0.19.0



        ```java

        import com.chymtt.reactnativedropdown.DropdownPackage; // <----- import



        public class MainActivity extends Activity implements DefaultHardwareBackBtnHandler {

          ......



          @Override

          protected void onCreate(Bundle savedInstanceState) {

            super.onCreate(savedInstanceState);

            mReactRootView = new ReactRootView(this);



            mReactInstanceManager = ReactInstanceManager.builder()

              .setApplication(getApplication())

              .setBundleAssetName("index.android.bundle")

              .setJSMainModuleName("index.android")

              .addPackage(new MainReactPackage())

              .addPackage(new DropdownPackage())              // <------ add here

              .setUseDeveloperSupport(BuildConfig.DEBUG)

              .setInitialLifecycleState(LifecycleState.RESUMED)

              .build();



            mReactRootView.startReactApplication(mReactInstanceManager, "ExampleRN", null);



            setContentView(mReactRootView);

          }

          ......

        }

        ```



    4.2. With RN >= 0.19.0



        ```java

        import com.chymtt.reactnativedropdown.DropdownPackage; // <----- import



        public class MainActivity extends ReactActivity {

            ...



            @Override

            protected List getPackages() {

              return Arrays.asList(

                new MainReactPackage(),

                new DropdownPackage() // <------ add here

              );

            }

        }

        ```



## Usage



```js



var Dropdown = require('react-native-dropdown-android');

...



  render() {

    return (

       { console.log(data); }} />

    );

  }

```



## Props



### style



Right now you should always and only provide its height and width, otherwise the dropdown won't show up at all



### values



An array of options. This should be provided with an __array of strings__. Any type other than string will be converted to its string representation



### selected



An int indicating which option (zero-based) is currently selected



### onChange(data)



Callback with data in the form `data = { selected: 1, value: 'one' }`



## Questions or suggestions?



Feel free to [open an issue](https://github.com/chymtt/ReactNativeDropdownAndroid/issues)

[Pull requests](https://github.com/chymtt/ReactNativeDropdownAndroid/pulls) are also welcome