w-g-b/nice-spinner

A nice spinner for Android

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.w-g-b:nice-spinner:1.3.11'
	}

	dependencies {
		implementation("com.github.w-g-b:nice-spinner:1.3.11")
	}

	<dependency>
	    <groupId>com.github.w-g-b</groupId>
	    <artifactId>nice-spinner</artifactId>
	    <version>1.3.11</version>
	</dependency>


                            
    libraryDependencies += "com.github.w-g-b" % "nice-spinner" % "1.3.11"


                            
    :dependencies [[com.github.w-g-b/nice-spinner "1.3.11"]]

Readme

Nice Spinner

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:

 <org.angmarch.views.NiceSpinner
   android:id="@+id/nice_spinner"
   android:layout_width="wrap_content"
   android:layout_height="wrap_content"
   android:layout_margin="16dp"/>

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 with contents:

    NiceSpinner niceSpinner = (NiceSpinner) findViewById(R.id.nice_spinner);
    List<String> dataset = new LinkedList<>(Arrays.asList("One", "Two", "Three", "Four", "Five"));
    niceSpinner.attachDataSource(dataset);

Now you can add the item click listener in the code:

    List<String> data = new ArrayList<>();
    data.add("it's clickable");
    data.add("setOnItemClickListener");
    data.add("Hello World!");
    NiceSpinner tintedSpinner = findViewById(R.id.tinted_nice_spinner);
    tintedSpinner.attachDataSource(data);
    tintedSpinner.setOnItemClickListener(new AdapterView.OnItemClickListener() {
        @Override
        public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
            String str = parent.getItemAtPosition(position).toString();
            Toast.makeText(MainActivity.this, str, Toast.LENGTH_SHORT).show();
        }
    });

And you also can use the getCurrentItem() to get the showing item.

    String str = spinner.getCurrentItem();

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 defalut data |

How to include

With gradle: edit your build.gradle:

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

dependencies {
    implementation 'com.github.w-g-b:nice-spinner:1.3.9'
}

Or declare it into your pom.xml:

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.github.w-g-b</groupId>
    <artifactId>nice-spinner</artifactId>
    <version>1.3.9</version>
</dependency>

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.