duanhong169/ColorPicker

🎨 A color picker for Android. Pick a color using color wheel and slider (HSV & alpha).

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.duanhong169:ColorPicker:1.1.6'
	}

	dependencies {
		implementation("com.github.duanhong169:ColorPicker:1.1.6")
	}

	<dependency>
	    <groupId>com.github.duanhong169</groupId>
	    <artifactId>ColorPicker</artifactId>
	    <version>1.1.6</version>
	</dependency>


                            
    libraryDependencies += "com.github.duanhong169" % "ColorPicker" % "1.1.6"


                            
    :dependencies [[com.github.duanhong169/ColorPicker "1.1.6"]]

Readme

ColorPicker <a target="_blank" href="https://android-arsenal.com/api?level=14"><img src="https://img.shields.io/badge/API-14%2B-brightgreen.svg?style=flat"></a>

English | 中文

A ColorPicker for Android. Pick a color using color wheel and slider (HSV & alpha).

Gradle

dependencies {
    implementation 'com.github.duanhong169:colorpicker:${latestVersion}'
    ...
}

Replace ${latestVersion} with the latest version code. See releases.

Usage

Using `ColorPickerPopup`

new ColorPickerPopup.Builder(this)
        .initialColor(Color.RED) // Set initial color
        .enableBrightness(true) // Enable brightness slider or not
        .enableAlpha(true) // Enable alpha slider or not
        .okTitle("Choose")
        .cancelTitle("Cancel")
        .showIndicator(true)
        .showValue(true)
        .build()
        .show(v, new ColorPickerPopup.ColorPickerObserver() {
            @Override
            public void onColorPicked(int color) {
                v.setBackgroundColor(color);
            }

            @Override
            public void onColor(int color, boolean fromUser) {

            }
        });

Using `ColorPickerView`

Add ColorPickerView into your layout xml:

<top.defaults.colorpicker.ColorPickerView
    android:id="@+id/colorPicker"
    android:layout_width="0dp"
    android:layout_height="wrap_content"
    app:enableBrightness="true"
    app:enableAlpha="true"
    app:layout_constraintLeft_toLeftOf="parent"
    app:layout_constraintRight_toRightOf="parent"
    app:layout_constraintTop_toTopOf="parent"/>

See top_defaults_view_color_picker_attrs.xml for all supported attributes.

Implement ColorObserver and subscribe to ColorPickerView to receive color updates from the ColorPickerView:

colorPickerView.subscribe((color, fromUser) -> {
    // use the color
});

Set initial color:

colorPickerView.setInitialColor(0x7F313C93);

Reset to initial color:

colorPickerView.reset();

See a complete usage in the app sample code.

License

Copyright 2018 Hong Duan

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.