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资源,需要自行定义配置,可以参考如下形式:


这样就可以根据需求定制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

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

效果示例

Android 你可能需要的NiceDialog_第1张图片
分享
Android 你可能需要的NiceDialog_第2张图片
好友设置
Android 你可能需要的NiceDialog_第3张图片
评论
Android 你可能需要的NiceDialog_第4张图片
红包
Android 你可能需要的NiceDialog_第5张图片
加载提示
Android 你可能需要的NiceDialog_第6张图片
确定

你可能感兴趣的:(Android 你可能需要的NiceDialog)