Android 必知必会 - DialogFragment 使用总结

背景

Android 官方推荐使用 DialogFragment 来代替 Dialog ，可以让它具有更高的可复用性（降低耦合）和更好的便利性（很好的处理屏幕翻转的情况）。

而创建 DialogFragment 有两种方式：

1. 覆写其 onCreateDialog 方法 — ①
2. 覆写其 onCreateView 方法 — ②

虽然这两种方式都能实现相同的效果，但是它们各有自己适合的应用场景：

1. 方法 ①，一般用于创建替代传统的 Dialog 对话框的场景，UI 简单，功能单一。
2. 方法 ②，一般用于创建复杂内容弹窗或全屏展示效果的场景，UI 复杂，功能复杂，一般有网络请求等异步操作。

应用

基本用法

对于方法 ①，创建一个 Dialog 并返回它即可：

@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
  	//为了样式统一和兼容性，可以使用 V7 包下的 AlertDialog.Builder
    AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
  	// 设置主题的构造方法
	// AlertDialog.Builder builder = new AlertDialog.Builder(getActivity(), R.style.CustomDialog);
    builder.setTitle("注意：")
           .setMessage("是否退出应用？")
           .setPositiveButton("确定", null)
           .setNegativeButton("取消", null)
           .setCancelable(false);
           //builder.show(); // 不能在这里使用 show() 方法
    return builder.create();
}

当然，你也可以使用自定义 View 来创建：

@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
	AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());
  	// 设置主题的构造方法
		// AlertDialog.Builder builder = new AlertDialog.Builder(getActivity(), R.style.CustomDialog);
	LayoutInflater inflater = getActivity().getLayoutInflater();  
    View view = inflater.inflate(R.layout.fragment_dialog, null);  
    builder.setView(view) 
 		// Do Someting,eg: TextView tv = view.findViewById(R.id.tv);
    return builder.create();
}

PS：创建 Dialog 的方式有多种，比如下面这种，使用时略有差异，需要自己注意：

@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
	LayoutInflater inflater = getActivity().getLayoutInflater();
    View view = inflater.inflate(R.layout.fragment_dialog, null);
	Dialog dialog = new Dialog(getActivity());
    // 设置主题的构造方法
  	// Dialog dialog = new Dialog(getActivity(), R.style.CustomDialog);
    dialog.setContentView(view);
  	// Do Someting
	return dialog;
}

对于方法 ②，和普通的 Fragment 用法基本一致：

@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
	View rootView = inflater.inflate(R.layout.fragment_dialog, container, false);
	// Do Someting
	return rootView;
}
/**
 * 设置主题需要在 onCreate() 方法中调用 setStyle() 方法
 */
@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
	super.onCreate(savedInstanceState);
	setStyle(DialogFragment.STYLE_NO_TITLE, R.style.CustomDialog);
}

处理屏幕翻转

如果使用传统的 Dialog ，需要我们手动处理屏幕翻转的情况，但使用 DialogFragment 的话，则不需要我们进行任何处理，FragmentManager 会自动管理 DialogFragment 的生命周期。

扩展阅读：Dialog 在屏幕翻转时的处理

无标题栏/全屏

在基本用法里代码注释有设置主题的地方，下面详细说下两种方法下设置无标题栏和实现全屏的方式：

无标题栏

对于方法 ① ：

@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
	LayoutInflater inflater = getActivity().getLayoutInflater();
	View view = inflater.inflate(R.layout.fragment_dialog, null);
	Dialog dialog = new Dialog(getActivity(), R.style.CustomDialog);
  	// 关闭标题栏，setContentView() 之前调用
	dialog.requestWindowFeature(Window.FEATURE_NO_TITLE);
	dialog.setContentView(view);
	dialog.setCanceledOnTouchOutside(true);
	return dialog;
}

对于方法 ②：

@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
	super.onCreate(savedInstanceState);
	/**
	 * setStyle() 的第一个参数有四个可选值：
	 * STYLE_NORMAL|STYLE_NO_TITLE|STYLE_NO_FRAME|STYLE_NO_INPUT
	 * 其中 STYLE_NO_TITLE 和 STYLE_NO_FRAME 可以关闭标题栏
	 * 每一个参数的详细用途可以直接看 Android 源码的说明
	 */
	setStyle(DialogFragment.STYLE_NO_TITLE, R.style.CustomDialog);
}

实现全屏（宽/高度全屏）

常用的形式大多是宽度上和屏幕一样宽，高度自适应，下面直接看代码：

方法 ① ：

@Override
public Dialog onCreateDialog(Bundle savedInstanceState) {
	LayoutInflater inflater = getActivity().getLayoutInflater();
	View view = inflater.inflate(R.layout.fragment_dialog, null);
	Dialog dialog = new Dialog(getActivity(), R.style.CustomDialog);
	dialog.requestWindowFeature(Window.FEATURE_NO_TITLE);
	dialog.setContentView(view);
	dialog.setCanceledOnTouchOutside(true);
	//Do something
    // 设置宽度为屏宽、位置靠近屏幕底部
	Window window = dialog.getWindow();
	window.setBackgroundDrawableResource(R.color.transparent);
	WindowManager.LayoutParams wlp = window.getAttributes();
	wlp.gravity = Gravity.BOTTOM;
	wlp.width = WindowManager.LayoutParams.MATCH_PARENT;
  	wlp.height = WindowManager.LayoutParams.WRAP_CONTENT;
	window.setAttributes(wlp);
	return dialog;
}

代码 12 行设置了窗口的背景色为透明，这一步是必须的；

代码 15 行设置窗口的宽度为 MATCH_PARENT,效果是和屏幕宽度一样大，同样你也可以设置高度的值。设置宽度和高度除了 MATCH_PARENT 和 WRAP_CONTENT ，也可以直接设置成具体的数值。

方法 ②：

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

@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        getDialog().setCanceledOnTouchOutside(true);
        View rootView = inflater.inflate(R.layout.fragment_dialog, container, false);
        //Do something
        // 设置宽度为屏宽、靠近屏幕底部。
        final Window window = getDialog().getWindow();
        window.setBackgroundDrawableResource(R.color.transparent);
        window.getDecorView().setPadding(0, 0, 0, 0);
        WindowManager.LayoutParams wlp = window.getAttributes();
        wlp.gravity = Gravity.BOTTOM;
        wlp.width = WindowManager.LayoutParams.MATCH_PARENT;
        wlp.height = WindowManager.LayoutParams.WRAP_CONTENT;
        window.setAttributes(wlp);
        return rootView;
}

代码 14 行设置了窗口的背景色为透明，这一步是必须的；

代码 15 行设置了窗口的 Pading 值全部为0，这一步也是必须的，内容不能填充全部宽度和高度。

其他的和 ① 中的类似。

应用场景区别

文章一开始简单总结了方法 ① 和方法 ② 的应用场景，这里说明下：

• 从基本的用法中可以看到方法 ① 为简单的替代 Dialog 提供了非常方便的创建方式，比方法 ② 有优势
• 方法 ① 在使用了多线程（例如网络请求）的情况下，不能正确的获取当前 Fragment 的状态，会产生空指针异常。方法 ② 则没有此问题，而且，其创建方式默认使用了自定义 View，更便于应对复杂 UI 的场景。

这里举例说明：方法 ① 和方法 ② 的//Do something 代码处，我们进行一些异步操作：

TextView title = rootView.findViewById(R.id.dialoag_tv);
title.setText("Value A");
new SomeTask().execute(url);

private class SomeTask extends AsyncTask<String, Void, Boolean> {

        @Override
        protected Boolean doInBackground(String... params) {
            // 一些网络请求
          	// 成功时 return true;
            // 异常时 return false;
        }

        @Override
        protected void onPostExecute(Boolean aBoolean) {
            super.onPostExecute(aBoolean);
            // if (!isVisible()) return;
            if (aBoolean) {
                title.setText("Value B");
            }
        }
}

如果在网络请求未结束或者刚结束时关闭了当前 DialogFragment ，代码 19 行就会报空指针异常了，代码 17 的作用就是判断 DialogFragment 当前的状态是否为可用态，但是 isVisible() 以及 isHide() 对于方法 ① 无法正确返回其状态，方法 ② 则正常。方法 ① 和方法 ② 创建 DialogFragment 的一些状态并不是完全一致。

PS：你也可以使用静态 Handler 结合弱引用等来处理异步操作，那样对 DialogFragment 状态的获取就不重要了。

总结

以上是个人在实际开发过程中的一点总结和看法，希望你能抱着存疑的态度进行尝试，如果有新的观点或者文章中有不正确的地方，欢迎和我联系。

扩展阅读：

• 详细解读 DialogFragment
• Android–>Dialog/DialogFragment宽度高度修改/全屏,自定义样式
• Full Screen DialogFragment in Android

PS：你可以通过下面的方式和我联系

• 微博：cafeting
• Github： likfe
• CSDN：他叫自己Mr.张