WheelPickerCompose:Android Jetpack Compose 日期时间选择器,支持自定义格式与样式

Add Wheel Date - Time Picker in Android Jetpack Compose.

分支2Tags25
文件最后提交记录最后更新时间
3 年前
3 年前
3 年前
3 年前
3 年前
3 年前
3 年前
3 年前
3 年前
3 年前
3 年前
3 年前
3 年前
3 年前

WheelPickerCompose

JitPack版本 支持的API级别

在Android Jetpack Compose中添加轮盘日期和时间选择器。

轮盘选择器预览图

使用方法

选择器类型 示例用法
轮盘日期时间选择器动画 WheelDateTimePicker { snappedDateTime -> ... }
轮盘日期选择器动画 WheelDatePicker { snappedDate -> ... }
轮盘时间选择器动画 WheelTimePicker { snappedTime -> ... }
12小时制时间选择器动画 WheelTimePicker(timeFormat = TimeFormat.AM_PM) { snappedTime -> ... }

功能特点

以下代码示例展示了如何配置WheelDateTimePicker,定制其外观和行为:

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 -> /* 处理选定的时间 */ }

展示效果: 功能特点动图

配置项目

  1. 打开settings.gradle(文件内容示例如下)

    dependencyResolutionManagement {
        repositories {
            google()
            mavenCentral()
            // 添加JitPack仓库
            maven { url 'https://jitpack.io' }
            ...
        }
    }
    
  2. 同步项目。

  3. 添加依赖项到您的build.gradle文件中。

    dependencies {
        implementation 'com.github.commandiron:WheelPickerCompose:1.1.11'
    }
    
  4. 如果你的应用支持API级别低于26,则需进行额外配置(可选)

    compileOptions {
        coreLibraryDesugaringEnabled true
    }
    
    dependencies {
        coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.1.6'
    }