https://github.com/Lesilva/BetterSpinner

A library creates spinners for Android that really work
https://github.com/Lesilva/BetterSpinner

Last synced: 3 months ago
JSON representation

A library creates spinners for Android that really work

• Host: GitHub
• URL: https://github.com/Lesilva/BetterSpinner
• Owner: Lesilva
• Created: 2015-03-24T04:41:53.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2022-09-08T21:07:44.000Z (about 2 years ago)
• Last Synced: 2024-04-28T09:04:33.133Z (6 months ago)
• Language: Java
• Homepage:
• Size: 3.15 MB
• Stars: 727
• Watchers: 33
• Forks: 155
• Open Issues: 72
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-github-android-ui - BetterSpinner - 好用的Spinner (Spinner)

README

        
![Banner](./screenshot/BetterSpinner Banner.jpg)

# BetterSpinner

[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-BetterSpinner-brightgreen.svg?style=flat)](http://android-arsenal.com/details/1/1707)

If you like developing Android, you must "hate" Spinners. I had countless issues with Spinners and I decided to make a new one. BetterSpinner is using AutoCompleteTextView to do what a Spinner really should do.

## Screenshots

![BetterSpinner](./screenshot/screenshot.gif)

## Examples

The demo is a showcase of the functionality of the library.

[![Get it on Google Play](https://developer.android.com/images/brand/en_generic_rgb_wo_60.png)](https://play.google.com/store/apps/details?id=com.weiwangcn.betterspinner.sample)

Or

 

Download the APK file here: [BetterSpinner.Demo-1.1.0.apk](https://github.com/Lesilva/BetterSpinner/releases/download/1.1.0/BetterSpinner.Demo-1.1.0.apk)

## Usage

BetterSpinner can be used just like [AutoCompleteTextView](http://developer.android.com/reference/android/widget/AutoCompleteTextView.html).

```java

ArrayAdapter adapter = new ArrayAdapter(this,

                 android.R.layout.simple_dropdown_item_1line, COUNTRIES);

         BetterSpinner textView = (BetterSpinner)

                 findViewById(R.id.countries_list);

         textView.setAdapter(adapter);

     }

     private static final String[] COUNTRIES = new String[] {

         "Belgium", "France", "Italy", "Germany", "Spain"

     };

```

or you can also store you arrays in arrays.xml and do something like this in your code

```java

String[] COUNTRIES = getResources().getStringArray(R.array.countries_list);

```

For usage of MaterialEditText 2.0.3, check it out [here](https://github.com/rengwuxian/MaterialEditText/wiki)

If you want to use material style AutoCompleteTextView, simply replace BetterSpinner with MaterialBetterSpinner.

## Download

BetterSpinner is now pushed to Maven Central as an AAR, so you just need to add the following dependency to your `build.gradle`.

gradle:

For normal look use (BetterSpinner):

```groovy

compile 'com.weiwangcn.betterspinner:library:1.1.0'

```

If you have appcompat-v7 in your dependencies make sure to exclude it :

```groovy

compile ('com.weiwangcn.betterspinner:library:1.1.0') {

    exclude group: 'com.android.support', module: 'appcompat-v7'

}

```

For material look use (MaterrialBetterSpinner):

```groovy

compile 'com.weiwangcn.betterspinner:library-material:1.1.0'

```

If you have appcompat-v7 and MaterialEditText in your dependencies make sure to exclude them :

```groovy

compile ('com.weiwangcn.betterspinner:library-material:1.1.0') {

    exclude group: 'com.android.support', module: 'appcompat-v7'

    exclude group: 'com.rengwuxian.materialedittext', module: 'library'

}

```

Note: library-material has included [MaterialEditText 2.0.3](https://github.com/rengwuxian/MaterialEditText).

## Acknowledgements

Thanks my girlfriend Wanrong([email protected]) for the app icon :)

Thanks [Matt](https://github.com/mattblang) for his inspiration

[MaterialEditText](https://github.com/rengwuxian/MaterialEditText)

## License

    Copyright 2015 Wei Wang

    Licensed under the Apache License, Version 2.0 (the "License");

    you may not use this file except in compliance with the License.

    You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software

    distributed under the License is distributed on an "AS IS" BASIS,

    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

    See the License for the specific language governing permissions and

    limitations under the License.