如何使用AutoCompleteTextView,并自定义过滤规则

AutoCompleteTextView特性

  • AutoCompleteTextView是EditText的子类,可以使用EditText所有的属性
  • 用于输入框的自动完成提示,非常适合搜索框。
  • setThreshold:指定用户至少输入几个字符才会显示提示

常规的简单实现

  • 设置AutoCompleteTextView的适配器为ArrayAdapter,ArrayAdapter已经实现了Filterable接口。此时,只要给AutoCompleteTextView添加文字监听:

private String[] autostr = new String[] { "a", "ab", "abc",  
        "abcd", "b", "bc", "bcd" }; 


//android.R.layout.simple_dropdown_item_1line是系统自带的简单item布局
ArrayAdapter adapter = new ArrayAdapter(this,  
              android.R.layout.simple_dropdown_item_1line, autostr);

 mAutoCompleteTv.addTextChangedListener(new TextWatcher() {
            @Override
            public void beforeTextChanged(CharSequence s, int start, int count, int after) {

            }

            @Override
            public void onTextChanged(CharSequence s, int start, int before, int count) {
                //只需添加这一句代码即可
                //这句话的意思是为AutoCompleteTextView设置过滤字段为s,只要数据是以s开头,都会显示出来
                adapter.getFilter().filter(s);
            }

            @Override
            public void afterTextChanged(Editable s) {
            }
        });

自定义过滤规则

  • 要自己定义过滤规则,主要是对Filterable接口的实现,其他部分与ListView的适配器设置并无区别。

  • 下面给出一个实例,实现的效果是:在输入框输入字符串s,只要某条数据里含有s,就将该条数据显示出来。关键代码如下。


相关变量
-------------------------------------------------------------------------------------------------
    private AutoCompleteTextView mAutoCompleteTv;

    //这个一旦赋值就不会改变了,相当数据库的概念,是搜索的数据源,也就是说展示的list数据是根据定义
    //的过滤规则,从mSearchDataBaseList中取出符合过滤规则的数据。
    //这个mSearchDataBaseList一般是从后台获取。
    private List mSearchDataBaseList = new ArrayList<>();
    
    //这个是搜索的结果集合,随搜索内容而改变
    private List mSearchResultList = new ArrayList<>();//
    
    private MyAutoCompleteTvAdapter mAutoCompleteTvAdapter;


设置适配器
---------------------------------------------------------------------------------------
    mAutoCompleteTvAdapter = new MyAutoCompleteTvAdapter(getApplicationContext(), mSearchResultList);
    mAutoCompleteTv.setAdapter(mAutoCompleteTvAdapter);


适配器的具体实现
-----------------------------------------------------------------------------------------
    class MyAutoCompleteTvAdapter extends BaseAdapter implements Filterable {

        private Context context;
        //该list存放的是最终弹出列表的数据
        private List list = new ArrayList<>();

        private MyAutoCompleteTvAdapter(Context context, List list) {
            this.context = context;
            this.list = list;
        }

        @Override
        public Filter getFilter() {
            Filter filter = new Filter() {
                /**
                 * 在后台线程执行,定义过滤算法
                 * @param constraint :就是你在输入框输入的字符串
                 * @return 符合条件的数据结果,会在下面的publishResults方法中将数据传给list
                 */
                @Override
                protected FilterResults performFiltering(CharSequence constraint) {

                    FilterResults results = new FilterResults();

                    if (constraint == null || constraint.length() == 0) {
                        //
                        results.values = mSearchDataBaseList;
                        results.count = mSearchDataBaseList.size();
                    } else {

                        //这个newList是实际搜索出的结果集合,实际上是将该newList的数据赋给了list
                        List newList = new ArrayList<>();
                        for (String s : mSearchDataBaseList) {
                            //包含就添加到newList中
                            if (s.contains(constraint.toString().trim()
                            )) {
                                newList.add(s);
                            }
                        }

                        //将newList传给results
                        results.values = newList;
                        results.count = newList.size();
                        newList = null;
                    }

                    return results;
                }

                /**
                 * 本方法在UI线程执行,用于更新自动完成列表
                 * @param constraint  
                 * @param results
                 */
                @Override
                protected void publishResults(CharSequence constraint, FilterResults results) {

                    if (results != null && results.count > 0) {//有符合过滤规则的数据
                        list.clear();
                        list.addAll((List) results.values);
                        notifyDataSetChanged();
                    } else {//没有符合过滤规则的数据
                        notifyDataSetInvalidated();
                    }
                }

                /**
                 * 将符合条件的数据转换为你想要的方式,一般无需实现
                 * 控制用户点击提示时要填充至输入框的文本内容。
                 */
                @Override
                public CharSequence convertResultToString(Object resultValue) {

                   return super.convertResultToString(resultValue);
                    //假如这里写 return "啊哈哈";
                    //那么,无论你点击哪个条目,出现在输入框的永远是"啊哈哈"这几个字。
                }
            };

            return filter;
        }

        @Override
        public int getCount() {
            return list != null && list.size() > 0 ? list.size() : 0;
        }

        /**
         * 这里必须返回list.get(position),否则点击条目后输入框显示的是position,而非该position的数据
         *
         * @param position
         * @return
         */
        @Override
        public Object getItem(int position) {
            return list.get(position);
        }

        @Override
        public long getItemId(int position) {
            return position;
        }

        @Override
        public View getView(final int position, View convertView, ViewGroup parent) {

            TvViewHolder holder;
            if (convertView == null) {
                convertView = View.inflate(context, R.layout.item_autocompletetv_simple_dropdown, null);
                holder = new TvViewHolder();
                holder.tv = (TextView) convertView.findViewById(R.id.text1);
                convertView.setTag(holder);

            } else {
                holder = (TvViewHolder) convertView.getTag();
            }

            //注意这里不要为convertView添加点击事件,默认是点击后:①下拉窗收起;
            //②点击的条目数据会显示在搜索框中;③光标定位到字符串末位。
            //如果自己添加点击事件,就要首先实现上面的①、②、③。
            holder.tv.setText(list.get(position));
            return convertView;
        }

        class TvViewHolder {
            TextView tv;
        }
    }

布局文件,很简单,只有一个textview
------------------------------------------------------------------------------------------------
    


你可能感兴趣的:(如何使用AutoCompleteTextView,并自定义过滤规则)