Android-PickerView自定义选择器开发实战：从基础到高级UI定制-编程阁

Android-PickerView自定义选择器开发实战：从基础到高级UI定制

【免费下载链接】Android-PickerViewThis is a picker view for android , support linkage effect, timepicker and optionspicker.（时间选择器、省市区三级联动）项目地址: https://gitcode.com/gh_mirrors/an/Android-PickerView

还在为Android应用中的日期选择、地址选择等场景发愁吗？系统自带的DatePicker样式单一、交互体验差，而完全自定义又需要大量开发工作。Android-PickerView正是为解决这一痛点而生，它提供了丰富的样式配置和灵活的布局定制能力，让你轻松打造专业级选择器体验。

为什么选择Android-PickerView？ 🤔

在移动应用开发中，选择器是用户交互的重要组成部分。传统的解决方案要么样式固定无法定制，要么开发成本高昂。Android-PickerView通过以下核心优势脱颖而出：

开箱即用：内置多种常用选择器类型，无需从零开始
高度可定制：支持颜色、字体、间距等全方位样式调整
灵活布局：既可使用默认布局，也可完全自定义UI结构
性能优异：轻量级设计，流畅的滚动体验
多级联动：完美支持省市区三级联动等复杂场景

快速上手：构建你的第一个选择器 🚀

让我们从一个简单的时间选择器开始，体验Android-PickerView的基本用法：

// 初始化时间选择器 TimePickerView pvTime = new TimePickerBuilder(this, new OnTimeSelectListener() { @Override public void onTimeSelect(Date date, View v) { // 时间选择回调 SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd HH:mm"); String selectedTime = format.format(date); tvTime.setText(selectedTime); } }) .setType(new boolean[]{true, true, true, true, true, true}) // 年月日时分秒 .setLabel("年", "月", "日", "时", "分", "秒") // 设置单位 .build(); // 显示选择器 pvTime.show();

这段代码创建了一个包含年月日时分秒的完整时间选择器，用户选择后会通过回调返回Date对象。

图1：Android-PickerView基础时间选择器效果 - 支持年月日时分秒的完整时间选择

核心功能深度解析 🔍

1. 选项选择器：灵活应对多场景需求

选项选择器(OptionsPickerView)是Android-PickerView的另一大核心组件，特别适合非时间类的选择需求：

// 准备数据源 List<String> optionsItems = Arrays.asList("选项一", "选项二", "选项三", "选项四"); // 构建选项选择器 OptionsPickerView pvOptions = new OptionsPickerBuilder(this, new OnOptionsSelectListener() { @Override public void onOptionsSelect(int options1, int options2, int options3, View v) { // 返回选中项的文本 String selectedText = optionsItems.get(options1); tvOptions.setText(selectedText); } }) .setTitleText("请选择") .setContentTextSize(18) .setSelectOptions(0) // 默认选中第一项 .build(); pvOptions.setPicker(optionsItems); // 设置数据 pvOptions.show(); // 显示选择器

2. 三级联动：省市区选择的完美解决方案

对于地址选择这类需要多级联动的场景，Android-PickerView提供了优雅的解决方案：

// 初始化三级数据 private void initLinkageData() { // 第一级：省份列表 List<String> provinceList = getProvinceList(); // 第二级：城市列表（根据省份动态变化） List<List<String>> cityList = new ArrayList<>(); for (String province : provinceList) { cityList.add(getCityListByProvince(province)); } // 第三级：区域列表（根据城市动态变化） List<List<List<String>>> areaList = new ArrayList<>(); for (List<String> cities : cityList) { List<List<String>> tempAreaList = new ArrayList<>(); for (String city : cities) { tempAreaList.add(getAreaListByCity(city)); } areaList.add(tempAreaList); } // 创建联动选择器 pvOptions.setPicker(provinceList, cityList, areaList, true); }

图2：JSON数据驱动的省市区三级联动选择器 - 数据动态加载，交互自然流畅

高级定制：打造个性化选择器界面 🎨

1. 自定义布局实现

当默认布局无法满足产品需求时，Android-PickerView允许你使用自定义布局文件：

pvCustomOptions = new OptionsPickerBuilder(this, new OnOptionsSelectListener() { @Override public void onOptionsSelect(int options1, int options2, int options3, View v) { // 处理选择结果 } }) .setLayoutRes(R.layout.pickerview_custom_options, new CustomListener() { @Override public void customLayout(View v) { // 获取自定义布局中的控件 TextView tvSubmit = v.findViewById(R.id.tv_finish); TextView tvAdd = v.findViewById(R.id.tv_add); ImageView ivCancel = v.findViewById(R.id.iv_cancel); // 自定义按钮事件 tvSubmit.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { pvCustomOptions.returnData(); // 返回选择数据 pvCustomOptions.dismiss(); } }); // 添加选项功能 tvAdd.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { // 动态添加新选项 addNewOption(); pvCustomOptions.setPicker(updatedOptions); } }); } }) .build();

图3：完全自定义布局的选择器 - 支持添加新选项等扩展功能

2. 样式深度定制

通过OptionsPickerBuilder提供的丰富配置方法，你可以精细调整选择器的每一个视觉元素：

.setTitleText("城市选择") // 标题文字 .setTitleColor(Color.WHITE) // 标题颜色 .setTitleBgColor(0xFF333333) // 标题背景 .setContentTextSize(20) // 内容文字大小 .setTextColorCenter(Color.BLACK) // 选中项颜色 .setTextColorOut(Color.GRAY) // 未选中项颜色 .setDividerColor(Color.LTGRAY) // 分割线颜色 .setOutSideCancelable(false) // 点击外部不可取消 .isDialog(true) // 对话框模式

特色功能：公农历混合时间选择 📅

对于需要兼顾传统农历的应用场景，Android-PickerView提供了公农历混合选择功能：

// 初始化农历选择器 pvCustomLunar = new TimePickerBuilder(this, new OnTimeSelectListener() { @Override public void onTimeSelect(Date date, View v) { // 处理选择的时间 } }) .setLayoutRes(R.layout.pickerview_custom_lunar, new CustomListener() { @Override public void customLayout(View v) { final CheckBox cb_lunar = v.findViewById(R.id.cb_lunar); // 公农历切换 cb_lunar.setOnCheckedChangeListener(new CompoundButton.OnCheckedChangeListener() { @Override public void onCheckedChanged(CompoundButton buttonView, boolean isChecked) { pvCustomLunar.setLunarCalendar(isChecked); } }); } }) .setType(new boolean[]{true, true, true, false, false, false}) // 年月日 .build();

图4：公农历混合时间选择器 - 同时支持现代公历和传统农历日期选择

实战技巧：优化选择器用户体验 ✨

1. 数据预加载策略

对于三级联动等需要大量数据的场景，建议采用数据预加载策略：

// 在Activity的onCreate中预加载数据 @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // 异步加载数据 new Thread(new Runnable() { @Override public void run() { initLinkageData(); runOnUiThread(new Runnable() { @Override public void run() { // 数据加载完成后初始化选择器 initOptionPicker(); } }); } }).start(); }

2. 选择器状态管理

合理管理选择器的显示状态，避免内存泄漏：

@Override protected void onDestroy() { if (pvTime != null) { pvTime.dismiss(); } if (pvOptions != null) { pvOptions.dismiss(); } super.onDestroy(); }

项目集成指南 📦

1. 添加依赖

在你的项目中添加Android-PickerView依赖：

dependencies { implementation 'com.contrarywind:Android-PickerView:4.1.9' }

2. 获取项目源码

如果需要更深入的定制或了解实现原理，可以克隆项目源码：

git clone https://gitcode.com/gh_mirrors/an/Android-PickerView

总结与展望 🎯

通过本文的介绍，相信你已经掌握了Android-PickerView的核心用法和高级定制技巧。这个强大的选择器库不仅能帮你快速实现各种选择需求，还提供了充分的扩展空间来满足个性化需求。

核心要点回顾：

基础时间选择器适合简单的日期时间选择场景
选项选择器适用于非时间类的单项或多项选择
三级联动完美解决了省市区等层级数据选择
自定义布局让你完全掌控UI设计和交互逻辑

在实际开发中，建议根据具体场景选择最合适的实现方式。对于简单的日期选择，使用默认配置即可；对于需要与产品设计高度一致的场景，则推荐使用自定义布局方案。

Android-PickerView的灵活性和易用性使其成为Android开发中不可或缺的工具库。无论是新手开发者还是经验丰富的工程师，都能从中受益，提升开发效率和用户体验。

现在就开始在你的项目中尝试使用Android-PickerView吧，相信它会让你的应用选择器体验提升到一个新的水平！

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

Android-PickerView自定义选择器开发实战：从基础到高级UI定制