Alwan

Alwan is an Android Jetpack Compose color picker library.

Preview

Recording.mp4

image

Download

Gradle:

dependencies {
  implementation 'com.raedapps:alwan:1.0.0'
}

Usage Guide

You can use Alwan composable as following:

Alwan(
  onColorChanged = { color -> },
  modifier = Modifier.width(300.dp),
)

onColorChanged is called whenever the user selects a new color.

Providing the default color:

Use AlwanState to control the initially selected color:

Alwan(
  onColorChanged = { },
  modifier = Modifier.width(300.dp),
  state = rememberAlwanState(initialColor = Color.Yellow),
)

Showing the alpha slider

The alpha slider is hidden by default. Use the showAlphaSlider parameter to show it:

Alwan(
  onColorChanged = { },
  showAlphaSlider = true,
)

Using AlwanDialog

You can use the AlwanDialog as following:

AlwanDialog(
  onColorChanged = { },
  onDismissRequest = { },
)

AlwanDialog can be customized with positive & negative buttons:

AlwanDialog(
  onDismissRequest = { },
  onColorChanged = { },
  positiveButtonText = "OK",
  onPositiveButtonClick = { },
  negativeButtonText = "CANCEL",
  onNegativeButtonClick = { },
)

License

Copyright 2022 Raed Mughaus

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.

GitHub

View Github