https://github.com/dhaval2404/colorpicker

🎨 Color Picker Library for Android
https://github.com/dhaval2404/colorpicker
android color-palette color-picker kotlin-android material-color-picker
Last synced: about 2 months ago
JSON representation
🎨 Color Picker Library for Android
Host: GitHub
URL: https://github.com/dhaval2404/colorpicker
Owner: Dhaval2404
License: apache-2.0
Created: 2019-12-26T04:30:08.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2024-05-05T04:09:22.000Z (about 1 year ago)
Last Synced: 2025-03-30T10:08:32.492Z (about 2 months ago)
Topics: android, color-palette, color-picker, kotlin-android, material-color-picker
Language: Kotlin
Homepage:
Size: 17.5 MB
Stars: 298
Watchers: 5
Forks: 40
Open Issues: 14
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project

README

        # 🎨Color Picker Library for Android

[![](https://jitpack.io/v/Dhaval2404/ColorPicker.svg)](https://jitpack.io/#Dhaval2404/ColorPicker)

[![Releases](https://img.shields.io/github/release/dhaval2404/colorpicker/all.svg?style=flat-square)](https://github.com/Dhaval2404/ColorPicker/releases)

[![API](https://img.shields.io/badge/API-21%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=21)

![Language](https://img.shields.io/badge/language-Kotlin-orange.svg)

[![PRWelcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/Dhaval2404/ColorPicker)

[![Twitter](https://img.shields.io/twitter/url/https/github.com/dhaval2404/colorpicker.svg?style=social)](https://twitter.com/intent/tweet?text=Checkout%20the%20ColorPicker%20library%20for%20android.%20https%3A%2F%2Fgithub.com%2FDhaval2404%2FColorPicker%20)



  _{Built with ❤︎ by

  Dhaval Patel and

  

    contributors}






Yet another Color Picker Library for Android. It is highly customizable and easy to use. Pick the color from wheel or select Material Colors from dialog. The original ColorPickerView was written by [Hong Duan](https://github.com/duanhong169/ColorPicker).

# 🐱‍🏍Features:

* Color Picker View

* Color Picker Dialog with Recent Color Option

* Material Color Picker Alert Dialog

* Material Color Picker BottomSheet Dialog

# 🎬Preview

   Color Picker    |         Material Color Picker      |

:-------------------------:|:-------------------------:

![](https://github.com/Dhaval2404/ColorPicker/blob/master/art/colorpicker_demo.gif)  |  ![](https://github.com/Dhaval2404/ColorPicker/blob/master/art/materialcolorpicker_demo.gif)

# 💻Usage

1. Gradle dependency:

	```groovy

    allprojects {

        repositories {

            ...

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

        }

    }

	```

	```groovy

	implementation 'com.github.Dhaval2404:ColorPicker:2.3'

	```

2. The **ColorPicker** configuration is created using the builder pattern.

	```kotlin

    // Kotlin Code

    ColorPickerDialog

        .Builder(this)        				// Pass Activity Instance

        .setTitle("Pick Theme")           	// Default "Choose Color"

        .setColorShape(ColorShape.SQAURE)   // Default ColorShape.CIRCLE

        .setDefaultColor(mDefaultColor)     // Pass Default Color

        .setColorListener { color, colorHex ->

        	// Handle Color Selection

        }

        .show()

    ```

    ```java

    // Java Code

    new ColorPickerDialog

        .Builder(this)

        .setTitle("Pick Theme")

        .setColorShape(ColorShape.SQAURE)

        .setDefaultColor(mDefaultColor)

        .setColorListener(new ColorListener() {

            @Override

            public void onColorSelected(int color, @NotNull String colorHex) {

                // Handle Color Selection

            }

        })

        .show();

    ````

3. The **MaterialColorPicker** configuration is created using the builder pattern.

	```kotlin

    // Kotlin Code

    MaterialColorPickerDialog

        .Builder(this)        					// Pass Activity Instance

        .setTitle("Pick Theme")           		// Default "Choose Color"

        .setColorShape(ColorShape.SQAURE)   	// Default ColorShape.CIRCLE

        .setColorSwatch(ColorSwatch._300)   	// Default ColorSwatch._500

        .setDefaultColor(mDefaultColor) 		// Pass Default Color

        .setColorListener { color, colorHex ->

       		// Handle Color Selection

        }

        .show()

    ```

    ```java

    // Java Code

    new MaterialColorPickerDialog

        .Builder(this)

        .setTitle("Pick Theme")

        .setColorShape(ColorShape.SQAURE)

        .setColorSwatch(ColorSwatch._300)

        .setDefaultColor(mDefaultColor)

        .setColorListener(new ColorListener() {

            @Override

            public void onColorSelected(int color, @NotNull String colorHex) {

            	// Handle Color Selection

            }

        })

        .show();

    ```

# 🎨Customization

 *  You can change the color or Positive and Negative Button Text Color. Add Following parameters in your **colors.xml** file.

     ```xml

     

         

         @color/colorAccent

         @color/colorAccent

         #F5F5F5

     

     ```

 *  You can provide predefine colors for the MaterialColorPicker

     ```java

     // Kotlin Code

     MaterialColorPickerDialog

		.Builder(activity!!)

        // Option 1: Pass Hex Color Codes

        //.setColors(arrayListOf("#f6e58d", "#ffbe76", "#ff7979", "#badc58", "#dff9fb", "#7ed6df", "#e056fd", "#686de0", "#30336b", "#95afc0"))

        // Option 2: Pass Hex Color Codes from string.xml

        //.setColors(resources.getStringArray(R.array.themeColorHex))

        // Option 3: Pass color array from colors.xml

        .setColorRes(resources.getIntArray(R.array.themeColors))

        .setColorListener { color, colorHex ->

          // Handle Color Selection

        }

        .show()

	```

	```java

	// Java Code

	String[] colorArray = new String[]{"#f6e58d", "#ffbe76", "#ff7979",

	    "#badc58", "#dff9fb", "#7ed6df", "#e056fd", "#686de0", "#30336b", "#95afc0"};

	new MaterialColorPickerDialog

	    .Builder(requireActivity())

	    // Option 1: Pass Hex Color Codes

	    //.setColors(colorArray)

	    // Option 2: Pass Hex Color Codes from string.xml

	    //.setColors(getResources().getStringArray(R.array.themeColorHex))

	    // Option 3: Pass color array from colors.xml

	    .setColorRes(getResources().getIntArray(R.array.themeColors))

	    

	    .setColorListener(object : ColorListener {

            override fun onColorSelected(color: Int, colorHex: String) {

                // Handle Color Selection

            }

        })

	    .show();

      ```

      Where **R.array.themeColors** and **R.array.themeColorHex** are defined as  below

      ```xml

      

        @color/green_500

        @color/blue_500

        @color/red_500

        @color/grey_500

        @color/orange_500

      

      

        #f6e58d

        #ffbe76

        #ff7979

        #badc58

        #dff9fb

        #7ed6df

        #e056fd

        #686de0

        #30336b

        #95afc0

    

      ```

 *  You can set the Dismiss listener

    **ColorPicker**

	```kotlin

    // Kotlin Code

     ColorPickerDialog

        .Builder(requireActivity())

        .setDismissListener {

            // Handle Dismiss Event

        }

        .show()

    ```

    ```java

    // Java Code

    new ColorPickerDialog

        .Builder(this)

        .setDismissListener(new DismissListener() {

            @Override

            public void onDismiss() {

                // Handle Dismiss Event

            }

        })

        .show();

    ````

    **MaterialColorPicker**

    ```kotlin

    // Kotlin Code

    MaterialColorPickerDialog

        .Builder(this)

        .setDismissListener {

            // Handle Dismiss Event

        }

        .show()

    ```

    ```java

    // Java Code

    new MaterialColorPickerDialog

        .Builder(this)

        .setDismissListener(new DismissListener() {

            @Override

            public void onDismiss() {

                // Handle Dismiss Event

            }

        })

        .show();

    ```

 *  You can set the Tick color for each card. This will come handy when color list include black or white colors. By default tick color will be either black or white based on the color darkness. If more dark colors the tick color will be white else black.

	```kotlin

     // Kotlin Code

     MaterialColorPickerDialog

         .Builder(this)

         .setTickColorPerCard(true)     // Default will be false

         .show()

	```

	```java

     // Java Code

     new MaterialColorPickerDialog

         .Builder(this)

         .setTickColorPerCard(true)     // Default will be false

         .show();

	```

# 💥Compatibility

  * Library - Android Lollipop 5.0+ (API 21)

  * Sample - Android Lollipop 5.0+ (API 21)

# ✔️Changelog

### Version: 2.2/2.3

  * Fixed duplicate class found with FlexBox issue [#24](https://github.com/Dhaval2404/ColorPicker/issues/24)

### Version: 2.1

  * Upgrade gradle dependency

  * Added Android 12 support

### Version: 2.0

  * Added Java compatibility [#8](https://github.com/Dhaval2404/ColorPicker/issues/8)

  * Added option to set tick color per color card [#12](https://github.com/Dhaval2404/ColorPicker/issues/12)

  * Added dialog dismiss listener [#13](https://github.com/Dhaval2404/ColorPicker/issues/13)

### Version: 1.2

  * Added Dark mode support & German translation [#4](https://github.com/Dhaval2404/ColorPicker/pull/4)

### Version: 1.1

  * Added option to change positive and negative button text color [#2](https://github.com/Dhaval2404/ColorPicker/issues/2)

### Version: 1.0

  * Initial Build

## 📃 Libraries Used

* ColorPicker [https://github.com/duanhong169/ColorPicker](https://github.com/duanhong169/ColorPicker)

## 🌟 Credits

  * App icon made by [Nikita Golubev](https://www.flaticon.com/authors/nikita-golubev "Nikita Golubev") from [Flaticon](https://www.flaticon.com/free-icon/color-circle_1831908?term=color&page=1&position=1&related_item_id=1831908)

### Let us know!

We'll be really happy if you sent us links to your projects where you use our component. Just send an email to **[email protected]** And do let us know if you have any questions or suggestion regarding the library.

## License

    Copyright 2020-2021, Dhaval Patel

    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.
ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/dhaval2404/colorpicker

Awesome Lists containing this project

README
