Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arcadefire/nice-spinner
A nice spinner for Android
https://github.com/arcadefire/nice-spinner
android material-design spinner
Last synced: 3 months ago
JSON representation
A nice spinner for Android
- Host: GitHub
- URL: https://github.com/arcadefire/nice-spinner
- Owner: arcadefire
- License: apache-2.0
- Archived: true
- Created: 2015-08-02T17:16:45.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-07-28T20:08:59.000Z (5 months ago)
- Last Synced: 2024-09-21T16:29:40.836Z (3 months ago)
- Topics: android, material-design, spinner
- Language: Java
- Homepage:
- Size: 402 KB
- Stars: 2,846
- Watchers: 53
- Forks: 445
- Open Issues: 53
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-github-android-ui - nice-spinner - Android spinner的重新实现 (Spinner)
README
This project is archived and is no longer maintained.
========
# Nice Spinner [](https://jitpack.io/#arcadefire/nice-spinner) [](https://android-arsenal.com/details/1/2225)
NiceSpinner is a re-implementation of the default Android's spinner, with a nice arrow animation and a different way to display its content.
It follows the material design guidelines, and it is compatible starting from Api 14.
### Usage
The usage is pretty straightforward. Add the tag into the XML layout:
```xml
```
* Note: change `layout_width` to at least the width of the largest item on the list to prevent resizing
Then use this snippet to populate it with contents:
```java
NiceSpinner niceSpinner = (NiceSpinner) findViewById(R.id.nice_spinner);
List dataset = new LinkedList<>(Arrays.asList("One", "Two", "Three", "Four", "Five"));
niceSpinner.attachDataSource(dataset);
```
#### Listeners
For listening to the item selection actions, you can just use the following snippet:
```java
spinner.setOnSpinnerItemSelectedListener(new OnSpinnerItemSelectedListener() {
@Override
public void onItemSelected(NiceSpinner parent, View view, int position, long id) {
// This example uses String, but your type can be any
String item = parent.getItemAtPosition(position);
...
}
});
```
#### Attributes
You can add attributes to customize the view. Available attributes:
| name | type | info |
|------------------------ |-----------|--------------------------------------------------------|
| arrowTint | color | sets the color on the drop-down arrow |
| hideArrow | boolean | set whether show or hide the drop-down arrow |
| arrowDrawable | reference | set the drawable of the drop-down arrow |
| textTint | color | set the text color |
| dropDownListPaddingBottom | dimension | set the bottom padding of the drop-down list |
| backgroundSelector | integer | set the background selector for the drop-down list rows |
| popupTextAlignment | enum | set the horizontal alignment of the default popup text |
| entries | reference | set the data source from an array of strings |
How to include
---
With gradle: edit your `build.gradle`:
```groovy
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}
dependencies {
implementation 'com.github.arcadefire:nice-spinner:1.4.4'
}
```
Or declare it into your `pom.xml`:
```xml
jitpack.io
https://jitpack.io
com.github.arcadefire
nice-spinner
1.4.4
```
License
-------
Copyright (C) 2015 Angelo Marchesin.
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.