本文共 11901 字，大约阅读时间需要 39 分钟。

1、 概述

DialogFragment在android 3.0时被引入。是一种特殊的Fragment，它和Fragment有着基本一致的声明周期。用于在Activity的内容之上展示一个模态的对话框。典型的用于：展示警告框，输入框，确认框等等。

在DialogFragment产生之前，我们创建对话框：一般采用AlertDialog和Dialog。注：官方不推荐直接使用Dialog创建对话框。

2、 好处与用法

• 从代码的编写角度看，Dialog使用起来要更为简单
• Android 官方推荐使用 DialogFragment 来代替 Dialog ，可以让它具有更高的可复用性（降低耦合）和更好的便利性（很好的处理屏幕翻转的情况）。
• 在手机配置变化，导致Activity需要重新创建时，例如旋屏，基于DialogFragment的对话框将会由FragmentManager自动重建，然而基于Dialog实现的对话框则没有这样的能力）
• DialogFragment也允许开发者把Dialog作为内嵌的组件进行重用，类似Fragment（可以在大屏幕和小屏幕显示出不同的效果）。
• 其实DialogFragment还拥有fragment的优点，即可以在一个Activity内部实现回退（因为FragmentManager会管理一个回退栈）

下面会通过例子展示这些好处~

3、创建DialogFragment

使用DialogFragment至少需要实现onCreateView或者onCreateDIalog方法。

• onCreateView即使用定义的xml布局文件展示Dialog。
• onCreateDialog即利用AlertDialog或者Dialog创建出Dialog。

1、 重写onCreateView创建Dialog

应用场景： 一般用于创建复杂内容弹窗或全屏展示效果的场景，UI 复杂，功能复杂，一般有网络请求等异步操作。

a）布局文件，我们创建一个设置名称的布局文件：

b）继承DialogFragment，重写onCreateView方法

package com.example.zhy_dialogfragment;  import android.app.DialogFragment;  import android.os.Bundle;  import android.view.LayoutInflater;  import android.view.View;  import android.view.ViewGroup;  public class EditNameDialogFragment extends DialogFragment  {
         @Override      public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {          View view = inflater.inflate(R.layout.fragment_edit_name, container);          return view;      }  }

c）测试运行：

Main方法中调用：

public void showEditDialog(View view)   {      EditNameDialogFragment editNameDialog = new EditNameDialogFragment();      editNameDialog.show(getFragmentManager(), ”EditNameDialog”);  }

效果图：

可以看到，对话框成功创建并显示出来，不过默认对话框有个讨厌的标题，我们怎么去掉呢：可以在onCreateView中调用getDialog().requestWindowFeature(Window.FEATURE_NO_TITLE);即可去掉。即：

public class EditNameDialogFragment extends DialogFragment  {
         @Override      public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)  {          getDialog().requestWindowFeature(Window.FEATURE_NO_TITLE);          View view = inflater.inflate(R.layout.fragment_edit_name, container);          return view;      }  }

效果图：

很完美的去掉了讨厌的标题。或者还可以 /**

* 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);

2、 重写onCreateDialog创建Dialog

在onCreateDialog中一般可以使用AlertDialog或者Dialog创建对话框，不过既然google不推荐直接使用Dialog，我们就使用AlertDialog来创建一个登录的对话框。

应用场景：一般用于创建替代传统的 Dialog 对话框的场景，UI 简单，功能单一。

a）布局文件

b）继承DialogFragment重写onCreateDialog方法

package com.example.zhy_dialogfragment;  import android.app.AlertDialog;  import android.app.Dialog;  import android.app.DialogFragment;  import android.content.DialogInterface;  import android.os.Bundle;  import android.view.LayoutInflater;  import android.view.View;  import android.view.ViewGroup;  import android.widget.EditText;  public class LoginDialogFragment extends DialogFragment  {
         @Override      public Dialog onCreateDialog(Bundle savedInstanceState){          AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());          // Get the layout inflater          LayoutInflater inflater = getActivity().getLayoutInflater();          View view = inflater.inflate(R.layout.fragment_login_dialog, null);          // Inflate and set the layout for the dialog          // Pass null as the parent view because its going in the dialog layout          builder.setView(view)                  // Add action buttons                 .setPositiveButton(”Sign in”, new DialogInterface.OnClickListener() {                     @Override                     public void onClick(DialogInterface dialog, int id) {                     }                  })               .setNegativeButton(”Cancel”, null);          // 关闭标题栏，setContentView() 之前调用        //dialog.requestWindowFeature(Window.FEATURE_NO_TITLE);               return builder.create();      }  }

c）调用

public void showLoginDialog(View view) {      LoginDialogFragment dialog = new LoginDialogFragment();      dialog.show(getFragmentManager(), ”loginDialog”);  }

效果图：

可以看到通过重写onCreateDialog同样可以实现创建对话框，效果还是很nice的。

5、传递数据给Activity

从dialog传递数据给Activity，可以使用“fragment interface pattern”的方式，下面通过一个改造上面的登录框来展示这种模式。

改动比较小，直接贴代码了：

package com.example.zhy_dialogfragment;  import android.app.AlertDialog;  import android.app.Dialog;  import android.app.DialogFragment;  import android.content.DialogInterface;  import android.os.Bundle;  import android.view.LayoutInflater;  import android.view.View;  import android.view.ViewGroup;  import android.widget.EditText;  public class LoginDialogFragment extends DialogFragment {
         private EditText mUsername;      private EditText mPassword;      public interface LoginInputListener{
             void onLoginInputComplete(String username, String password);      }      @Override      public Dialog onCreateDialog(Bundle savedInstanceState){          AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());          // Get the layout inflater          LayoutInflater inflater = getActivity().getLayoutInflater();          View view = inflater.inflate(R.layout.fragment_login_dialog, null);          mUsername = (EditText) view.findViewById(R.id.id_txt_username);          mPassword = (EditText) view.findViewById(R.id.id_txt_password);          // Inflate and set the layout for the dialog          // Pass null as the parent view because its going in the dialog layout          builder.setView(view)                  // Add action buttons                 .setPositiveButton(”Sign in”, new DialogInterface.OnClickListener(){                     @Override                     public void onClick(DialogInterface dialog, int id){                         LoginInputListener listener = (LoginInputListener) getActivity();                         listener.onLoginInputComplete(mUsername.getText().toString(), mPassword.getText().toString());                     }                  })               .setNegativeButton(”Cancel”, null);          return builder.create();      }  }

拿到username和password的引用，在点击登录的时候，把activity强转为我们自定义的接口：LoginInputListener，然后将用户输入的数据返回。

MainActivity中需要实现我们的接口LoginInputListener，实现我们的方法，就可以实现当用户点击登陆时，获得我们的帐号密码了：

c) MainActivity

package com.example.zhy_dialogfragment;  import com.example.zhy_dialogfragment.LoginDialogFragment.LoginInputListener;  import android.app.Activity;  import android.app.AlertDialog;  import android.content.DialogInterface;  import android.os.Bundle;  import android.view.LayoutInflater;  import android.view.View;  import android.widget.Toast;  public class MainActivity extends Activity implements LoginInputListener {
         @Override      protected void onCreate(Bundle savedInstanceState){          super.onCreate(savedInstanceState);          setContentView(R.layout.activity_main);      }      public void showLoginDialog(View view){          LoginDialogFragment dialog = new LoginDialogFragment();          dialog.show(getFragmentManager(), ”loginDialog”);    }      @Override      public void onLoginInputComplete(String username, String password){          Toast.makeText(this, “帐号：” + username + “,  密码 :” + password, Toast.LENGTH_SHORT).show();      }  }

效果：

6、DialogFragment做屏幕适配

我们希望，一个对话框在大屏幕上以对话框的形式展示，而小屏幕上则直接嵌入当前的Actvity中。这种效果的对话框，只能通过重写onCreateView实现。下面我们利用上面的EditNameDialogFragment来显示。

EditNameDialogFragment我们已经编写好了，直接在MainActivity中写调用

public void showDialogInDifferentScreen(View view)  {          FragmentManager fragmentManager = getFragmentManager();          EditNameDialogFragment newFragment = new EditNameDialogFragment();          boolean mIsLargeLayout = getResources().getBoolean(R.bool.large_layout) ;          Log.e(”TAG”, mIsLargeLayout+“”);          if (mIsLargeLayout ){              // The device is using a large layout, so show the fragment as a              // dialog              newFragment.show(fragmentManager, ”dialog”);          } else {              // The device is smaller, so show the fragment fullscreen              FragmentTransaction transaction = fragmentManager.beginTransaction();              // For a little polish, specify a transition animation              transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN);              // To make it fullscreen, use the ‘content’ root view as the              // container              // for the fragment, which is always the root view for the activity              transaction.replace(R.id.id_ly, newFragment).commit();          }      }

可以看到，我们通过读取R.bool.large_layout，然后根据得到的布尔值，如果是大屏幕则直接以对话框显示，如果是小屏幕则嵌入我们的Activity布局中；

这个 R.bool.large_layout是我们定义的资源文件：

在默认的values下新建一个bools.xml

     
         
    
     false
     
   

然后在res下新建一个values-large，在values-large下再新建一个bools.xml

     
         
    
     true
     
   

最后测试：

  

7、屏幕旋转

1、传统Dialog

传统的new AlertDialog当我们旋转屏幕后，Activity重新创建，整个Activity的界面没有问题，而对话框消失了，之前用户输入的数据也不会被保存下来；除此之外，其实还有一个问题，就是在logcat中会看到异常信息：Android..leaked .. window，这是因为在Activity结束之前，Android要求所有的Dialog必须要关闭。所以需要我们手动处理屏幕翻转的情况

public class MainActivity extends Activity {
       private Button clk;    private Dialog dialog;    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);        clk = (Button) findViewById(R.id.clk);        dialog = new Dialog(this);        dialog.setContentView(R.layout.dialog);        clk.setOnClickListener(new OnClickListener() {            @Override            public void onClick(View v) {                dialog.show();            }        });        //用户恢复对话框的状态        if(savedInstanceState != null && savedInstanceState.getBoolean("dialog_show"))            clk.performClick();    }    /**     * 用于保存对话框的状态以便恢复     */    @Override    protected void onSaveInstanceState(Bundle outState) {        super.onSaveInstanceState(outState);        if(dialog != null && dialog.isShowing())            outState.putBoolean("dialog_show", true);        else            outState.putBoolean("dialog_show", false);    }    /**     * 在Activity销毁之前，确保对话框以关闭     */    @Override    protected void onDestroy() {        super.onDestroy();        if(dialog != null && dialog.isShowing())            dialog.dismiss();    }}

2、DialogFragment

通过DialogFragment实现的对话框则可以完全不必考虑旋转的问题，FragmentManager 会自动管理 DialogFragment 的生命周期。

我们直接把上面登录使用AlertDialog创建的登录框，拷贝到MainActivity中直接调用：

public void showLoginDialogWithoutFragment(View view) {          AlertDialog.Builder builder = new AlertDialog.Builder(this);          // Get the layout inflater          LayoutInflater inflater = this.getLayoutInflater();          // Inflate and set the layout for the dialog          // Pass null as the parent view because its going in the dialog layout          builder.setView(inflater.inflate(R.layout.fragment_login_dialog, null))                  // Add action buttons                  .setPositiveButton(”Sign in”,new DialogInterface.OnClickListener(){                      @Override                      public void onClick(DialogInterface dialog, int id) {                          // sign in the user …                      }                   })                 .setNegativeButton(”Cancel”, null).show();      }

下面我分别点击两种方式创建的登录框，看效果图：

可以看到，传统的Dialog旋转屏幕时就消失了，且后台log会报异常~使用DialogFragment则不受影响。

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

// 设置宽度为屏宽、位置靠近屏幕底部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);

上面一段代码实现了底部菜单效果：

好了，关于DialogFragment的介绍结束~~

最后的最后给各位提个醒啊，之前在网上看到有人说当

屏幕处于关闭状态，依旧展示 DialogFragment 的话，可能会报错： Caused by: java.lang.IllegalStateException: Activity has been destroyed 所以最好判断下Activity的显示状态吧。

参考文档：

原文链接: