https://github.com/ohmae/color-chooser

Color chooser dialog library for android
https://github.com/ohmae/color-chooser

android-library color-picker

Last synced: 6 months ago
JSON representation

Color chooser dialog library for android

• Host: GitHub
• URL: https://github.com/ohmae/color-chooser
• Owner: ohmae
• License: mit
• Created: 2018-11-24T20:23:10.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2026-01-17T13:57:23.000Z (6 months ago)
• Last Synced: 2026-01-18T00:15:39.372Z (6 months ago)
• Topics: android-library, color-picker
• Language: Kotlin
• Homepage:
• Size: 7.59 MB
• Stars: 25
• Watchers: 1
• Forks: 5
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# color chooser

[![license](https://img.shields.io/github/license/ohmae/color-chooser.svg)](./LICENSE)

[![GitHub release](https://img.shields.io/github/release/ohmae/color-chooser.svg)](https://github.com/ohmae/color-chooser/releases)

[![GitHub issues](https://img.shields.io/github/issues/ohmae/color-chooser.svg)](https://github.com/ohmae/color-chooser/issues)

[![GitHub closed issues](https://img.shields.io/github/issues-closed/ohmae/color-chooser.svg)](https://github.com/ohmae/color-chooser/issues?q=is%3Aissue+is%3Aclosed)

[![Maven Central](https://img.shields.io/maven-central/v/net.mm2d.color-chooser/color-chooser)](https://search.maven.org/artifact/net.mm2d.color-chooser/color-chooser)

## ScreenShots

|![](readme/1.png)|![](readme/2.png)|![](readme/3.png)|

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

|![](readme/4.png)|![](readme/5.png)|![](readme/6.png)|

|![](readme/7.png)|![](readme/8.png)|![](readme/9.png)|

## How to use

### Jetpack Compose

latest version: ![Maven Central](https://img.shields.io/maven-central/v/net.mm2d.color-chooser/color-chooser-compose)

```gradle

dependencies {

    implementation 'net.mm2d.color-chooser:color-chooser-compose:'

}

```

```kotlin

var show by rememberSaveable { mutableStateOf(false) }

...

if (!show) return

ColorChooserDialog(

    initialColor = Color(color),

    onDismissRequest = {

        show = false

        // dismiss the dialog 

    },

    onChooseColor = { color ->

        // handle chosen color

    },

)

```

### View-base app

latest version: ![Maven Central](https://img.shields.io/maven-central/v/net.mm2d.color-chooser/color-chooser)

```gradle

dependencies {

    implementation 'net.mm2d.color-chooser:color-chooser:'

}

```

Register the listener to receive the result.

Write the following process in onViewCreated of Fragment or onCreate of Activity.

```kotlin

ColorChooserDialog.registerListener(REQUEST_KEY, this) {

    // it is selected color as @ColorInt

}

```

To show dialog. On `FragmentActivity` or `Fragment`

```kotlin

ColorChooserDialog.show(

    this,         // Fragment or FragmentActivity

    REQUEST_KEY,  // request key for receive result

    initialColor, // initial color, optional, default #FFFFFF

    true,         // need for alpha, optional, default false

    TAB_RGB       // initial tab, TAB_PALETTE/TAB_HSV/TAB_RGB, optional, default  TAB_PALETTE

)

```

*The style of implementing a callback interface in Activity and Fragment has been deprecated.*

Please see [Sample code](sample/src/main/java/net/mm2d/color/chooser/sample/MainActivity.kt) for detail.

## API Document

- [dokka](https://ohmae.github.io/color-chooser/dokka/)

## Dependent OSS

- [color-chooser](./chooser/dependencies/releaseRuntimeClasspath.txt)

- [color-chooser-compose](./chooser-compose/dependencies/releaseRuntimeClasspath.txt)

## Author

大前 良介 (OHMAE Ryosuke)

http://www.mm2d.net/

## License

[MIT License](./LICENSE)