Android筛选器终极指南:DropDownMenu如何帮你快速搭建电商级下拉筛选菜单

原创2026-10-18 12:32:531,966 阅读

Android筛选器终极指南:DropDownMenu如何帮你快速搭建电商级下拉筛选菜单

做电商、本地生活类 App 的同学应该都熟悉"筛选"这个场景:点一下顶部的"分类 / 区域 / 价格",面板从上方滑出,选中后内容区刷新。开源项目 DropDownMenu 就是一款面向 Android 的筛选器组件,号称"a better DropDownMenu solution",提供了一套完整的下拉筛选菜单解决方案:内置顶部筛选条、展开动画、选中态高亮,并封装了单列列表、双列联动、网格等 5 种筛选视图,让你用极少代码就能搭出电商级筛选体验。

Android筛选器DropDownMenu下拉筛选菜单效果演示,顶部筛选条点击后展开单列列表

上图是项目自带 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 目录下内置了现成视图,按场景对号入座:

  1. SingleListView —— 单列列表,适合"城市 / 分类"这类线性选项(SingleListView.java)
  2. DoubleListView —— 双列联动列表,左列选中后右列刷新,适合"品牌 → 型号"两级筛选
  3. SingleGridView —— 单列网格,适合"价格区间 / 排序方式"等少数量选项
  4. DoubleGridView —— 上下双网格,示例见 DoubleGridView.java
  5. 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 控件的范例项目。

登录后查看全文
DropDownMenu