通用PopupWindow，幾行代碼搞定PopupWindow彈窗

Dominic19I 8年前發布 | 29K 次閱讀 Android開發移動開發 PopupWindow

我們都知道，Android 中的彈窗基本有兩種，一種是AlertDialog，另一種是PopupWindow，AlertDialog的顯示位置是固定的，PopWindow 的顯示位置是我們可以設置和調整的，因此，像項目中的一些場景如：某個功能的提示說明、點擊按鈕在按鈕上方或者下方彈出菜單、新功能彈窗引導等。由于這些彈窗的位置不固定，因此都可以用PopupWindow來做。最近項目中也用到了PopupWindow彈窗功能，在寫的過程中，發現雖然API比較簡單，但是寫一個PopupWindow，還是有點繁瑣，很多重復代碼，決定簡單封裝一下，以后添加一個彈窗就不用那么麻煩了，幾行代碼就搞定了。本篇文章是對項目中使用 PopupWindow做一個筆記和總結。

一、首先先看一下效果圖

效果圖：

popWindow.gif

以上示例展示了4中PopupWindow 使用場景

二、PopupWindow 簡單介紹

首先看一下Google 官方文檔對PopupWindow的介紹：

This class represents a popup window that can be used to display an arbitrary view. The popup window is a floating container that appears on top of the current activity.

大致意思就是：popup window 是一個出現在當前Activity頂層的懸浮容器，可以用來展示任意的View。

因此只要是個View，都可以用PopupWindow 來展示。這里我就不過多介紹PopupWindow 的API，挑幾個重要并且常用的說一下：

1,構造函數，這個不用多說，多個重載函數，穿不同的參數。

public PopupWindow(int width, int height)

public PopupWindow(View contentView, int width, int height) 

public PopupWindow(View contentView, int width, int height, boolean focusable)

2，設置顯示的View：

public void setContentView(View contentView)

3,設置展示的寬、高，構造函數傳了寬高就不用重新設置

// 設置寬，其實構造函數也是調用的這個方法
public void setWidth(int width)
//設置高
public void setHeight(int height)

4，設置是否獲取焦點

public void setFocusable(boolean focusable)

5,設置點擊PopupWindow 以外區域是否可以隱藏PopupWindow

public void setOutsideTouchable(boolean touchable)

注意：這里要注意一下，有時侯我們希望觸摸PopupWindow 以外區域就隱藏PopupWindow,理論上我們只需要調用 setOutsideTouchable(ture)設置為ture就可以了，但是實際上只設置這個屬性是不行的，必須設置背景，也就是說要和setBackgroundDrawable(Drawable background)同時使用才有效，不然，點擊PopupWindow以外區域是不能隱藏掉的。

6，隱藏PopupWindow

public void dismiss()

7,設置dissmiss 回調監聽

public void setOnDismissListener(OnDismissListener onDismissListener)

8,顯示PopupWindow

//直接顯示在參照View 的左下方
public void showAsDropDown(View anchor)
// 顯示在參照View的左下方，可以通過xoff，yOff,來調節x,y方向的偏移
public void showAsDropDown(View anchor, int xoff, int off)

public void showAsDropDown(View anchor, int xoff, int yoff, int gravity)
//顯示在指定位置，相對于整個屏幕的window而言，通過gravity調解顯示在左、上、右、下、中. x,y調整兩個方向的偏移
public void showAtLocation(View parent, int gravity, int x, int y)

以上就是PopupWindow 重要的并且常用的API。

三、封裝通用PopupWindow,CustomPopWindow,使用鏈式的方式配置并顯示

由于每次寫PopupWindow都要寫很多重復代碼，因此簡單的封裝了一個CustomPopWindow.封裝了PopupWindow 的一些常用API，使用Builder模式，就像寫AlertDialog 一樣，鏈式配置。

使用方法：

1，簡便寫法：

CustomPopWindow popWindow = new CustomPopWindow.PopupWindowBuilder(this)
                .setView(R.layout.pop_layout1)//顯示的布局，還可以通過設置一個View
           //     .size(600,400) //設置顯示的大小，不設置就默認包裹內容
                .setFocusable(true)//是否獲取焦點，默認為ture
                .setOutsideTouchable(true)//是否PopupWindow 以外觸摸dissmiss
                .create()//創建PopupWindow
                .showAsDropDown(mButton1,0,10);//顯示PopupWindow

以上就是彈出一個簡單的PopupWindow，是不是看起來很優雅和簡單，還可以簡單一點：

CustomPopWindow popWindow = new CustomPopWindow.PopupWindowBuilder(this)
                .setView(R.layout.pop_layout1)//顯示的布局
                .create()//創建PopupWindow
                .showAsDropDown(mButton1,0,10);//顯示PopupWindow

如果是一個簡單的只展示文案的彈窗，就可以只設置一個View，就可以了，很簡單吧！！！

2，展示一個PopupWindow 彈窗菜單（像手機QQ，微信的頂部菜單）

View contentView = LayoutInflater.from(this).inflate(R.layout.pop_menu,null);
        //處理popWindow 顯示內容
        handleLogic(contentView);
        //創建并顯示popWindow
        mCustomPopWindow= new CustomPopWindow.PopupWindowBuilder(this)
                .setView(contentView)
                .create()
                .showAsDropDown(mButton3,0,20);

如果PopupWindow 展示的內容需要在程序代碼中設置或者響應點擊事件等，可以現獲取到這個View，然后處理一些顯示和點擊事件邏輯，再交給CustomPopWindow 創建顯示。比如響應菜單點擊事件的邏輯處理：

/**
     * 處理彈出顯示內容、點擊事件等邏輯
     * @param contentView
     */
    private void handleLogic(View contentView){
        View.OnClickListener listener = new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if(mCustomPopWindow!=null){
                    mCustomPopWindow.dissmiss();
                }
                String showContent = "";
                switch (v.getId()){
                    case R.id.menu1:
                        showContent = "點擊 Item菜單1";
                        break;
                    case R.id.menu2:
                        showContent = "點擊 Item菜單2";
                        break;
                    case R.id.menu3:
                        showContent = "點擊 Item菜單3";
                        break;
                    case R.id.menu4:
                        showContent = "點擊 Item菜單4";
                        break;
                    case R.id.menu5:
                        showContent = "點擊 Item菜單5" ;
                        break;
                }
                Toast.makeText(MainActivity.this,showContent,Toast.LENGTH_SHORT).show();
            }
        };
        contentView.findViewById(R.id.menu1).setOnClickListener(listener);
        contentView.findViewById(R.id.menu2).setOnClickListener(listener);
        contentView.findViewById(R.id.menu3).setOnClickListener(listener);
        contentView.findViewById(R.id.menu4).setOnClickListener(listener);
        contentView.findViewById(R.id.menu5).setOnClickListener(listener);
    }
}

3,展示一個ListView,其實跟上面是一樣的，這里貼一下實例代碼：

private void showPopListView(){
        View contentView = LayoutInflater.from(this).inflate(R.layout.pop_list,null);
        //處理popWindow 顯示內容
        handleListView(contentView);
        //創建并顯示popWindow
        mListPopWindow= new CustomPopWindow.PopupWindowBuilder(this)
                .setView(contentView)
                .size(ViewGroup.LayoutParams.MATCH_PARENT,ViewGroup.LayoutParams.MATCH_PARENT)//顯示大小
                .create()
                .showAsDropDown(mButton4,0,20);
    }

    private void handleListView(View contentView){
        RecyclerView recyclerView = (RecyclerView) contentView.findViewById(R.id.recyclerView);
        LinearLayoutManager manager = new LinearLayoutManager(this);
        manager.setOrientation(LinearLayoutManager.VERTICAL);
        recyclerView.setLayoutManager(manager);
        MyAdapter adapter = new MyAdapter();
        adapter.setData(mockData());
        recyclerView.setAdapter(adapter);
        adapter.notifyDataSetChanged();

    }

以上就是對于 PopupWindow的封裝和使用示例。封裝了PopupWindow 常用的API，沒有展示完全，還有像添加顯示和隱藏動畫setAnimationStyle(int animationStyle)，隱藏回調監聽等等。需要的朋友自己試試。

最后，貼出CustomPopWindow的源碼：

/**
 *
 * 自定義PopWindow類，封裝了PopWindow的一些常用屬性，用Builder模式支持鏈式調用
 * Created by zhouwei on 16/11/28.
 */

public class CustomPopWindow {
    private Context mContext;
    private int mWidth;
    private int mHeight;
    private boolean mIsFocusable = true;
    private boolean mIsOutside = true;
    private int mResLayoutId = -1;
    private View mContentView;
    private PopupWindow mPopupWindow;
    private int mAnimationStyle = -1;

    private boolean mClippEnable = true;//default is true
    private boolean mIgnoreCheekPress = false;
    private int mInputMode = -1;
    private PopupWindow.OnDismissListener mOnDismissListener;
    private int mSoftInputMode = -1;
    private boolean mTouchable = true;//default is ture
    private View.OnTouchListener mOnTouchListener;
    private CustomPopWindow(Context context){
        mContext = context;
    }

    public int getWidth() {
        return mWidth;
    }

    public int getHeight() {
        return mHeight;
    }

    /**
     *
     * @param anchor
     * @param xOff
     * @param yOff
     * @return
     */
    public CustomPopWindow showAsDropDown(View anchor, int xOff, int yOff){
        if(mPopupWindow!=null){
            mPopupWindow.showAsDropDown(anchor,xOff,yOff);
        }
        return this;
    }

    public CustomPopWindow showAsDropDown(View anchor){
        if(mPopupWindow!=null){
            mPopupWindow.showAsDropDown(anchor);
        }
        return this;
    }

    @RequiresApi(api = Build.VERSION_CODES.KITKAT)
    public CustomPopWindow showAsDropDown(View anchor, int xOff, int yOff, int gravity){
        if(mPopupWindow!=null){
            mPopupWindow.showAsDropDown(anchor,xOff,yOff,gravity);
        }
        return this;
    }


    /**
     * 相對于父控件的位置（通過設置Gravity.CENTER，下方Gravity.BOTTOM等 ），可以設置具體位置坐標
     * @param parent 
     * @param gravity
     * @param x the popup's x location offset
     * @param y the popup's y location offset
     * @return
     */
    public CustomPopWindow showAtLocation(View parent, int gravity, int x, int y){
        if(mPopupWindow!=null){
            mPopupWindow.showAtLocation(parent,gravity,x,y);
        }
        return this;
    }

    /**
     * 添加一些屬性設置
     * @param popupWindow
     */
    private void apply(PopupWindow popupWindow){
        popupWindow.setClippingEnabled(mClippEnable);
        if(mIgnoreCheekPress){
            popupWindow.setIgnoreCheekPress();
        }
        if(mInputMode!=-1){
            popupWindow.setInputMethodMode(mInputMode);
        }
        if(mSoftInputMode!=-1){
            popupWindow.setSoftInputMode(mSoftInputMode);
        }
        if(mOnDismissListener!=null){
            popupWindow.setOnDismissListener(mOnDismissListener);
        }
        if(mOnTouchListener!=null){
            popupWindow.setTouchInterceptor(mOnTouchListener);
        }
        popupWindow.setTouchable(mTouchable);



    }

    private PopupWindow build(){

        if(mContentView == null){
            mContentView = LayoutInflater.from(mContext).inflate(mResLayoutId,null);
        }

        if(mWidth != 0 && mHeight!=0 ){
            mPopupWindow = new PopupWindow(mContentView,mWidth,mHeight);
        }else{
            mPopupWindow = new PopupWindow(mContentView, ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT);
        }
        if(mAnimationStyle!=-1){
            mPopupWindow.setAnimationStyle(mAnimationStyle);
        }

        apply(mPopupWindow);//設置一些屬性

        mPopupWindow.setFocusable(mIsFocusable);
        mPopupWindow.setBackgroundDrawable(new ColorDrawable(Color.TRANSPARENT));
        mPopupWindow.setOutsideTouchable(mIsOutside);

        if(mWidth == 0 || mHeight == 0){
            mPopupWindow.getContentView().measure(View.MeasureSpec.UNSPECIFIED, View.MeasureSpec.UNSPECIFIED);
            //如果外面沒有設置寬高的情況下，計算寬高并賦值
            mWidth = mPopupWindow.getContentView().getMeasuredWidth();
            mHeight = mPopupWindow.getContentView().getMeasuredHeight();
        }

        mPopupWindow.update();

        return mPopupWindow;
    }

    /**
     * 關閉popWindow
     */
    public void dissmiss(){
        if(mPopupWindow!=null){
            mPopupWindow.dismiss();
        }
    }


    public static class PopupWindowBuilder{
        private CustomPopWindow mCustomPopWindow;

        public PopupWindowBuilder(Context context){
            mCustomPopWindow = new CustomPopWindow(context);
        }
        public PopupWindowBuilder size(int width,int height){
            mCustomPopWindow.mWidth = width;
            mCustomPopWindow.mHeight = height;
            return this;
        }


        public PopupWindowBuilder setFocusable(boolean focusable){
            mCustomPopWindow.mIsFocusable = focusable;
            return this;
        }



        public PopupWindowBuilder setView(int resLayoutId){
            mCustomPopWindow.mResLayoutId = resLayoutId;
            mCustomPopWindow.mContentView = null;
            return this;
        }

        public PopupWindowBuilder setView(View view){
            mCustomPopWindow.mContentView = view;
            mCustomPopWindow.mResLayoutId = -1;
            return this;
        }

        public PopupWindowBuilder setOutsideTouchable(boolean outsideTouchable){
            mCustomPopWindow.mIsOutside = outsideTouchable;
            return this;
        }

        /**
         * 設置彈窗動畫
         * @param animationStyle
         * @return
         */
        public PopupWindowBuilder setAnimationStyle(int animationStyle){
            mCustomPopWindow.mAnimationStyle = animationStyle;
            return this;
        }


        public PopupWindowBuilder setClippingEnable(boolean enable){
            mCustomPopWindow.mClippEnable =enable;
            return this;
        }


        public PopupWindowBuilder setIgnoreCheekPress(boolean ignoreCheekPress){
            mCustomPopWindow.mIgnoreCheekPress = ignoreCheekPress;
            return this;
        }

        public PopupWindowBuilder setInputMethodMode(int mode){
            mCustomPopWindow.mInputMode = mode;
            return this;
        }

        public PopupWindowBuilder setOnDissmissListener(PopupWindow.OnDismissListener onDissmissListener){
            mCustomPopWindow.mOnDismissListener = onDissmissListener;
            return this;
        }


        public PopupWindowBuilder setSoftInputMode(int softInputMode){
            mCustomPopWindow.mSoftInputMode = softInputMode;
            return this;
        }


        public PopupWindowBuilder setTouchable(boolean touchable){
            mCustomPopWindow.mTouchable = touchable;
            return this;
        }

        public PopupWindowBuilder setTouchIntercepter(View.OnTouchListener touchIntercepter){
            mCustomPopWindow.mOnTouchListener = touchIntercepter;
            return this;
        }


        public CustomPopWindow create(){
            //構建PopWindow
            mCustomPopWindow.build();
            return mCustomPopWindow;
        }

    }

}

好了，本篇文章到此結束，以上就是PopupWindow的一些介紹和一個簡單的封裝。

來自：http://www.jianshu.com/p/9304d553aa67

本文由用戶 Dominic19I 自行上傳分享，僅供網友學習交流。所有權歸原作者，若您的權利被侵害，請聯系管理員。

轉載本站原創文章，請注明出處，并保留原始鏈接、圖片水印。

本站是一個以用戶分享為主的開源技術平臺，歡迎各類分享！

本文地址：http://www.baiduhome.net/lib/view/open1480560690443.html

Android開發移動開發 PopupWindow

通用PopupWindow，幾行代碼搞定PopupWindow彈窗

相關經驗

相關資訊

相關文檔

目錄