AndroidPicker项目API详解：从窗体到滚轮的完整指南

AndroidPicker项目API详解：从窗体到滚轮的完整指南

AndroidPicker 安卓选择器类库，包括日期及时间选择器（可用于出生日期、营业时间等）、单项选择器（可用于性别、民族、职业、学历、星座等）、二三级联动选择器（可用于车牌号、基金定投日期等）、城市地址选择器（分省级、地市级及区县级）、数字选择器（可用于年龄、身高、体重、温度等）、日历选日期择器（可用于酒店及机票预定日期）、颜色选择器、文件及目录选择器、图片选择器等……WheelPicker/DatePicker/TimePicker/OptionPicker/NumberPicker/LinkagePicker/AddressPicker/CarPlatePicker/CalendarPicker/ColorPicker/FilePicker/ImagePicker etc. 项目地址: https://gitcode.com/gh_mirrors/an/AndroidPicker

前言

AndroidPicker是一个功能强大的Android选择器组件库，提供了丰富的UI控件和灵活的配置选项。本文将深入解析该项目的核心API，帮助开发者快速掌握其使用方法。

窗体相关API

BaseDialog基础对话框

BaseDialog是所有对话框的基类，提供了对话框的基本配置能力：

1. 外观控制：

   • setBackgroundColor()/setBackgroundResource()/setBackgroundDrawable()：三种方式设置对话框背景
   • setLayout()/setWidth()/setHeight()：精确控制对话框尺寸
   • setGravity()：控制对话框在屏幕中的位置（居中或底部显示）

2. 交互控制：

   • disableCancel()：禁用返回键取消对话框
   • setOnShowListener()/setOnDismissListener()：监听对话框显示/隐藏事件

3. 视觉效果：

   • setDimAmount()：调整背景遮罩透明度（0-1之间）
   • setAnimationStyle()：自定义显示/隐藏动画

ModalDialog模态对话框

ModalDialog在BaseDialog基础上扩展了更丰富的UI元素：

1. 布局分区：

   • getHeaderView()/getBodyView()/getFooterView()：分别获取头部、主体和底部视图
   • getTopLineView()：获取顶部分割线视图

2. 标题控制：

   • setTitle()：设置标题文本
   • getTitleView()：获取标题视图进行自定义

3. 按钮控制：

   • getCancelView()/getOkView()：获取取消/确定按钮视图
   • 可通过这些方法获取视图后设置点击事件等

全局样式配置

DialogConfig类提供了全局样式配置能力：

1. 预设样式：

   • setDialogStyle()：应用内置的四种样式（DialogStyle枚举）

2. 颜色主题：

   • setDialogColor()：通过DialogColor对象统一配置颜色
   • 可配置项包括背景色、分割线颜色、按钮文字颜色等

滚轮选择器API

WheelView/WheelLayout核心组件

滚轮选择器的核心实现类，提供了丰富的自定义选项：

1. 数据相关：

   • setData()：设置数据源
   • setDefaultPosition()/setDefaultValue()：设置默认选中项
   • setFormatter()：自定义数据显示格式

2. 滚动行为：

   • scrollTo()：滚动到指定位置
   • setCyclicEnabled()：启用无限循环滚动
   • setCurvedEnabled()：启用弯曲效果（3D效果）

3. 视觉样式：

   • setCurtainEnabled()：显示选中项背景
   • setIndicatorEnabled()：显示指示线
   • setTextColor()/setSelectedTextColor()：分别设置未选中和选中项文字颜色
   • setTypeface()：自定义字体

4. 性能优化：

   • setSameWidthEnabled()：声明所有条目等宽
   • setMaxWidthText()：指定最长文本优化计算

各类Picker组件

项目提供了多种预置的选择器（如DatePicker、NumberPicker等），它们都具备以下核心方法：

1. 初始值设置：

   • setDefaultValue()：通过值设置默认项
   • setDefaultPosition()：通过位置设置默认项

2. 事件监听：

   • setOnXXXPickedListener()：选择完成回调

3. 视图获取：

   • getWheelLayout()：获取底层滚轮布局
   • getLabelView()：获取标签视图（如"年"、"月"等）

文件选择器FilePicker

文件选择器提供了额外的文件系统相关功能：

1. 配置管理：

   • setExplorerConfig()：设置文件管理器配置
   • 可配置根目录、文件过滤条件等

2. 功能扩展：

   • getFileExplorer()：获取文件管理器对象
   • 可进行更底层的文件操作

最佳实践建议

1. 样式统一： 建议通过DialogConfig配置全局样式，确保应用内选择器风格一致

2. 性能优化：

   • 对于固定宽度的滚轮，使用setSameWidthEnabled(true)
   • 对于变宽滚轮，使用setMaxWidthText()指定最长文本

3. 用户体验：

   • 考虑启用setCurvedEnabled(true)增加3D效果
   • 使用setCurtainEnabled(true)突出显示选中项

4. 自定义扩展：

   • 通过getXXXView()方法获取各部件视图进行深度定制
   • 使用setFormatter()实现特殊数据显示需求

结语

AndroidPicker提供了从简单到复杂的选择器解决方案，通过灵活的API可以满足各种业务场景需求。掌握这些核心API后，开发者可以轻松实现美观、高效的选择器组件。

AndroidPicker 安卓选择器类库，包括日期及时间选择器（可用于出生日期、营业时间等）、单项选择器（可用于性别、民族、职业、学历、星座等）、二三级联动选择器（可用于车牌号、基金定投日期等）、城市地址选择器（分省级、地市级及区县级）、数字选择器（可用于年龄、身高、体重、温度等）、日历选日期择器（可用于酒店及机票预定日期）、颜色选择器、文件及目录选择器、图片选择器等……WheelPicker/DatePicker/TimePicker/OptionPicker/NumberPicker/LinkagePicker/AddressPicker/CarPlatePicker/CalendarPicker/ColorPicker/FilePicker/ImagePicker etc. 项目地址: https://gitcode.com/gh_mirrors/an/AndroidPicker