Android 你可能需要的NiceDialog

*本篇文章已授权微信公众号 guolin_blog (郭霖)独家发布

DialogFragment是Android3.0引入的,也是官方推荐来创建对话框的,兼具dialog以及Fragment的特性。接下来在DialogFragment的基础上实现我们的NiceDialog,我们实现的dialog要能够简单的使用,也要易扩展,同时支持BottomDialog,让dialog的使用更方便。

基本原理

首先要使用DialogFragment,必须实现DialogFragment的如下两个方法之一

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        return super.onCreateView(inflater, container, savedInstanceState);
    }

    @Override
    public Dialog onCreateDialog(Bundle savedInstanceState) {
        return super.onCreateDialog(savedInstanceState);
    }

如果实现onCreateDialog()方法,则需要在其中利用AlertDialog或Dialog创建出DialogFragment,而这里我们实现onCreateView()方法来创建DialogFragment,先创建类BaseNiceDialog继承DialogFragment

  public abstract class BaseNiceDialog extends DialogFragment {
    public abstract int intLayoutId();
    public abstract void convertView(ViewHolder holder, BaseNiceDialog dialog);
    @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setStyle(DialogFragment.STYLE_NO_TITLE, R.style.NiceDialog);
    }

    @Nullable
    @Override
    public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        View view = inflater.inflate(intLayoutId(), container, false);
        convertView(ViewHolder.create(view), this);
        return view;
    }

其中intLayoutId()方法用来设置dialog的布局文件,convertView()方法提供了ViewHolderBaseNiceDialog两个类型参数以方便相关UI操作和dialog的dismiss。其中ViewHolder是一个辅助view初始化、绑定事件等操作的工具类,具体见源码。

这样就完成了第一步,但是呢,此时如果用BaseNiceDialog来展示一个对话框,你会发现效果很不理想,因为默认的对话框有标题、背景等,我们需要将其去掉,可以通过重写DialogFragmentonCreate()方法,来设置相关的Style完成:

@Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setStyle(DialogFragment.STYLE_NO_TITLE, R.style.NiceDialog);
    }

到此,通过继承BaseNiceDialog并实现intLayoutId()convertView()就可以正常使用了,但是距离我们好用的目标还差太远,为此我们提供了如下方法:

  • setDimAmount(float dimAmount) 调节DialogFragment灰色背景深浅
  • setShowBottom(boolean showBottom) 是否在底部显示(原来就是一个属性的事儿)
  • setWidth(int width) 宽度
  • setHeight(int height) 高度
  • setMargin(int margin) 距离屏幕左右的margin
  • setAnimStyle(@StyleRes int animStyle) 进入退出动画
  • setOutCancel(boolean outCancel) 触摸外部是否取消

都是一些set方法,很简单。主要来看如何配置这样属性:

private void initParams() {
        Window window = getDialog().getWindow();
        if (window != null) {
            //设置dialog进入、退出的动画
            window.setWindowAnimations(animStyle);
            WindowManager.LayoutParams lp = window.getAttributes();
            //调节灰色背景深浅[0-1],默认0.5f
            lp.dimAmount = dimAmount;
            //是否在底部显示
            if (showBottom) {
                lp.gravity = Gravity.BOTTOM;
            }
            //设置dialog宽度
            if (width == 0) {
                lp.width = Utils.getScreenWidth(getContext()) - 2 * Utils.dp2px(getContext(), margin);
            } else {
                lp.width = Utils.dp2px(getContext(), width);
            }
            //设置dialog高度
            if (height == 0) {
                lp.height = WindowManager.LayoutParams.WRAP_CONTENT;
            } else {
                lp.height = Utils.dp2px(getContext(), height);
            }

            window.setAttributes(lp);
        }
        //是否触摸外部取消
        setCancelable(outCancel);
    }

主要就是通过操作Window类以及其LayoutParams来完成的,要让dialog在底部显示,只需要设置lp.gravity = Gravity.BOTTOM(当然在左边、右边、顶部显示也就不是问题了,虽然需求很诡异......),其中的animStyle是一个包含dialog进入、退出动画的Style资源,需要自行定义配置,可以参考如下形式:

<style name="EnterExitAnimation" parent="android:Animation">
        <item name="android:windowEnterAnimation">@anim/enter_anim</item>
        <item name="android:windowExitAnimation">@anim/exit_anim</item>
    </style>

这样就可以根据需求定制dialog的进入、退出动画了。
initParams()方法在DialogFragmentonStart()回调中调用,到此我们的BaseNiceDialog核心点就介绍完毕了,很是蛮简单的。现在就可以通过如下方式来使用了:

public class MyDialog extends BaseNiceDialog {
        @Override
        public int intLayoutId() {
            return R.layout.dialog;
        }

        @Override
        public void convertView(ViewHolder holder, final BaseNiceDialog dialog) {
                //相关View操作
        }
    }
new MyDialog()
             .setMargin(60)
             .setOutCancel(false)
             .show(getSupportFragmentManager());

这样虽然方便了扩展,但是没有扩展需求的话,用起来确实有些麻烦,所以需要继续完善,可以定义一个NiceDialog类继承BaseNiceDialog

public class NiceDialog extends BaseNiceDialog {
    private ViewConvertListener convertListener;

    public static NiceDialog init() {
        return new NiceDialog();
    }

    @Override
    public int intLayoutId() {
        return layoutId;
    }

    @Override
    public void convertView(ViewHolder holder, BaseNiceDialog dialog) {
        if (convertListener != null) {
            convertListener.convertView(holder, dialog);
        }
    }

    public NiceDialog setLayoutId(@LayoutRes int layoutId) {
        this.layoutId = layoutId;
        return this;
    }

    public NiceDialog setConvertListener(ViewConvertListener convertListener) {
        this.convertListener = convertListener;
        return this;
    }
}

代码很简单,就是重新BaseNiceDialog的抽象方法,并提供了一个ViewConvertListener接口:

public interface ViewConvertListener {
    void convertView(ViewHolder holder, BaseNiceDialog dialog);
}

这样就能方便的进行UI操作以及控制dialog了。同时也提供了设置dialog布局文件以及绑定接口的方法,之后如果没有扩展BaseNiceDialog的需求,就可以愉快的通过NiceDialog类来实现想要的dialog,例如:

NiceDialog.init()
                .setLayoutId(R.layout.dialog)
                .setConvertListener(new ViewConvertListener() {
                    @Override
                    public void convertView(ViewHolder holder, final BaseNiceDialog dialog) {
                              //View相关操作
                    }
                })
                .setDimAmount(0.3f)
                .setShowBottom(true)
                .setAnimStyle(R.style.EnterExitAnimation)
                .show(getSupportFragmentManager());

但是呢,还有问题,如果在dialog展示情况下旋转屏幕,会直接崩溃掉,因为这个过程中dialog会销毁掉导致布局文件id以及其它配置参数丢失,重新创建时因数据缺失而出现问题,所以就需要在屏幕旋转等可能导致dialog销毁重建的场景发生时,先保存需要的数据,然后在重建时恢复需要的数据,这样就能避免问题了。
具体是做法是在BaseNiceDialog类中重写onSaveInstanceState(Bundle outState)方法来保存数据:

@Override
    public void onSaveInstanceState(Bundle outState) {
        super.onSaveInstanceState(outState);
        outState.putInt(MARGIN, margin);
        outState.putInt(WIDTH, width);
        outState.putInt(HEIGHT, height);
        outState.putFloat(DIM, dimAmount);
        outState.putBoolean(BOTTOM, showBottom);
        outState.putBoolean(CANCEL, outCancel);
        outState.putInt(ANIM, animStyle);
        outState.putInt(LAYOUT, layoutId);
    }

并在onCreate(@Nullable Bundle savedInstanceState)方法中恢复数据:

@Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        if (savedInstanceState != null) {
            margin = savedInstanceState.getInt(MARGIN);
            width = savedInstanceState.getInt(WIDTH);
            height = savedInstanceState.getInt(HEIGHT);
            dimAmount = savedInstanceState.getFloat(DIM);
            showBottom = savedInstanceState.getBoolean(BOTTOM);
            outCancel = savedInstanceState.getBoolean(CANCEL);
            animStyle = savedInstanceState.getInt(ANIM);
            layoutId = savedInstanceState.getInt(LAYOUT);
        }
    }

这样就dialog就能正常显示,不会出现崩溃的问题了。
但是问题还没结束,由于我们在NiceDialog类中有一个ViewConvertListener,如果用NiceDialog创建对话框,在屏幕发生旋转时会导致设置的ViewConvertListener实例被释放掉,所以之前给View绑定的点击事件、View的属性配置就会失效,恢复到初始状态,所以就需要保存、恢复ViewConvertListener的实例,所以需要修改ViewConvertListener的实,现使其序列化,这样就能通过Bundle来保存了

public abstract class ViewConvertListener implements Parcelable {
    protected abstract void convertView(ViewHolder holder, BaseNiceDialog dialog);
    //省略若干代码
}

之前是通过Serializable实现序列化,但是当dialog在前台时,如果按home键使app退回后台则会发生crash,所以通过Parcelable实现序列化。

接下里就是在NiceDialog里做保存与恢复操作:

@Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        if (savedInstanceState != null) {
            convertListener = savedInstanceState.getParcelable("listener");
        }
    }

    @Override
    public void onSaveInstanceState(Bundle outState) {
        super.onSaveInstanceState(outState);
       outState.putParcelable("listener", convertListener);
    }

这样问题就解决了。

到这里NiceDialog的原理就介绍完了,是不是很简单呢,一般情况我们通过NiceDialog类就可以完成dialog的创建,如果你有更多的需求,例如给dialog传参则可以扩展BaseNiceDialog来实现。

更多的细节和用法示例可参考Github源码:NiceDialog

最后希望对你有所帮助吧!!!

效果示例

分享
好友设置
评论
红包
加载提示
确定
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,298评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,701评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 107,078评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,687评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,018评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,410评论 1 211
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,729评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,412评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,124评论 1 239
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,379评论 2 242
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,903评论 1 257
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,268评论 2 251
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,894评论 3 233
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,014评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,770评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,435评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,312评论 2 260

推荐阅读更多精彩内容