https://github.com/seo-4d696b75/compose-m3-picker

Android Jetpack Compose picker implementation compatible with Material3 design system.
https://github.com/seo-4d696b75/compose-m3-picker

Last synced: 12 days ago
JSON representation

Android Jetpack Compose picker implementation compatible with Material3 design system.

• Host: GitHub
• URL: https://github.com/seo-4d696b75/compose-m3-picker
• Owner: Seo-4d696b75
• License: apache-2.0
• Created: 2024-12-26T08:24:53.000Z (15 days ago)
• Default Branch: main
• Last Pushed: 2024-12-26T09:21:50.000Z (15 days ago)
• Last Synced: 2024-12-26T09:28:57.556Z (15 days ago)
• Language: Kotlin
• Size: 753 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Jetpack Compose Picker

Android library providing a Picker implemented by Jetpack Compose.

[![Maven version](https://img.shields.io/maven-central/v/com.seo4d696b75.compose/material3-picker)](https://central.sonatype.com/artifact/com.seo4d696b75.compose/material3-picker)

![License MIT](https://img.shields.io/badge/Apache_2.0-9E9F9F?label=License)

![Android minimum version](https://img.shields.io/badge/26+-9E9F9F?&label=Minimum&logo=android)

## Features



- ✅️ Same experience as [NumberPicker view](https://developer.android.com/reference/android/widget/NumberPicker)

- ✅️ Supports scroll and fling

- ✅️ Compatible with Material3

- ✅️ Custamizable with slot pattern

## Installation

In your module level `build.gradle` file

```gradle

dependencies {

    implementation("com.seo4d696b75.compose:material3-picker:$version")

}

```

## Basic Usage

### Number picker



```kotlin

    var value by remember { mutableIntStateOf(0) }

    NumberPicker(

        value = value,

        range = (0..10).toPersistentList(),

        onValueChange = { value = it },

    )

```

### Picker with generic values



```kotlin

    val values = remember {

        persistentListOf(

            LocalDate.of(2024, 12, 1),

            LocalDate.of(2024, 12, 2),

            LocalDate.of(2024, 12, 3),

            LocalDate.of(2024, 12, 4),

            LocalDate.of(2024, 12, 5),

            LocalDate.of(2024, 12, 6),

        )

    }

    var index by remember { mutableIntStateOf(0) }

    Picker(

        index = index,

        values = values,

        onIndexChange = { index = it },

    )

```

### Customize picker



```kotlin

    val values = remember {

        persistentListOf(

            Icons.Outlined.Build,

            Icons.Outlined.MailOutline,

            Icons.Outlined.Call,

            Icons.Outlined.AccountCircle,

            Icons.Outlined.Create,

            Icons.Outlined.Delete,

        )

    }

    val state = rememberPickerState(values)

    Picker(

        state = state,

        enabled = true,

        colors = PickerDefaults.colors(contentColor = MaterialTheme.colorScheme.secondary),

        labelSize = DpSize(240.dp, 64.dp),

        dividerHeight = 4.dp,

        flingBehavior = PickerDefaults.flingBehavior(state = state, flingEnabled = false),

    ) { icon, enabled ->

        Row(

            horizontalArrangement = Arrangement.spacedBy(8.dp),

            verticalAlignment = Alignment.CenterVertically,

        ) {

            Icon(

                imageVector = icon,

                contentDescription = null,

            )

            Text(text = icon.name)

        }

    }

```