CharacterPickerView实战教程：三级联动选择器的终极实现方案

CharacterPickerView实战教程：三级联动选择器的终极实现方案

【免费下载链接】CharacterPickerView项目地址: https://gitcode.com/gh_mirrors/ch/CharacterPickerView

CharacterPickerView是一款功能强大的Android三级联动选择器组件，能够帮助开发者快速实现如地址选择、时间选择等多级联动功能。本文将详细介绍如何使用CharacterPickerView打造流畅的三级联动选择体验，从基础配置到高级应用，让你轻松掌握这一实用工具。

📌 核心功能与优势

CharacterPickerView作为轻量级选择器组件，具有以下显著特点：

• 完整的三级联动支持：通过CharacterPickerView类的setPicker方法可直接配置三级数据，实现级联选择效果
• 灵活的自定义能力：支持设置字体、循环滚动、选中位置等属性，满足多样化UI需求
• 简洁的API设计：提供直观的setCurrentPositions方法设置选中项，getCurrentPositions方法获取选择结果
• 平滑的滚动体验：内部集成LoopView实现惯性滚动效果，确保操作流畅自然

🚀 快速集成步骤

1. 引入项目依赖

首先通过Git克隆项目到本地：

git clone https://gitcode.com/gh_mirrors/ch/CharacterPickerView

2. 基础布局配置

在需要使用选择器的布局文件中添加CharacterPickerView组件：

<cn.jeesoft.widget.pickerview.CharacterPickerView android:id="@+id/pickerView" android:layout_width="match_parent" android:layout_height="wrap_content"/>

3. 初始化三级数据

通过setPicker方法配置三级联动数据，示例代码位于demo/src/main/java/cn/jeesoft/demo/OptionsWindowHelper.java：

// 三级联动数据格式 List<String> options1Items; // 一级数据列表 List<List<String>> options2Items; // 二级数据列表（嵌套一级索引） List<List<List<String>>> options3Items; // 三级数据列表（嵌套一、二级索引） // 设置三级联动数据 characterPickerView.setPicker(options1Items, options2Items, options3Items);

🎮 核心功能实现

三级联动效果展示

CharacterPickerView的三级联动效果是其核心功能，通过以下代码实现：

设置与获取选中项

// 设置选中项（省、市、区） characterPickerView.setSelectOptions(0, 2, 5); // 获取选中项位置 int[] positions = characterPickerView.getCurrentPositions(); int provinceIndex = positions[0]; // 一级选中索引 int cityIndex = positions[1]; // 二级选中索引 int areaIndex = positions[2]; // 三级选中索引

监听选择变化

通过OnOptionChangedListener接口监听选择变化事件：

characterPickerView.setOnOptionChangedListener(new OnOptionChangedListener() { @Override public void onOptionChanged(int option1, int option2, int option3) { // 处理选择变化逻辑 String province = options1Items.get(option1); String city = options2Items.get(option1).get(option2); String area = options3Items.get(option1).get(option2).get(option3); } });

⚙️ 高级自定义配置

循环滚动设置

// 设置是否循环滚动 characterPickerView.setCyclic(true);

字体样式调整

// 设置字体 Typeface typeface = Typeface.createFromAsset(getAssets(), "fonts/custom_font.ttf"); characterPickerView.setTypeface(typeface); // 设置最大字体大小 characterPickerView.setMaxTextSize(18);

💡 使用场景与最佳实践

地址选择器实现

OptionsWindowHelper类提供了完整的地址选择器实现，通过构建CharacterPickerWindow可以快速创建弹窗式选择器：

CharacterPickerWindow pickerWindow = OptionsWindowHelper.builder(this, new OptionsWindowHelper.OnOptionsSelectListener() { @Override public void onOptionsSelect(String province, String city, String area) { // 处理选择结果 } }); pickerWindow.showAtLocation(findViewById(R.id.main_layout), Gravity.BOTTOM, 0, 0);

数据初始化最佳实践

建议在Application或Activity初始化时准备选择器数据，避免重复创建：

// 推荐数据初始化方式 OptionsWindowHelper.setPickerData(characterPickerView);

📚 组件结构解析

CharacterPickerView的核心实现位于library/src/main/java/cn/jeesoft/widget/pickerview/目录下，主要包含：

• CharacterPickerView.java：主视图类，提供对外API接口
• WheelOptions.java：内部实现类，管理三级联动逻辑
• CharacterPickerWindow.java：弹窗容器类，方便以弹窗形式使用
• OnOptionChangedListener.java：选择变化监听器接口

通过这些组件的协作，实现了高效、灵活的三级联动选择功能。

🎯 总结

CharacterPickerView为Android开发者提供了一个简单易用的三级联动选择器解决方案，无论是地址选择、时间选择还是其他多级数据选择场景，都能轻松应对。其简洁的API设计和良好的可定制性，使其成为项目开发中的得力助手。通过本文介绍的方法，你可以快速将CharacterPickerView集成到自己的项目中，为用户提供流畅的选择体验。

【免费下载链接】CharacterPickerView项目地址: https://gitcode.com/gh_mirrors/ch/CharacterPickerView