ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

不止能选日期:WheelPickerCompose WheelTextPicker 通用文字滚轮选择器使用指南

不止能选日期:WheelPickerCompose WheelTextPicker 通用文字滚轮选择器使用指南 不止能选日期WheelPickerCompose WheelTextPicker 通用文字滚轮选择器使用指南【免费下载链接】WheelPickerComposeAdd Wheel Date - Time Picker in Android Jetpack Compose.项目地址: https://gitcode.com/gh_mirrors/wh/WheelPickerComposeWheelPickerCompose 是一个基于 Android Jetpack Compose 的滚轮选择器开源库除内置的日期、时间、日期时间三个滚轮控件外还提供WheelTextPicker 通用文字滚轮选择器可把任意字符串列表城市、规格、排序方式变成带吸附、3D 透视与高亮框的滚轮效果。本文带你快速上手这个文字滚轮选择器。什么是 WheelTextPicker很多 Compose 开发者只知道日期选择控件却忽略了它的「通用性」。WheelTextPicker 与日期滚轮共用同一套底层引擎源码见 WheelTextPicker.kt它只做一件事把ListString交给内部 WheelPicker.kt 渲染基于LazyColumn Snapper 惯性吸附松手自动对齐到最近一项每行文字带3D 旋转透视与透明度渐变中间选中项最清晰回调返回选中项下标而非具体值业务层自己映射数据灵活度极高 简单说日期选择器是「特化版」WheelTextPicker 才是「万能版」。WheelTextPicker 快速上手三步集成第一步添加依赖在settings.gradle中配置仓库并添加依赖完整说明见 settings.gradle 与 gradle.propertiesrepositories { google() mavenCentral() maven { url https://jitpack.io } } dependencies { implementation com.github.commandiron:WheelPickerCompose:1.1.11 }最低支持 API 21若需兼容 API 26 以下系统启用coreLibraryDesugaring即可。第二步三行代码召唤滚轮WheelTextPicker( texts listOf(北京, 上海, 广州, 深圳), rowCount 5 ) { snappedIndex - null }texts是文字列表rowCount控制可视行数最后一个参数是滚动结束回调。示例可参考 MainActivity.kt。第三步用回调处理选中结果onScrollFinished回调签名为(snappedIndex: Int) - Int?有两个用途返回值行为null保持当前吸附位置把下标交给业务层使用一个下标让滚轮自动跳转到该位置可实现循环滚动或边界修正例如拿到下标后执行selectedCity cities[snappedIndex]就完成了选择。常用参数一览新手必看参数默认值说明texts必填滚轮展示的字符串列表startIndex0初始选中下标size128.dp × 128.dp滚轮宽高rowCount需指定可视行数影响行高与透视角度styletitleMedium文字样式color主题内容色文字颜色selectorProperties默认高亮框选中项的描边/背景样式onScrollFinished{ null }滚动结束回调返回下标高亮框与滚动效果怎么定制想要日期选择器那种圆角高亮框用WheelPickerDefaults.selectorProperties()一行搞定selectorProperties WheelPickerDefaults.selectorProperties( shape RoundedCornerShape(0.dp), color Color(0xFFf1faee).copy(alpha 0.2f), border BorderStroke(2.dp, Color(0xFFf1faee)) )可以调整enabled开关高亮、shape圆角/直角、color背景色、border边框。吸附与 3D 透视算法实现在 WheelPicker.kt 中无需自己计算。适合哪些使用场景️城市/地区选择地址表单、定位切换商品规格选择容量、颜色、套餐档位排序与筛选默认排序、按销量、按价格组合选择面板把多个 WheelTextPicker 横排即可拼出自定义「省/市/区」或「年/月/自定义字段」选择器与内置 WheelDatePicker.kt、WheelTimePicker.kt 风格统一新手常见疑问 FAQQ1WheelTextPicker 和 WheelDatePicker 有什么区别日期选择器直接返回LocalDate内部还处理了闰月、年份联动WheelTextPicker 返回下标适合一切「非日期」的列表选择。Q2滚轮为什么松手会自动对齐底层集成了 Snapper 惯性吸附见 WheelPicker.kt滚动结束后自动停靠到最近项体验接近 iOS 原生 UIPickerView。Q3列表项很多会卡吗不会。滚轮基于LazyColumn懒加载只创建可视区域的条目上千条文字也能流畅滚动。小结WheelPickerCompose 不止能选日期时间。借助WheelTextPicker 通用文字滚轮选择器你只需传入一个字符串列表就能获得带吸附、透视动画和高亮框的原生质感滚轮覆盖城市、规格、排序等绝大多数选择场景。三步集成、即插即用值得加入你的 Compose 工具箱 【免费下载链接】WheelPickerComposeAdd Wheel Date - Time Picker in Android Jetpack Compose.项目地址: https://gitcode.com/gh_mirrors/wh/WheelPickerCompose创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表