段弘 / ColorPicker


README.md 2.63 KB

ColorPicker gitHub release platform license

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
        .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.view.ColorPickerView
    android:id="@+id/colorPicker"
    android:layout_width="0dp"
    android:layout_height="wrap_content"
    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

See the LICENSE file.