Skip to content

Latest commit

 

History

History
101 lines (74 loc) · 3.55 KB

README_cn.md

File metadata and controls

101 lines (74 loc) · 3.55 KB
Raw

ColorPicker gitHub release platform Android Arsenal license

English | 中文

Android颜色选择器。通过基于HSV颜色空间的调色盘和滑块来选择颜色，支持透明度值选择。

Gradle

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

将上方的${latestVersion}替换为当前最新的版本号，最新版本号参见releases。

使用方法

使用弹出框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) {

            }
        });

直接使用视图ColorPickerView

  • 将ColorPickerView添加到需要的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"/>

更多支持设置的属性请查阅top_defaults_view_color_picker_attrs.xml。

  • 实现ColorObserver观察者接口并从ColorPickerView订阅颜色更新事件:
colorPickerView.subscribe((color, fromUser) -> {
    // use the color
});
  • 设置选择器的初始颜色值：
colorPickerView.setInitialColor(0x7F313C93);
  • 充值为初始颜色值：
colorPickerView.reset();

完整的示例代码请查阅项目所附app。

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.