SapuSeven/color-picker-view

A simple good looking color picker component 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.sapuseven:color-picker-view:'
	}

	dependencies {
		implementation("com.github.sapuseven:color-picker-view:")
	}

	<dependency>
	    <groupId>com.github.sapuseven</groupId>
	    <artifactId>color-picker-view</artifactId>
	    <version></version>
	</dependency>


                            
    libraryDependencies += "com.github.sapuseven" % "color-picker-view" % ""


                            
    :dependencies [[com.github.sapuseven/color-picker-view ""]]

Readme

ColorPickerView

A simple good looking color picker component for Android

A color picker is something that has always been missing from the standard set of components which developers can build their user interface in Android with.

This is a fork from @danielnilsson9 for my own projects, primarily BetterUntis. You can still use this library for any other projects to benefit from the modifications (see below).

Screenshots

(these do not include the modifications by @andre99 and this fork)

How to use

You can use JitPack to quickly include this project.

Step 1: Add the JitPack repository to your build file

Add this in your root build.gradle at the end of repositories:

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

Step 2: Add the dependency

This goes into the module-level build.gradle dependencies:

dependencies {
    ...
    implementation 'com.github.SapuSeven:color-picker-view:v1.5.0'
}

For documentation about how to use the library, check the demo app included in this project.

There are basically three different ways to use this color picker. You can add it to your preferences using the ColorPreference class. You can also use it as a DialogFragment using the ColorPickerDialogFragment. Or you can simply use the ColorPickerView to add the color picker anywhere you want in you application. All three cases are demonstrated in the demo app, please refer to the demo for more information.

Changelog

Version 1.5.0

Added hexadecimal input for dialog pickers (by @andre99)
Prepared for the use with my own projects
Removed JCenter publishing (use JitPack as described above instead)

Version 1.4.0

Change of package name due to problem with JCenter publish. New package name is: com.github.danielnilsson9.colorpickerview, sorry for the inconvenience.
Fix for project could not be built due to obsolete android build tool version used.

Version 1.3.0

Bugfix: Selected Hue value in hue panel did not perfectly match what was shown in in the Saturation/Value panel.
Bugfix: Layout issues on sw320dp displays.
Bugfix: Title could not be changed or removed in ColorPickerDialogFragment.

Version 1.2.0

Api level 13 (Android 3.2) is now required by the library.
The ColorPickerDialog which was based on an AlertDialog has been replaced by ColorPickerDialogFragment which is based on a DialogFragment.
New layout on the color picker dialog, should look good on all screen sizes and orientations.
ColorPickerPreferences was replaced by ColorPreference. The ColorPreference does NOT take care of showing the ColorPickerDialogFragment, you will have to do that yourself, see the demo app. This is due to the fact that we don't have access to the fragment manager from the Preference class.
ColorPickerView now automatically saves it state on orientation change etc.