Android筛选器终极指南:DropDownMenu如何帮你快速搭建电商级下拉筛选菜单
Android筛选器终极指南:DropDownMenu如何帮你快速搭建电商级下拉筛选菜单
做电商、本地生活类 App 的同学应该都熟悉"筛选"这个场景:点一下顶部的"分类 / 区域 / 价格",面板从上方滑出,选中后内容区刷新。开源项目 DropDownMenu 就是一款面向 Android 的筛选器组件,号称"a better DropDownMenu solution",提供了一套完整的下拉筛选菜单解决方案:内置顶部筛选条、展开动画、选中态高亮,并封装了单列列表、双列联动、网格等 5 种筛选视图,让你用极少代码就能搭出电商级筛选体验。
上图是项目自带 Sample 的实机演示:顶部一排筛选条,点击后菜单下滑展开,选中项高亮,底部内容区即时显示筛选结果。
为什么说它是"电商级"筛选器?
DropDownMenu 的设计目标是数据与视图彻底分离,这也是它能适配各种业务的原因:
- 🧩 Adapter 模式添加筛选条目:顶部有哪些筛选 tab,全部由 Adapter 声明,代码清晰、易维护
- 📦 泛型支持任意数据 model:字符串、自定义实体类都能直接塞进去
- ✅ 自研 FilterCheckedTextView:支持
checked属性,配合 selector 即可配置选中样式 - 🔗 FilterUrl 作为筛选参数中介:通过
toString()拼出筛选 URL,视图只管展示,数据独立流转
核心实现就在这个类里,阅读它有助于理解整个组件的运行机制:DropDownMenu.java。
三步快速搭建下拉筛选菜单
第一步:在布局中嵌入 DropDownMenu
组件库是独立的 filter-lib 模块,引入后只需在布局文件中声明,并在内部放置一个 id 为 mFilterContentView 的 View 作为内容区(可换成 RecyclerView 等):
<com.baiiu.filter.DropDownMenu
android:id="@+id/filterDropDownView"
android:layout_width="match_parent"
android:layout_height="match_parent">
<TextView
android:id="@id/mFilterContentView"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="center_vertical"
android:textSize="22sp" />
</com.baiiu.filter.DropDownMenu>
参考示例:activity_main.xml
第二步:实现 MenuAdapter 定义筛选条
顶部筛选 tab 的数量、标题、对应视图都由 MenuAdapter 接口声明,共 4 个方法:
| 方法 | 作用 |
|---|---|
getMenuCount() |
筛选条目个数 |
getMenuTitle(position) |
每个筛选器的默认标题 |
getBottomMargin(position) |
展开面板距底部的距离(方便放"确定"按钮) |
getView(position, parent) |
每个 tab 展开时的筛选视图 |
示例实现在 DropMenuAdapter.java。
第三步:一键挂载
代码中只需一行,把 Adapter 交给组件,顶部 tab 和展开面板就都就绪了:
dropDownMenu.setMenuAdapter(new DropMenuAdapter(this, titleList, this));
5 种筛选视图,覆盖常见业务场景
组件库在 typeview 目录下内置了现成视图,按场景对号入座:
- SingleListView —— 单列列表,适合"城市 / 分类"这类线性选项(SingleListView.java)
- DoubleListView —— 双列联动列表,左列选中后右列刷新,适合"品牌 → 型号"两级筛选
- SingleGridView —— 单列网格,适合"价格区间 / 排序方式"等少数量选项
- DoubleGridView —— 上下双网格,示例见 DoubleGridView.java
- BetterDoubleGridView —— 优化版双网格,带 ViewHolder 优化,示例见 BetterDoubleGridView.java
它们都提供链式 API,设置 adapter、点击回调、初始化数据一气呵成:
SingleListView<String> singleListView = new SingleListView<String>(mContext)
.adapter(new SimpleTextAdapter<String>(null, mContext) { ... })
.onItemClick(new OnFilterItemClickListener<String>() { ... });
singleListView.setList(list, -1); // -1 表示默认不选中
选中样式由 FilterCheckedTextView.java 实现——它实现了 Checkable 接口并配合 state_checked 状态,你只需用一个 selector drawable 就能让选中项变色,无需手写高亮逻辑。
用 FilterUrl 隔离数据与视图
选中某个筛选项后,把结果写进 FilterUrl.java 这个单例即可,例如:
FilterUrl.instance().singleListPosition = item;
FilterUrl.instance().positionTitle = item;
之后调用 FilterUrl.instance().toString() 就能拿到拼接好的筛选参数串,直接拿去请求接口或刷新列表。这种"中介"设计让筛选逻辑集中在一个数据类里,视图代码不再被业务参数污染,后期维护非常省心。
项目结构与上手建议
| 模块 | 说明 |
|---|---|
| filter-lib/ | 组件库:DropDownMenu、各类筛选视图、Adapter、工具类 |
| app/ | 完整示例:Activity 与 Fragment 两种集成方式 |
| README-cn.md | 中文使用说明 |
示例项目还提供了 Fragment 场景的完整用法,见 FilterFragment.java。本地克隆仓库即可运行 Sample:
git clone https://gitcode.com/gh_mirrors/drop/DropDownMenu
小结
🎯 如果你正在为 Android App 寻找一套可扩展、易维护的筛选器方案,DropDownMenu 值得一试:布局一行声明、Adapter 定义 tab、内置 5 种视图、FilterUrl 隔离数据,四步就能搭出电商级下拉筛选菜单。组件模块清晰、代码量不大,也很适合作为学习自定义 Android 控件的范例项目。
