---

Overview

Contact

Preview

Include

Compile

implementation 'dev.aige.pub:WheelPicker:1.2.3'

Note / 注意
Since 1.2.2, internal dependencies are marked as compileOnly. Please ensure you have added the following dependencies to your project manually to avoid exceptions.
自 1.2.2 版本起，为了解决依赖冲突内部库已被标记为 compileOnly。请确保您的项目 build.gradle 中已手动添加以下依赖：

// Core Dependencies / 核心依赖
implementation("org.jetbrains.kotlin:kotlin-stdlib:<version>")
implementation("androidx.appcompat:appcompat:<version>")
implementation("com.google.code.gson:gson:<version>")

// Compose Support (Optional) / Jetpack Compose 支持（可选）
implementation(platform("androidx.compose:compose-bom:<version>"))
implementation("androidx.compose.ui:ui")
implementation("androidx.compose.runtime:runtime")

or

<dependency>
  <groupId>dev.aige.pub</groupId>
  <artifactId>WheelPicker</artifactId>
  <version>1.2.3</version>
  <type>pom</type>
</dependency>

Usage

WIKI | 帮助文档

Versions

1.2.3

• BugFix: WheelYearPicker / WheelMonthPicker / WheelDayPicker throws UnsupportedOperationException when inflated inside WheelDatePicker (Kotlin virtual dispatch calling overridden data setter during parent init)
• 修复：WheelYearPicker/WheelMonthPicker/WheelDayPicker 在 WheelDatePicker 内 inflate 时抛出 UnsupportedOperationException（Kotlin 虚派发在父类 init 阶段调用了子类重写的 data setter）

1.2.2

• Feature: Support click on adjacent items to switch quickly
• BugFix: WheelPicker stops between two items when fling is interrupted by touch
• Optimization: Mark dependencies as compileOnly
• 新增：支持点击相邻数据以快速切换选中项
• 修复：滑动过程中被触摸中断时，内容可能停在两项之间的问题
• 优化：将依赖库标记为 compileOnly 避免版本冲突

1.2.1

• Feature: Support Kotlin-style function interface for OnItemSelectedListener
• 新增 OnItemSelectedListener 的 Kotlin 函数式接口支持

1.2.0

• Feature: Support Jetpack Compose
• Feature: Migrate to Maven Central (New Group ID: dev.aige.pub)
• Feature: Upgrade to Kotlin & Material 3
• Optimization: Remove Handler for animation
• Chore: Upgrade target SDK to 36
• 新增 Jetpack Compose 支持
• 迁移至 Maven Central (新 Group ID: dev.aige.pub)
• 全面迁移至 Kotlin 并适配 Material 3
• 移除 Handler 动画实现以优化性能
• 升级 Target SDK 至 36

1.1.2

• BugFix:WheelPicker can not get the height in some layout
• Support Android Nougat

1.1.1

• BugFix:Scroll automatically when touch but not move on WheelPicker in some low resolution phone
• BugFix:Scroll range incorrect when invoke setData twice and set data source's length less than last
• BugFix:Wheel state do not refresh when invoke setData twice and set data source's length-1 less than last selected position
• BugFix:Switch between click and scroll event
• BugFix:Call OnItemSelectedListener more time when user want to scroll continuously
• BugFix:Scroll range incorrect when set current selected item again
• BugFix:Scroll will be triggered when click WheelPicker
• Function:All the parameters of WheelPicker will be reset when you setData
• ADD WheelYearPicker, WheelMonthPicker, WheelDayPicker
• ADD WheelDatePicker
• 修复某些低分辨率手机触摸不动时自滑动问题
• 修复第二次调用setData设置长度比上次小的数据时滑动范围不改变的问题
• 修复第二次调用setData设置长度位置小于上次选中位置时滚轮状态不刷新问题
• 修复点击与滑动事件切换的问题
• 修复当用户想连续滑动时出现多次回调的问题
• 修复重新设置选择的数据项位置后滑动范围错位问题
• 修复点击后触发滚动的问题
• 重新设置数据源后会重置滚轮选择器相关参数
• 新增年份、月份、日期选择器
• 新增三级联动的日期选择器

1.1.0 Stable

• Refactor project fix all known bug and some function additions
• I will create a tag for old beta version but not be updated anymore
• 重构项目发布稳定版修复测试版所有BUG以及新增功能
• Beta版本会打上TAG方便老版本过渡但不再更新

1.0.3 beta

• BugFix:Error parameter after scroll using setXXX method

1.0.2 beta

• BugFix:MotionEvent lost when point outside of view in WheelCurvedPicker

1.0.1 beta

• BugFix:Cache in WheelCuredPicker can not clean...a stupid mistake.

1.0.0 beta

• Preview for WheelPicker and support few function.

Function

• Data display circulation
• Set visible item count
• Get the current item data straight in stationary
• Monitor status of scroll get selected item data and other parameter when wheel stop
• Dynamic update data
• Set text color of selected or non-selected item
• Set item space
• Support display indicator and set the indicator's size and color
• Support display curtain and set the curtain's color
• Enable atmospheric effect
• Enable perspective effect
• Curl the items base on mathematic models
• Support item align when perspective or atmospheric enable
• 循环显示数据项
• 设置可见数据项条数
• 在滚轮静止状态直接获取选中数据项
• 滚动监听获取滚轮停止后选中项以及滚动各项参数
• 动态更新数据源
• 设置当前选中项文本颜色和非选中项文本颜色
• 设置数据项之间间隔
• 支持绘制指示器以及指定指示器颜色、尺寸
• 支持绘制幕布以及指定幕布颜色
• 可开启数据项空气感模拟
• 可开启数据项模拟真实透视效果
• 根据严格数学建模模拟滚轮弯曲效果
• 在开启透视或弯曲效果后支持让数据项左右对齐

Widgets

WheelDatePicker

Method

• setVisibleItemCount
• setCyclic
• setSelectedItemTextColor
• setItemTextColor
• setItemTextSize
• setItemSpace
• setIndicator
• setIndicatorColor
• setIndicatorSize
• setCurtain
• setCurtainColor
• setAtmospheric
• setCurved
• setItemAlignYear
• setItemAlignDay
• setYearFrame
• setSelectedYear
• setSelectedMonth
• setSelectedDay
• etc...

WheelYearPicker

Method

• All method of WheelPicker
• setYearFrame
• set/getYearStart
• set/getYearEnd
• set/getSelectedYear
• getCurrentYear

WheelMonthPicker

Method

• All method of WheelPicker
• set/getSelectedMonth
• getCurrentMonth

WheelDayPicker

Method

• All method of WheelPicker
• set/getSelectedDay
• getCurrentDay
• setYearAndMonth
• set/getYear
• set/getMonth

WheelAreaPicker

中国行政区域划分根据国家统计局最新数据国家统计局行政区域划分

---

Donation

如果您觉得该项目帮助了您那不妨赏小弟一杯咖啡钱 :)

You can support the project and thank the author for his hard work :)

• PayPal:xiaoaibaby@vip.qq.com

---

LICENSE

Copyright 2015-2025 AigeStudio

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.