https://github.com/duanhong169/colorpicker

🎨 A color picker for Android. Pick a color using color wheel and slider (HSV & alpha).
https://github.com/duanhong169/colorpicker

android-view color-picker color-picker-popup color-wheel hsv

Last synced: 6 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/duanhong169/colorpicker
• Owner: duanhong169
• License: apache-2.0
• Created: 2018-07-15T09:16:04.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2019-01-16T07:56:42.000Z (over 6 years ago)
• Last Synced: 2025-03-28T20:07:10.597Z (6 months ago)
• Topics: android-view, color-picker, color-picker-popup, color-wheel, hsv
• Language: Java
• Homepage:
• Size: 7.01 MB
• Stars: 379
• Watchers: 11
• Forks: 86
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ColorPicker [![gitHub release](https://img.shields.io/github/release/duanhong169/ColorPicker.svg?style=social)](https://github.com/duanhong169/ColorPicker/releases) [![platform](https://img.shields.io/badge/platform-android-brightgreen.svg)](https://developer.android.com/index.html) [![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-ColorPicker-green.svg?style=flat)](https://android-arsenal.com/details/1/7068)  [![license](https://img.shields.io/badge/license-Apache%202-green.svg)](https://github.com/duanhong169/ColorPicker/blob/master/LICENSE)

English | [中文](README_cn.md)

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](https://github.com/duanhong169/ColorPicker/releases).

## Usage

### Using `ColorPickerPopup`

```java

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:

```xml

```

> See [`top_defaults_view_color_picker_attrs.xml`](./colorpicker/src/main/res/values/top_defaults_view_color_picker_attrs.xml) for all supported attributes.

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

```java

colorPickerView.subscribe((color, fromUser) -> {

    // use the color

});

```

* Set initial color:

```java

colorPickerView.setInitialColor(0x7F313C93);

```

* Reset to initial color:

```java

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.