Android ListView用EditText实现搜索功能效果

发布时间 - 2026-01-11 00:21:47    点击率:

前言

最近在开发一个IM项目的时候有一个需求就是,好友搜索功能。即在EditText中输入好友名字,ListView列表中动态展示刷选的好友列表。我把这个功能抽取出来了,先贴一下效果图:

分析

在查阅资料以后,发现其实Android中已经帮我们实现了这个功能,如果你的ListView使用的是系统的ArrayAdapter,那么恭喜你,下面的事情就很简单了,你只需要调用下面的代码就可以实现了:   

searchEdittext.addTextChangedListener(new TextWatcher() {
  @Override
  public void onTextChanged(CharSequence cs, int arg1, int arg2, int arg3) {
    // When user change the text
    mAdapter.getFilter().filter(cs);
  }
  
  @Override
  public void beforeTextChanged(CharSequence cs, int arg1, int arg2, int arg3) {
    //
  }
  
  @Override
  public void afterTextChanged(Editable arg0) {
    //
  }
});

你没看错,就一行 mAdapter.getFilter().filter(cs);便可以实现这个搜索功能。不过我相信大多数Adapter都是自定义的,基于这个需求,我去分析了下ArrayAdapter,发现它实现了Filterable接口,那么接下来的事情就比较简单了,就让我们自定的Adapter也去实现Filterable这个接口,不久可以实现这个需求了吗。下面贴出ArrayAdapter中显示过滤功能的关键代码: 

public class ArrayAdapter<T> extends BaseAdapter implements Filterable {
  /**
   * Contains the list of objects that represent the data of this ArrayAdapter.
   * The content of this list is referred to as "the array" in the documentation.
   */
  private List<T> mObjects;
  
  /**
   * Lock used to modify the content of {@link #mObjects}. Any write operation
   * performed on the array should be synchronized on this lock. This lock is also
   * used by the filter (see {@link #getFilter()} to make a synchronized copy of
   * the original array of data.
   */
  private final Object mLock = new Object();
  
  // A copy of the original mObjects array, initialized from and then used instead as soon as
  // the mFilter ArrayFilter is used. mObjects will then only contain the filtered values.
  private ArrayList<T> mOriginalValues;
  private ArrayFilter mFilter;
  
  ...
  
  public Filter getFilter() {
    if (mFilter == null) {
      mFilter = new ArrayFilter();
    }
    return mFilter;
  }

  /**
   * <p>An array filter constrains the content of the array adapter with
   * a prefix. Each item that does not start with the supplied prefix
   * is removed from the list.</p>
   */
  private class ArrayFilter extends Filter {
    @Override
    protected FilterResults performFiltering(CharSequence prefix) {
      FilterResults results = new FilterResults();

      if (mOriginalValues == null) {
        synchronized (mLock) {
          mOriginalValues = new ArrayList<T>(mObjects);
        }
      }

      if (prefix == null || prefix.length() == 0) {
        ArrayList<T> list;
        synchronized (mLock) {
          list = new ArrayList<T>(mOriginalValues);
        }
        results.values = list;
        results.count = list.size();
      } else {
        String prefixString = prefix.toString().toLowerCase();

        ArrayList<T> values;
        synchronized (mLock) {
          values = new ArrayList<T>(mOriginalValues);
        }

        final int count = values.size();
        final ArrayList<T> newValues = new ArrayList<T>();

        for (int i = 0; i < count; i++) {
          final T value = values.get(i);
          final String valueText = value.toString().toLowerCase();

          // First match against the whole, non-splitted value
          if (valueText.startsWith(prefixString)) {
            newValues.add(value);
          } else {
            final String[] words = valueText.split(" ");
            final int wordCount = words.length;

            // Start at index 0, in case valueText starts with space(s)
            for (int k = 0; k < wordCount; k++) {
              if (words[k].startsWith(prefixString)) {
                newValues.add(value);
                break;
              }
            }
          }
        }

        results.values = newValues;
        results.count = newValues.size();
      }

      return results;
    }

    @Override
    protected void publishResults(CharSequence constraint, FilterResults results) {
      //noinspection unchecked
      mObjects = (List<T>) results.values;
      if (results.count > 0) {
        notifyDataSetChanged();
      } else {
        notifyDataSetInvalidated();
      }
    }
  }
}

实现

首先写了一个Model(User)模拟数据

public class User {
  private int avatarResId;
  private String name;

  public User(int avatarResId, String name) {
    this.avatarResId = avatarResId;
    this.name = name;
  }

  public int getAvatarResId() {
    return avatarResId;
  }

  public void setAvatarResId(int avatarResId) {
    this.avatarResId = avatarResId;
  }

  public String getName() {
    return name;
  }

  public void setName(String name) {
    this.name = name;
  }
}

自定义一个Adapter(UserAdapter)继承自BaseAdapter,实现了Filterable接口,Adapter一些常见的处理,我都去掉了,这里主要讲讲Filterable这个接口。
 

/**
   * Contains the list of objects that represent the data of this Adapter.
   * Adapter数据源
   */
  private List<User> mDatas;

 //过滤相关
  /**
   * This lock is also used by the filter
   * (see {@link #getFilter()} to make a synchronized copy of
   * the original array of data.
   * 过滤器上的锁可以同步复制原始数据。
   * 
   */
  private final Object mLock = new Object();

  // A copy of the original mObjects array, initialized from and then used instead as soon as
  // the mFilter ArrayFilter is used. mObjects will then only contain the filtered values.
  //对象数组的备份,当调用ArrayFilter的时候初始化和使用。此时,对象数组只包含已经过滤的数据。
  private ArrayList<User> mOriginalValues;
  private ArrayFilter mFilter;

 @Override
  public Filter getFilter() {
    if (mFilter == null) {
      mFilter = new ArrayFilter();
    }
    return mFilter;
  }

写一个ArrayFilter类继承自Filter类,我们需要两个方法:

//执行过滤的方法
 protected FilterResults performFiltering(CharSequence prefix);
//得到过滤结果
 protected void publishResults(CharSequence prefix, FilterResults results);

贴上完整的代码,注释已经写的不能再详细了

 /**
   * 过滤数据的类
   */
  /**
   * <p>An array filter constrains the content of the array adapter with
   * a prefix. Each item that does not start with the supplied prefix
   * is removed from the list.</p>
   * <p/>
   * 一个带有首字母约束的数组过滤器,每一项不是以该首字母开头的都会被移除该list。
   */
  private class ArrayFilter extends Filter {
    //执行刷选
    @Override
    protected FilterResults performFiltering(CharSequence prefix) {
      FilterResults results = new FilterResults();//过滤的结果
      //原始数据备份为空时,上锁,同步复制原始数据
      if (mOriginalValues == null) {
        synchronized (mLock) {
          mOriginalValues = new ArrayList<>(mDatas);
        }
      }
      //当首字母为空时
      if (prefix == null || prefix.length() == 0) {
        ArrayList<User> list;
        synchronized (mLock) {//同步复制一个原始备份数据
          list = new ArrayList<>(mOriginalValues);
        }
        results.values = list;
        results.count = list.size();//此时返回的results就是原始的数据,不进行过滤
      } else {
        String prefixString = prefix.toString().toLowerCase();//转化为小写

        ArrayList<User> values;
        synchronized (mLock) {//同步复制一个原始备份数据
          values = new ArrayList<>(mOriginalValues);
        }
        final int count = values.size();
        final ArrayList<User> newValues = new ArrayList<>();

        for (int i = 0; i < count; i++) {
          final User value = values.get(i);//从List<User>中拿到User对象
//          final String valueText = value.toString().toLowerCase();
          final String valueText = value.getName().toString().toLowerCase();//User对象的name属性作为过滤的参数
          // First match against the whole, non-splitted value
          if (valueText.startsWith(prefixString) || valueText.indexOf(prefixString.toString()) != -1) {//第一个字符是否匹配
            newValues.add(value);//将这个item加入到数组对象中
          } else {//处理首字符是空格
            final String[] words = valueText.split(" ");
            final int wordCount = words.length;

            // Start at index 0, in case valueText starts with space(s)
            for (int k = 0; k < wordCount; k++) {
              if (words[k].startsWith(prefixString)) {//一旦找到匹配的就break,跳出for循环
                newValues.add(value);
                break;
              }
            }
          }
        }
        results.values = newValues;//此时的results就是过滤后的List<User>数组
        results.count = newValues.size();
      }
      return results;
    }

    //刷选结果
    @Override
    protected void publishResults(CharSequence prefix, FilterResults results) {
      //noinspection unchecked
      mDatas = (List<User>) results.values;//此时,Adapter数据源就是过滤后的Results
      if (results.count > 0) {
        notifyDataSetChanged();//这个相当于从mDatas中删除了一些数据,只是数据的变化,故使用notifyDataSetChanged()
      } else {
        /**
         * 数据容器变化 ----> notifyDataSetInValidated

         容器中的数据变化 ----> notifyDataSetChanged
         */
        notifyDataSetInvalidated();//当results.count<=0时,此时数据源就是重新new出来的,说明原始的数据源已经失效了
      }
    }
  }

特别说明

//User对象的name属性作为过滤的参数
 final String valueText = value.getName().toString().toLowerCase();

这个地方是,你要进行搜索的关键字,比如我这里使用的是User对象的Name属性,就是把用户名当作关键字来进行过滤筛选的。这里要根据你自己的具体逻辑来进行设置。

复制代码 代码如下:
if (valueText.startsWith(prefixString) || valueText.indexOf(prefixString.toString()) != -1)

在这里进行关键字匹配,如果你只想使用第一个字符匹配,那么你只需要使用这行代码就可以了:

//首字符匹配
valueText.startsWith(prefixString)

如果你的需求是只要输入的字符出现在ListView列表中,那么该item就要显示出来,那么你就需要这行代码了:

//你输入的关键字包含在了某个item中,位置不做考虑,即可以不是第一个字符 
valueText.indexOf(prefixString.toString()) != -1

这样就完成了一个EditText + ListView实现搜索的功能。我在demo中用两种方法实现了这一效果。第一种是系统的ArrayAdapter实现,第二种是自定义Adapter实现。

demo下载地址:EditSearch_jb51.rar

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。


# edittext实现搜索  # edittext搜索listview  # listview  # edittext  # Android Studio搜索功能(查找功能)及快捷键图文详解  # Android实现搜索功能并本地保存搜索历史记录  # Android自定义View实现搜索框(SearchView)功能  # Android仿简书动态searchview搜索栏效果  # Android百度地图实现搜索和定位及自定义图标绘制并点击时弹出泡泡  # Android搜索框SearchView属性和用法详解  # Android SearchView搜索框组件的使用方法  # Android遍历所有文件夹和子目录搜索文件  # Android搜索框组件SearchView的基本使用方法  # Android实现简单动态搜索功能  # 第一个  # 实现了  # 自定义  # 的是  # 首字母  # 就可以  # 为空  # 搜索功能  # 这行  # 自己的  # 都是  # 你只需要  # 原始数据  # 这一  # 如果你  # 在这里  # 我在  # 你就  # 你要  # 下载地址 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: JavaScript如何实现音频处理_Web Audio API如何工作?  Windows10怎样连接蓝牙设备_Windows10蓝牙连接步骤【教程】  Laravel Seeder填充数据教程_Laravel模型工厂Factory使用  网站制作壁纸教程视频,电脑壁纸网站?  Laravel中Service Container是做什么的_Laravel服务容器与依赖注入核心概念解析  Laravel如何实现多表关联模型定义_Laravel多对多关系及中间表数据存取【方法】  Python高阶函数应用_函数作为参数说明【指导】  Windows10如何删除恢复分区_Win10 Diskpart命令强制删除分区  android nfc常用标签读取总结  黑客入侵网站服务器的常见手法有哪些?  Laravel如何使用Blade组件和插槽?(Component代码示例)  国美网站制作流程,国美电器蒸汽鍋怎么用官方网站?  详解ASP.NET 生成二维码实例(采用ThoughtWorks.QRCode和QrCode.Net两种方式)  Laravel如何生成URL和重定向?(路由助手函数)  详解MySQL数据库的安装与密码配置  香港服务器租用费用高吗?如何避免常见误区?  Laravel怎么实现搜索高亮功能_Laravel结合Scout与Algolia全文检索【实战】  HTML5建模怎么导出为FBX格式_FBX格式兼容性及导出步骤【指南】  悟空识字如何进行跟读录音_悟空识字开启麦克风权限与录音  百度浏览器网页无法复制文字怎么办 百度浏览器复制修复  如何在云主机上快速搭建多站点网站?  Win11怎么开启自动HDR画质_Windows11显示设置HDR选项  如何利用DOS批处理实现定时关机操作详解  无锡营销型网站制作公司,无锡网选车牌流程?  详解Android中Activity的四大启动模式实验简述  如何制作一个表白网站视频,关于勇敢表白的小标题?  Linux虚拟化技术教程_KVMQEMU虚拟机安装与调优  HTML5空格和nbsp有啥关系_nbsp的作用及使用场景【说明】  如何在 Pandas 中基于一列条件计算另一列的分组均值  Laravel中间件起什么作用_Laravel Middleware请求生命周期与自定义详解  Windows10电脑怎么设置虚拟光驱_Win10右键装载ISO镜像文件  php在windows下怎么调试_phpwindows环境调试操作说明【操作】  phpredis提高消息队列的实时性方法(推荐)  微信小程序 HTTPS报错整理常见问题及解决方案  Laravel如何实现登录错误次数限制_Laravel自带LoginThrottles限流配置【方法】  如何为不同团队 ID 动态生成多个非值班状态按钮  作用域操作符会触发自动加载吗_php类自动加载机制与::调用【教程】  桂林网站制作公司有哪些,桂林马拉松怎么报名?  Laravel的契約(Contracts)是什么_深入理解Laravel Contracts与依赖倒置  如何快速搭建支持数据库操作的智能建站平台?  如何在Windows服务器上快速搭建网站?  Laravel如何使用Guzzle调用外部接口_Laravel发起HTTP请求与JSON数据解析【详解】  javascript基于原型链的继承及call和apply函数用法分析  悟空识字怎么关闭自动续费_悟空识字取消会员自动扣费步骤  为什么php本地部署后css不生效_静态资源加载失败修复技巧【技巧】  Laravel如何实现一对一模型关联?(Eloquent示例)  如何用虚拟主机快速搭建网站?详细步骤解析  Win11怎么设置虚拟桌面 Win11新建多桌面切换操作【技巧】  如何在万网开始建站?分步指南解析  图册素材网站设计制作软件,图册的导出方式有几种?