Android自定义带popupWindow的二级菜单筛选控件

作者: ruancw | 来源:发表于2018-05-31 16:06 被阅读439次

前言：近期项目重构，公司对项目结构进行了调整，增加了条件筛选的功能。在网上也看到了很多自定义的控件实现类似美团的附近筛选功能，实现方式基本都是自定义view继承自LinearLayout等布局控件，于是自己在Button的基础上添加了popupWindow并进行了简单封装，使用RecyclerView展示数据，实现了带二级菜单的筛选功能。

效果图：

效果图

实现方式：

（1）继承自AppCompatButton，实现PopupWindow.OnDismissListener

（2）PopupWindow展示二级菜单

（3）RecyclerView展示二级菜单的列表数据

（4）监听接口进行回调,用于筛选后更新UI

1.定义FilterPopupButton

（1）FilterPopupButton继承自AppCompatButton，重写构造方法

//三个有参构造方法 
public FilterPopupButton(Context context) {
    super(context);
    this.context = context; 
}

public FilterPopupButton(Context context, AttributeSet attrs, int defStyleAttr) {
    super(context, attrs, defStyleAttr);
    this.context = context; 
}

public FilterPopupButton(Context context, AttributeSet attrs) {
    super(context, attrs);
    this.context = context;
    inflater = LayoutInflater.from(context);
    initAttrs(context, attrs);
    initParams(context);   
}

（2）设置控件属性参数

/**  
* 初始化属性参数 
* @param context 上下文对象  
* @param attrs 属性  
*/ 
private void initAttrs(Context context, AttributeSet attrs) {
    TypedArray typedArray = context.obtainStyledAttributes(attrs, R.styleable.popupbtn);
    //正常状态下的背景色
    mBackGround = typedArray.getResourceId(R.styleable.popupbtn_normalBg, -1);
    //点击时的背景色
    mClickBackGround = typedArray.getResourceId(R.styleable.popupbtn_pressBg, -1);
    //正常状态下的图标
    mIcon = typedArray.getResourceId(R.styleable.popupbtn_normalIcon, -1);
    //点击状态下的图标
    mClickIcon = typedArray.getResourceId(R.styleable.popupbtn_pressIcon, -1);
    //回收
    typedArray.recycle(); 
}

定义attrs，方便在布局文件使用时设置相关属性

<declare-styleable name="popupbtn">
  <!-- 正常状态下的背景 -->
  <attr name="normalBg" format="reference" />
  <!-- 点击状态下的背景 -->
  <attr name="pressBg" format="reference" />
  <!-- 正常状态下的图标 -->
  <attr name="normalIcon" format="reference" />
  <!-- 点击状态下的图标 -->
  <attr name="pressIcon" format="reference" />f

</declare-styleable>

（3）初始化其他参数

/**  
* 初始化参数 
*/ 
private void initParams(Context context) {
    //初始化图标的padding值
    paddingTop = this.getPaddingTop();
    paddingLeft = this.getPaddingLeft();
    paddingRight = this.getPaddingRight();
    paddingBottom = this.getPaddingBottom();
    //获取Window管理器
    WindowManager wm = (WindowManager) context.getSystemService(Context.WINDOW_SERVICE);
    //获取屏幕的宽和高
    mScreenWidth = wm.getDefaultDisplay().getWidth();
    mScreenHeight = wm.getDefaultDisplay().getHeight();
    //设置正常状态下的参数
    setNormalStatus(); 
}

（4）设置正常状态及点击状态下的背景及图标

/**  
* 设置点击状态下的背景及图标 
*/ 
private void setClickStatus() {
    //设置点击时的背景色
    if (mClickBackGround != -1) {
        this.setBackgroundResource(mClickBackGround);
        this.setPadding(paddingLeft, paddingTop, paddingRight, paddingBottom);
    }
    //设置点击时的图标
    if (mClickIcon != -1) {
        Drawable drawable = getResources().getDrawable(mClickIcon);
        // 设置drawable的bounds以便展示图标
        drawable.setBounds(0, 0, drawable.getMinimumWidth(), drawable.getMinimumHeight());
        this.setCompoundDrawables(null, null, drawable, null);
    }
}

/**  
* 设置正常状态下的背景及图标 
*/ 
private void setNormalStatus() {
    //未点击状态背景
    if (mBackGround != -1) {
        this.setBackgroundResource(mBackGround);
        this.setPadding(paddingLeft, paddingTop, paddingRight, paddingBottom);
    }
    //未点击状态下的图标
    if (mIcon != -1) {
        Drawable drawable = getResources().getDrawable(mIcon);
        // 设置drawable的bounds以便展示图标
        drawable.setBounds(0, 0, drawable.getMinimumWidth(), drawable.getMinimumHeight());
        this.setCompoundDrawables(null, null, drawable, null);
  }
}

2.PopupWindow

（1）初始化popupWindow布局文件

/**  
* 初始化popupWindow的布局文件 
*/ 
private void init() {
    //初始化popupWindow的布局文件
    View view = inflater.inflate(R.layout.popup_layout, null);
    //展示一级菜单的view
    mRvParent = (RecyclerView) view.findViewById(R.id.rv_parent);
    //展示二级菜单的view
    mRvChild = (RecyclerView) view.findViewById(R.id.rv_child);
    //存储取值列表的集合
    mValuesList = new ArrayList<>();
    //默认添加一级菜单对应的二级菜单的第一个值列表
     //mValuesList.addAll(mChildList.get(0));    
     mRvParent.setLayoutManager(new   LinearLayoutManager(context, LinearLayoutManager.VERTICAL, false));
     mRvParent.addItemDecoration(new DividerItemDecoration(context, DividerItemDecoration.VERTICAL));
     mRvChild.setLayoutManager(new LinearLayoutManager(context, LinearLayoutManager.VERTICAL, false));
    mRvChild.addItemDecoration(new DividerItemDecoration(context, DividerItemDecoration.VERTICAL));
    //创建一级和二级菜单的adapter
    mParentAdapter = new FilterAdapter(context, R.layout.popup_item, mParentList);
    mChildAdapter = new FilterAdapter(context, R.layout.popup_item, mValuesList);
    //设置一级菜单的第一个默认选中状态
    mParentAdapter.recordSelectPosition(0);
    mRvParent.setAdapter(mParentAdapter);
    mRvChild.setAdapter(mChildAdapter);
    //初始化popupWindow
    initPopupView(view);
    //父条目点击事件
    mParentAdapter.setOnItemClickListener(new MultiItemTypeAdapter.OnItemClickListener() {
        @Override
        public void onItemClick(View view, RecyclerView.ViewHolder holder, int position) {
            if (position == 0) {
                //position=0为筛选全部，点击popupWindow消失并设置取值为父条目的第一个值
                setText(mParentList.get(position));
                hidePopupWindow(mParentList.get(position));
            }
            //记录父条目点击的position
            mParentAdapter.recordSelectPosition(position);
            mParentAdapter.notifyDataSetChanged();
            mValuesList.clear();
            //将子条目添加到取值列表
            mValuesList.addAll(mChildList.get(position));
            mChildAdapter.notifyDataSetChanged();
            mChildAdapter.recordSelectPosition(-1);
            //设置子条目默认选中第一个
            //mRvChild.scrollToPosition(0);  
        }

        @Override
        public boolean onItemLongClick(View view, RecyclerView.ViewHolder holder, int position) {
            return false;
        }

    });
  //子条目点击事件
  mChildAdapter.setOnItemClickListener(new MultiItemTypeAdapter.OnItemClickListener() {
        @Override
        public void onItemClick(View view, RecyclerView.ViewHolder holder, int position) {
            //记录子条目点击的position
            mChildAdapter.recordSelectPosition(position);
            mChildAdapter.notifyDataSetChanged();
            //设置选中的字符
            setText(mValuesList.get(position));
            //隐藏popupWindow
            hidePopupWindow(mValuesList.get(position));
        }

        @Override
        public boolean onItemLongClick(View view, RecyclerView.ViewHolder holder, int position) {
            return false;
        }

    }); 
}

注：本文使用RecyclerView用于二级菜单数据列表的展示，并使用鸿洋大神封装的adapter，文末贴出依赖。

（2）popup_layout布局文件

<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:background="@android:color/white"
  android:orientation="horizontal">   
  <android.support.v7.widget.RecyclerView  
    android:id="@+id/rv_parent"
    android:layout_width="0dp"
    android:layout_height="match_parent"
    android:layout_weight="1"
    android:scrollbars="none">   
  </android.support.v7.widget.RecyclerView>   
  <View  
    android:layout_width="1dp"
    android:layout_height="match_parent"
    android:background="@android:color/darker_gray" />   
  <android.support.v7.widget.RecyclerView  
    android:id="@+id/rv_child"
    android:layout_width="0dp"
    android:layout_height="match_parent"
    android:layout_weight="1">   
  </android.support.v7.widget.RecyclerView>

（3）initPopupWindow及hidePoupWindow

/**  
* 初始化popupWindow 
* @param view popupWindow的布局view  
*/ 
public void initPopupView(final View view) {
    this.setOnClickListener(new OnClickListener() {
        @Override
        public void onClick(View v) {
            if (mFixPopupWindow == null) {
                LinearLayout layout = new LinearLayout(context);
                LinearLayout.LayoutParams params = new  LinearLayout.LayoutParams(LinearLayout.LayoutParams.MATCH_PARENT, (int) (mScreenHeight * 0.6));
                view.setLayoutParams(params);
                layout.addView(view);
                //设置背景色，不设置的话在有些机型会不显示popupWindow
                layout.setBackgroundColor(Color.argb(60, 0, 0, 0));
                //自定义的FixPopupWindow，解决在Build.VERSION.SDK_INT >= 24时，popupWindow显示位置在屏幕顶部问题
                mFixPopupWindow = new FixPopupWindow(layout, mScreenWidth, mScreenHeight);
                mFixPopupWindow.setFocusable(true);
                mFixPopupWindow.setBackgroundDrawable(new BitmapDrawable());
                //设置点击popupWindow外部可消失
                mFixPopupWindow.setOutsideTouchable(true);
                mFixPopupWindow.setOnDismissListener(FilterPopupButton.this);
                layout.setOnClickListener(new OnClickListener() {
                    @Override
                    public void onClick(View v) {
                        mFixPopupWindow.dismiss();
                    }
                });
        }
            //设置点击popupButton时的状态
            setClickStatus();
            mFixPopupWindow.showAsDropDown(FilterPopupButton.this);
        }
    }); 
}

/**  
* 隐藏popupWindow 
* @param value 获取到的值  
*/ 
public void hidePopupWindow(String value) {
    if (mFixPopupWindow != null && mFixPopupWindow.isShowing()) {
        popupButtonMonitor.setFilterResult(value);
        mFixPopupWindow.dismiss();
    }
}

（4）定义recyclerView的adapter（FilterAdapter）

/**  
* Created by ruancw on 2018/5/31. 
* 
*/   
public class FilterAdapter extends CommonAdapter<String> {
    private int selection;   
    public FilterAdapter(Context context, int layoutId, List<String> dataList) {
        super(context,layoutId,dataList);
        this.selection = -1;
    }

     @Override
     protected void convert(ViewHolder holder, String value, int position) {
          holder.setText(R.id.tv_des,value);
         if(position == selection) {
            holder.setBackgroundRes(R.id.tv_des,R.color.press);
        }else {
            holder.setBackgroundRes(R.id.tv_des,R.color.normal);
        }
    }

    /**  
    * 记录选中的position位置 
    * @param position 上一次点击的位置  
    */  
    public void recordSelectPosition(int position) {
        this.selection = position;
    }

}

注意：在adapter中有if必须要有else与之对应，不然会出现记录条目的背景色错乱问题。

3.Button+PopupWindow封装

（1）在FilterPopupWindow中定义设置数据的方法

/**  
* 设置数据 
* @param mParentList 一级菜单数据集合  
* @param mChildList 二级菜单数据集合  
*/ 
public void setValue(List<String> mParentList, List<List<String>> mChildList) {
    this.mParentList = mParentList;
    this.mChildList = mChildList;
    //初始化popupWindow的布局文件
    init(); 
}

init方法即是开始初始化popupWindow。

（2）定义数据监听接口，用于筛选完成重新更新UI

/**  
* 监听数据的接口 
*/ 
public interface PopupButtonMonitor {
    //设置回调的方法
    void setFilterResult(String filterResult); 
}

/**  
* 接口绑定 
* @param popupButtonMonitor 接口  
*/ 
public void setPopupButtonMonitor(PopupButtonMonitor popupButtonMonitor) {
    this.popupButtonMonitor = popupButtonMonitor; 
}

（3）实现PopupWindow.OnDismissListener的方法

@Override 
public void onDismiss() {
    //在popupWindow消失时，将状态设置为正常状态
    setNormalStatus(); 
}

4.使用

（1）布局中

<com.rcw.filterpopup.FilterPopupButton
  android:id="@+id/filter_popup_button"
  android:layout_width="match_parent"
  android:layout_height="wrap_content"
  android:text="测试1"
  android:textSize="20dp"
  popupbtn:normalBg="@drawable/tab_bkg_line"
  popupbtn:normalIcon="@drawable/arrow_down"
  popupbtn:pressBg="@drawable/tab_bkg_selected"
  popupbtn:pressIcon="@drawable/arrow_up_blue"
/>

使用popupbtn:xx属性需在根布局添加自定义属性声明：

xmlns:popupbtn="http://schemas.android.com/apk/res-auto"</pre>

（2）代码中

filterPopup=findViewById(R.id.filter_popup_button); 
filterPopup.setValue(pList,cList); 
filterPopup.setPopupButtonMonitor(this);

5.问题

细心的你可能发现，在文中我使用的是FixPopupWindow，没错，这是自定义的popupWindow。为什么要重新定义poupWindow而不使用系统的PopupWindow呢？？？

写完代码，迫不及待的进行了一番测试，一顿操作猛如虎，结果发现popupWindow的位置是在系统顶部而不是控件的下方，赶紧检查了下代码，发现使用的是showAsDropDown(View anchor)方法，经过一番努力，在stackoverflow中找到原因，原来是一系统级bug,在版本>=24时要在showASDropDown方法重新测量。

/**  
* Created by ruancw on 2018/5/30. 
* 重新定义popupWindow,解决版本过高，popupWindow的位置不在控件下方的问题 
*/   
public class FixPopupWindow extends PopupWindow {
    public FixPopupWindow(View contentView, int width, int height) {
        super(contentView, width, height);
    }

    @Override
    public void showAsDropDown(View anchor, int xoff, int yoff) {
        if(Build.VERSION.SDK_INT >= 24) {
            Rect rect = new Rect();
            anchor.getGlobalVisibleRect(rect);
            int h = anchor.getResources().getDisplayMetrics().heightPixels - rect.bottom;
            setHeight(h);
        }
        super.showAsDropDown(anchor, xoff, yoff);
    }

}

鸿洋大神recyclerView的adapter依赖：

implementation 'com.zhy:base-rvadapter:3.0.3'

至此，自定义带popupWindow的二级菜单筛选控件简单的封装就实现了，不足之处，欢迎评论与留言！！！

Android自定义带popupWindow的二级菜单筛选控件

1.定义FilterPopupButton

2.PopupWindow

3.Button+PopupWindow封装

4.使用

5.问题

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

自定义控件