DialogFragment细枝末节

时间  2019-11-16
标签 dialogfragment 细枝末节 繁體版
原文   原文链接

前言

在Android中，建立对话框有两种，一种是Dialog，另一种则是今天的主题，官方推荐的DialogFragmet，关于Dialog的使用就不赘述了，今天主要介绍DialogFragment的使用以及一些须要注意的事项，主要有如下几点。

  • DialogFragmeng相比Dialog的优点。java

  • DialogFrargment的使用。android

  • DialogFragment简单源码分析。app

  • DialogFragment须要注意的一些小细节。ide

1、DialogFragment的优点

  • 在 DialogFragment以前，咱们建立对话框通常采用 Dialog，并且从代码的编写角度来看，Dialog 使用起来其实更加简单，可是 Google 倒是推荐尽可能使用 DialogFragment，是否是感受很奇怪，其实缘由也很简单， DialogFragment 有着 Dialog 所没有的很是好的特性，可让它具备更高的可复用性（下降耦合）和更好的便利性（很好的处理屏幕翻转的状况）。

2、DialogFragment的使用

  • 方式一：重写DialogFragment的onCreateDialog方法源码分析

  • 方式二：重写DialogFragment的onCreateView方法布局

1.方式一具体使用学习

  • DialogFragment中重写onCreateDialog方法，返回一个Dialog。
@NonNull
    @Override
    public Dialog onCreateDialog(Bundle savedInstanceState) {
        Logger.d(TAG, "onCreateDialog");
        AppCompatDialog appCompatDialog = new AppCompatDialog(requireActivity());
        TextView textView = new TextView(requireActivity());
        textView.setText("经过onCreateDialog使用DialogFragment");
        textView.setTextSize(TypedValue.COMPLEX_UNIT_SP, 28);
        appCompatDialog.setContentView(textView);
        return appCompatDialog;
    }
复制代码
  • 在Activity中使用DialogFragment。
private void showOnCreateDialogFragment(){
        DialogFragment dialogFragment = new DialogFragment();
        dialogFragment.show(getSupportFragmentManager(), "tag");
    }
复制代码

2.方式二具体使用动画

  • DialogFragment中重写onCreateView方法，该方法建立的View将会做为Dialog的内容布局，使用方式则是跟方法一在Activity中方式一致，这里就不赘述了。
@Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
        Logger.d(TAG, "onCreateView");
        TextView textView = new TextView(requireActivity());
        textView.setText("经过onCreateView使用DialogFragment");
        textView.setGravity(Gravity.CENTER);
        textView.setTextSize(TypedValue.COMPLEX_UNIT_SP, 28);
        return textView;
    }
复制代码

3.DialogFragment中对Dialog属性的设置，咱们能够在DialogFragment的onStar中来对Dialog的样式进行设置，有一点须要注意的是，对于Dialog样式的设置，必须在onCretaeDialog方法后面执行，否则得不到Dialog实例，咱们能够打印一下DialogFragment从建立到show出来时执行的具体生命周期方法，具体内容以下：ui

2019-03-10 14:19:10.971 22626-22626/org.lym.sourcecodeparse D/DialogFragment: onAttach
2019-03-10 14:19:10.971 22626-22626/org.lym.sourcecodeparse D/DialogFragment: onCreate
2019-03-10 14:19:10.972 22626-22626/org.lym.sourcecodeparse D/DialogFragment: onCreateDialog
2019-03-10 14:19:10.994 22626-22626/org.lym.sourcecodeparse D/DialogFragment: onActivityCreated
2019-03-10 14:19:11.186 22626-22626/org.lym.sourcecodeparse D/DialogFragment: onStart
2019-03-10 14:19:11.186 22626-22626/org.lym.sourcecodeparse D/DialogFragment: onResume
复制代码
  • 从上面打印的回调生命周期方法来看，咱们是能够在onStart方法中对Dialog进行属性设置的,具体代码以下：
@Override
    public void onStart() {
        super.onStart();
        Dialog dialog = getDialog();
        Window window = dialog.getWindow();
        if (window == null) {
            return;
        }
        WindowManager.LayoutParams attributes = window.getAttributes();
        //设置Dialog窗口的高度
        attributes.height = WindowManager.LayoutParams.MATCH_PARENT;
        //设置Dialog窗口的宽度
        attributes.width = WindowManager.LayoutParams.MATCH_PARENT;
        //设置Dialog的居中方向
        attributes.gravity = Gravity.CENTER;
        //设置Dialog弹出时背景的透明度
        attributes.dimAmount = 0.6f;
        //设置Dialog水平方向的间距
        attributes.horizontalMargin = 0f;
        //设置Dialog垂直方向的间距
        attributes.verticalMargin = 0f;
        //设置Dialog显示时X轴的坐标,具体屏幕X轴的偏移量
        attributes.x = 0;
        //设置Dialog显示时Y轴的坐标,距离屏幕Y轴的偏移量
        attributes.y = 0;
        //设置Dialog的透明度
        attributes.alpha = 0f;
        //设置Dialog显示和消失时的动画
        attributes.windowAnimations = 0;
        window.setAttributes(attributes);
        Logger.d(TAG, "onStart");
    }

复制代码

3、DialogFragmeng源码分析

1.下面先贴一下DialogFragment的部分源码，并进行简要分析。this

public class DialogFragment extends Fragment implements OnCancelListener, OnDismissListener {
    boolean mViewDestroyed;
    boolean mDismissed;
    boolean mShownByMe;

    public DialogFragment() {
    }
    
    //标准的显示Fragment的方法，没什么好说的
    public void show(FragmentManager manager, String tag) {
        this.mDismissed = false;
        this.mShownByMe = true;
        FragmentTransaction ft = manager.beginTransaction();
        ft.add(this, tag);
        ft.commit();
    }
    
    //传入一个事务管理，将fragment加入到事务管理中，并返回回退栈id
    //返回的mBackStackId将在下文中用到
    public int show(FragmentTransaction transaction, String tag) {
        this.mDismissed = false;
        this.mShownByMe = true;
        transaction.add(this, tag);
        this.mViewDestroyed = false;
        this.mBackStackId = transaction.commit();
        return this.mBackStackId;
    }
    
    //第一个show方法的增强版，看名字就知道，使用这个方法以后，则会当即执行fragment当中相关的方法，这个待会儿做出解释
    public void showNow(FragmentManager manager, String tag) {
        this.mDismissed = false;
        this.mShownByMe = true;
        FragmentTransaction ft = manager.beginTransaction();
        ft.add(this, tag);
        ft.commitNow();
    }

    //Dialaog消失时的回调，setOndismissListener是在onActivityCreate中设置的,当前正是把dialog给dismiss，并无让dialogfragment出栈
    public void dismiss() {
        this.dismissInternal(false);
    }
    
    //dismiss的增强版，先消失dialog，并将dialogfragment移除栈内
    public void dismissAllowingStateLoss() {
        this.dismissInternal(true);
    }

    //显示判断dialog，是否已经消失，若是已经消失，则不作任何操做
    //1.若是dialog实例不为空，先调用dialog的dismiss方法，隐藏dialog
    //2.若是先前调用的是public int show(FragmentTransaction transaction, String tag)
    //方法显示的dialogfragment，那么此时会根据以前返回的mBackStackId来将fragment移除栈内
    //3.若是不是则再启用事务将dialogfragment移除栈内,这里会根据传入的allowStateLoss来区分
    //提交事务的方法
    void dismissInternal(boolean allowStateLoss) {
        if (!this.mDismissed) {
            this.mDismissed = true;
            this.mShownByMe = false;
            if (this.mDialog != null) {
                this.mDialog.dismiss();
            }

            this.mViewDestroyed = true;
            if (this.mBackStackId >= 0) {
                this.getFragmentManager().popBackStack(this.mBackStackId, 1);
                this.mBackStackId = -1;
            } else {
                FragmentTransaction ft = this.getFragmentManager().beginTransaction();
                ft.remove(this);
                if (allowStateLoss) {
                    ft.commitAllowingStateLoss();
                } else {
                    ft.commit();
                }
            }

        }
    }
    
    //若是子类重写该方法，那么使用的就是你自定义的dialog
    @NonNull
    public Dialog onCreateDialog(Bundle savedInstanceState) {
        return new Dialog(this.getActivity(), this.getTheme());
    }
    
    //dialog设置了onDismissListener后的回调，若是dialog正常消失，次回调中的方法不会调用到
    //由于在DialogFragment的onStar方法中将mViewDestroyed变量赋值为true，dialog显示设置到调用显示出来的生命周期回调咱们已经打印过了。
    public void onDismiss(DialogInterface dialog) {
        if (!this.mViewDestroyed) {
            this.dismissInternal(true);
        }
    }

    //该方法，先判断Dialog是否已经显示，而后会取onCreateView中返回的View，若是View不为空，那么该View将做为Dialog的内容布局，因此，若是你同时重写了onCreateDialog和onCreateView方法，那么会优先采用onCreateView当中的View做为内容布局,而后再做了一些监听设置
    //设置了dialog是否可点击
    //设置了dialog的消失监听onDismissListener,因此消失时会回调文中的dimiss方法
    //设置了dialog的取消监听onCancelListener,在取消时会回调文中的onCancel方法
    public void onActivityCreated(Bundle savedInstanceState) {
        super.onActivityCreated(savedInstanceState);
        if (this.mShowsDialog) {
            View view = this.getView();
            if (view != null) {
                if (view.getParent() != null) {
                    throw new IllegalStateException("DialogFragment can not be attached to a container view");
                }

                this.mDialog.setContentView(view);
            }

            Activity activity = this.getActivity();
            if (activity != null) {
                this.mDialog.setOwnerActivity(activity);
            }

            this.mDialog.setCancelable(this.mCancelable);
            this.mDialog.setOnCancelListener(this);
            this.mDialog.setOnDismissListener(this);
            if (savedInstanceState != null) {
                Bundle dialogState = savedInstanceState.getBundle("android:savedDialogState");
                if (dialogState != null) {
                    this.mDialog.onRestoreInstanceState(dialogState);
                }
            }

        }
    }
}

复制代码

2.源码分析总结

  • 能够重写onCreateDialog或者onCreateView来建立DialogFragment的视图，可是onCretaeView的优先级要高于onCreateDilaog，因此没有特殊的须要，通常经过重写onCreateView来建立Dialog的视图便可。

  • 从一开始咱们就打印了DialogFragment从建立视图到show出来回调的一系列生命周期方法，咱们得知设置dialog的属性能够在DialogFragment中的onStar回调中进行。

  • 对于dialog的显示咱们经过查看源码得知一共有三个方法，show()方法传入一个fragmentManager以及一个tag，showNow方法，传入一个fragmentManger和一个tag，show()方法，传入一个事务和一个tag，并返回该事务中回退栈的id，在调用dismissInternal()方法时，会根据显示DialogFragment的类型来操做DialogFragment出栈。

  • DialogFragment会在onActivityCreate()中对Dialog的内容试图进行一次赋值，若是你重写了onCrateView方法，并返回了一个不为空的实例，那么将会做为该Dialog的内容视图，而后再对dialog设置了是否可取消，消失监听，以及取消监听

  • 经过上面的源码简析，咱们得知在DialogFragment消失时，只会将dialog给隐藏，并不会讲DialogFragment移除栈内，若是想讲DialogFragment在dialog消失时移除栈内，那么须要手动调用dismissInternal()方法

4、细节注意事项

  • 能够经过重写onCreateDialog和onCreateView来设置DialogFragment的视图，但onCraeteView设置的视图优先级要高于在onCreateDialog。

  • 设置Dialog的属性须要在onCreateDialog回调后设置，否则getDialog获得的对象则会是null,推荐在onStar方法中对Dialog进行属性设置。

  • DialogFragment单个实例只能show一次DialogFrament,若是屡次展现的话，则会抛出以下异常

Process: org.lym.sourcecodeparse, PID: 27108
    java.lang.IllegalStateException: Fragment already added: DialogFragment{8262d74 #0 tag}
        at android.support.v4.app.FragmentManagerImpl.addFragment(FragmentManager.java:1893)
        at android.support.v4.app.BackStackRecord.executeOps(BackStackRecord.java:760)
        at android.support.v4.app.FragmentManagerImpl.executeOps(FragmentManager.java:2595)
        at android.support.v4.app.FragmentManagerImpl.executeOpsTogether(FragmentManager.java:2382)
        at android.support.v4.app.FragmentManagerImpl.removeRedundantOperationsAndExecute(FragmentManager.java:2337)
复制代码

  • DialogFragment在正常Dismiss后并不会直接从当前的栈中移除，而是在DialogFragment中的onDestroyView()回调时，才会对DialogFragment进行出栈操做，因此若是你若是须要在Activity中频繁的显示隐藏一个DialogFragment，那么在dismiss时须要手动的调用dismissAllowingStateLoss()方法，而且再次show时不能用上一个DialogFragment实例。

  • DialogFragment并无对Dialog的消失提供监听给调用者使用，可是咱们经过源码分析得知，DialogFragment在onActivityCreate当中其实已经帮咱们设置了onDismissListener,因此咱们若是须要对Dialog的消失进行监听的话只需重写onDismiss方法便可，还有一种方式则是覆盖父类设置的onDismissListener监听，可是需注意的时，这个监听的复写，必须在父类onActivityCreate方法调用以后，关于消失监听的两种写法以下:

//mListener为提供到外部使用的回调
 @Override
    public void onDismiss(DialogInterface dialog) {
        super.onDismiss(dialog);
        mListener.onDismiss(dialog);
        Logger.d(TAG, "onDismiss");
    }
    
    //复写setOnDismissListener必须发生在父类的onActivityCreate以后
    @Override
    public void onActivityCreated(Bundle savedInstanceState) {
        super.onActivityCreated(savedInstanceState);
        if (getDialog() != null && null != mListener) {
            getDialog().setOnDismissListener(new DialogInterface.OnDismissListener() {
                @Override
                public void onDismiss(DialogInterface dialog) {
                    ToastUtils.showToast("覆盖后的OnDismiss Listener");
                }
            });
        }
        Logger.d(TAG, "onActivityCreated");
    }
复制代码

结语：以上即是全文的内容，是本身在使用DialogFragment中碰到了一些坑以及学习后的一些理解，但愿能对您有帮助。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程