【亲测免费】 WheelPickerCompose 使用教程

项目介绍

WheelPickerCompose 是一个用于 Android Jetpack Compose 的开源库，它提供了一个轮式日期和时间选择器。这个库允许开发者轻松地在他们的 Compose 项目中添加日期和时间选择功能，支持自定义样式和格式。

项目快速启动

添加依赖

首先，在你的项目的 settings.gradle 文件中添加 JitPack 仓库：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url 'https://jitpack.io' }
    }
}

然后在你的 build.gradle 文件中添加依赖：

dependencies {
    implementation 'com.github.commandiron:WheelPickerCompose:1.1.11'
}

使用示例

在你的 Compose 项目中使用 WheelDateTimePicker：

import com.commandiron.wheel_picker_compose.WheelDateTimePicker
import java.time.LocalDateTime

@Composable
fun MyDateTimePicker() {
    WheelDateTimePicker(
        startDateTime = LocalDateTime.of(2025, 10, 20, 5, 30),
        minDateTime = LocalDateTime.now(),
        maxDateTime = LocalDateTime.of(2025, 10, 20, 5, 30),
        timeFormat = TimeFormat.AM_PM
    ) { snappedDateTime ->
        // 处理选择的日期时间
    }
}

应用案例和最佳实践

自定义样式

你可以通过设置 selectorProperties 和其他参数来自定义选择器的样式：

WheelDateTimePicker(
    startDateTime = LocalDateTime.of(2025, 10, 20, 5, 30),
    minDateTime = LocalDateTime.now(),
    maxDateTime = LocalDateTime.of(2025, 10, 20, 5, 30),
    timeFormat = TimeFormat.AM_PM,
    size = DpSize(200.dp, 100.dp),
    rowCount = 5,
    textStyle = MaterialTheme.typography.titleSmall,
    textColor = Color(0xFFffc300),
    selectorProperties = WheelPickerDefaults.selectorProperties(
        enabled = true,
        shape = RoundedCornerShape(0.dp),
        color = Color(0xFFf1faee).copy(alpha = 0.2f),
        border = BorderStroke(2.dp, Color(0xFFf1faee))
    )
) { snappedDateTime ->
    // 处理选择的日期时间
}

处理选择结果

在 snappedDateTime 回调中处理用户选择的日期和时间：

{ snappedDateTime ->
    // 在这里处理选择的日期时间
    println("Selected DateTime: $snappedDateTime")
}

典型生态项目

WheelPickerCompose 可以与其他 Jetpack Compose 库和组件无缝集成，例如：

• Accompanist: 用于权限请求和系统 UI 控制。
• Coil: 用于图像加载。
• Hilt: 用于依赖注入。

这些库和组件可以与 WheelPickerCompose 一起使用，以构建功能丰富且高度可定制的 Android 应用程序。