Android 官方推荐 : DialogFragment 创建对话框

桃扇骨 2022-08-03 00:57 165阅读 0赞

分类：  [【android 进阶之路】][android]   [【Android 源码解析】][Android]

2014-07-15 17:17  32375人阅读  [评论][Link 1](35)  收藏  [举报][Link 2]

[Android][Android 1] [DialogFragment][]

目录[(?)][Link 3][\[+\]][Link 3]

转载请标明出处：[http://blog.csdn.net/lmj623565791/article/details/37815413][http_blog.csdn.net_lmj623565791_article_details_37815413]

###### 1、 概述 ######

DialogFragment在android 3.0时被引入。是一种特殊的Fragment，用于在Activity的内容之上展示一个模态的对话框。典型的用于：展示警告框，输入框，确认框等等。  
在DialogFragment产生之前，我们创建对话框：一般采用AlertDialog和Dialog。注：官方不推荐直接使用Dialog创建对话框。

###### 2、 好处与用法 ######

使用DialogFragment来管理对话框，当旋转屏幕和按下后退键时可以更好的管理其声明周期，它和Fragment有着基本一致的声明周期。且DialogFragment也允许开发者把Dialog作为内嵌的组件进行重用，类似Fragment（可以在大屏幕和小屏幕显示出不同的效果）。上面会通过例子展示这些好处~

使用DialogFragment至少需要实现onCreateView或者onCreateDIalog方法。onCreateView即使用定义的xml布局文件展示Dialog。onCreateDialog即利用AlertDialog或者Dialog创建出Dialog。

###### 3、 重写onCreateView创建Dialog ######

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

**\[html\]**  [view plain][Link 3] [copy][Link 3]

1.  **<?****xml** version="1.0" encoding="utf-8"**?>**  
2.  **<****RelativeLayout** xmlns:android="http://schemas.android.com/apk/res/android"  
3.      android:layout\_width="wrap\_content"  
4.      android:layout\_height="wrap\_content" **>**  
5.    
6.      **<****TextView**  
7.          android:id="@+id/id\_label\_your\_name"  
8.          android:layout\_width="wrap\_content"  
9.          android:layout\_height="32dp"  
10.         android:gravity="center\_vertical"  
11.         android:text="Your name:" **/>**  
12.   
13.     **<****EditText**  
14.         android:id="@+id/id\_txt\_your\_name"  
15.         android:layout\_width="match\_parent"  
16.         android:layout\_height="wrap\_content"  
17.         android:layout\_toRightOf="@id/id\_label\_your\_name"  
18.         android:imeOptions="actionDone"  
19.         android:inputType="text" **/>**  
20.   
21.     **<****Button**  
22.         android:id="@+id/id\_sure\_edit\_name"  
23.         android:layout\_width="wrap\_content"  
24.         android:layout\_height="wrap\_content"  
25.         android:layout\_alignParentRight="true"  
26.         android:layout\_below="@id/id\_txt\_your\_name"  
27.         android:text="ok" **/>**  
28.   
29. **</****RelativeLayout****>**

b)继承DialogFragment，重写onCreateView方法

**\[java\]**  [view plain][Link 3] [copy][Link 3]

1.  **package** com.example.zhy\_dialogfragment;  
2.    
3.  **import** android.app.DialogFragment;  
4.  **import** android.os.Bundle;  
5.  **import** android.view.LayoutInflater;  
6.  **import** android.view.View;  
7.  **import** android.view.ViewGroup;  
8.    
9.  **public** **class** EditNameDialogFragment **extends** DialogFragment  
10. \{  
11.   
12.   
13.     @Override  
14.     **public** View onCreateView(LayoutInflater inflater, ViewGroup container,  
15.             Bundle savedInstanceState)  
16.     \{  
17.         View view = inflater.inflate(R.layout.fragment\_edit\_name, container);  
18.         **return** view;  
19.     \}  
20.   
21. \}

c)测试运行：

Main方法中调用：

**\[java\]**  [view plain][Link 3] [copy][Link 3]

1.  **public** **void** showEditDialog(View view)  
2.      \{  
3.          EditNameDialogFragment editNameDialog = **new** EditNameDialogFragment();  
4.          editNameDialog.show(getFragmentManager(), "EditNameDialog");  
5.      \}

效果图：

![SouthEast][]

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

**\[java\]**  [view plain][Link 3] [copy][Link 3]

1.  **public** **class** EditNameDialogFragment **extends** DialogFragment  
2.  \{  
3.    
4.      @Override  
5.      **public** View onCreateView(LayoutInflater inflater, ViewGroup container,  
6.              Bundle savedInstanceState)  
7.      \{  
8.          getDialog().requestWindowFeature(Window.FEATURE\_NO\_TITLE);  
9.          View view = inflater.inflate(R.layout.fragment\_edit\_name, container);  
10.         **return** view;  
11.     \}  
12.   
13. \}

效果图：

![SouthEast 1][]

很完美的去掉了讨厌的标题。

###### 4、 重写onCreateDialog创建Dialog ######

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

a)布局文件

**\[html\]**  [view plain][Link 3] [copy][Link 3]

1.  **<?****xml** version="1.0" encoding="utf-8"**?>**  
2.  **<****LinearLayout** xmlns:android="http://schemas.android.com/apk/res/android"  
3.      android:layout\_width="wrap\_content"  
4.      android:layout\_height="wrap\_content"  
5.      android:orientation="vertical" **>**  
6.    
7.      **<****ImageView**  
8.          android:layout\_width="match\_parent"  
9.          android:layout\_height="64dp"  
10.         android:background="\#FFFFBB33"  
11.         android:contentDescription="@string/app\_name"  
12.         android:scaleType="center"  
13.         android:src="@drawable/title" **/>**  
14.   
15.     **<****EditText**  
16.         android:id="@+id/id\_txt\_username"  
17.         android:layout\_width="match\_parent"  
18.         android:layout\_height="wrap\_content"  
19.         android:layout\_marginBottom="4dp"  
20.         android:layout\_marginLeft="4dp"  
21.         android:layout\_marginRight="4dp"  
22.         android:layout\_marginTop="16dp"  
23.         android:hint="input username"  
24.         android:inputType="textEmailAddress" **/>**  
25.   
26.     **<****EditText**  
27.         android:id="@+id/id\_txt\_password"  
28.         android:layout\_width="match\_parent"  
29.         android:layout\_height="wrap\_content"  
30.         android:layout\_marginBottom="16dp"  
31.         android:layout\_marginLeft="4dp"  
32.         android:layout\_marginRight="4dp"  
33.         android:layout\_marginTop="4dp"  
34.         android:fontFamily="sans-serif"  
35.         android:hint="input password"  
36.         android:inputType="textPassword" **/>**  
37.   
38. **</****LinearLayout****>**

b)继承DialogFragment重写onCreateDialog方法

**\[java\]**  [view plain][Link 3] [copy][Link 3]

c)调用

**\[java\]**  [view plain][Link 3] [copy][Link 3]

1.  **public** **void** showLoginDialog(View view)  
2.      \{  
3.          LoginDialogFragment dialog = **new** LoginDialogFragment();  
4.          dialog.show(getFragmentManager(), "loginDialog");  
5.      \}

效果图：

![SouthEast 2][]

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

###### 5、传递数据给Activity ######

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

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

**\[java\]**  [view plain][Link 3] [copy][Link 3]

1.  **package** com.example.zhy\_dialogfragment;  
2.    
3.  **import** android.app.AlertDialog;  
4.  **import** android.app.Dialog;  
5.  **import** android.app.DialogFragment;  
6.  **import** android.content.DialogInterface;  
7.  **import** android.os.Bundle;  
8.  **import** android.view.LayoutInflater;  
9.  **import** android.view.View;  
10. **import** android.view.ViewGroup;  
11. **import** android.widget.EditText;  
12.   
13. **public** **class** LoginDialogFragment **extends** DialogFragment  
14. \{  
15.     **private** EditText mUsername;  
16.     **private** EditText mPassword;  
17.   
18.     **public** **interface** LoginInputListener  
19.     \{  
20.         **void** onLoginInputComplete(String username, String password);  
21.     \}  
22.       
23.     @Override  
24.     **public** Dialog onCreateDialog(Bundle savedInstanceState)  
25.     \{  
26.         AlertDialog.Builder builder = **new** AlertDialog.Builder(getActivity());  
27.         // Get the layout inflater  
28.         LayoutInflater inflater = getActivity().getLayoutInflater();  
29.         View view = inflater.inflate(R.layout.fragment\_login\_dialog, **null**);  
30.         mUsername = (EditText) view.findViewById(R.id.id\_txt\_username);  
31.         mPassword = (EditText) view.findViewById(R.id.id\_txt\_password);  
32.         // Inflate and set the layout for the dialog  
33.         // Pass null as the parent view because its going in the dialog layout  
34.         builder.setView(view)  
35.                 // Add action buttons  
36.                 .setPositiveButton("Sign in",  
37.                         **new** DialogInterface.OnClickListener()  
38.                         \{  
39.                             @Override  
40.                             **public** **void** onClick(DialogInterface dialog, **int** id)  
41.                             \{  
42.                                 LoginInputListener listener = (LoginInputListener) getActivity();  
43.                                 listener.onLoginInputComplete(mUsername  
44.                                         .getText().toString(), mPassword  
45.                                         .getText().toString());  
46.                             \}  
47.                         \}).setNegativeButton("Cancel", **null**);  
48.         **return** builder.create();  
49.     \}  
50. \}

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

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

**\[java\]**  [view plain][Link 3] [copy][Link 3]

1.  c)  MainActivity  
2.  **package** com.example.zhy\_dialogfragment;  
3.    
4.  **import** com.example.zhy\_dialogfragment.LoginDialogFragment.LoginInputListener;  
5.    
6.  **import** android.app.Activity;  
7.  **import** android.app.AlertDialog;  
8.  **import** android.content.DialogInterface;  
9.  **import** android.os.Bundle;  
10. **import** android.view.LayoutInflater;  
11. **import** android.view.View;  
12. **import** android.widget.Toast;  
13.   
14. **public** **class** MainActivity **extends** Activity **implements** LoginInputListener  
15. \{  
16.   
17.     @Override  
18.     **protected** **void** onCreate(Bundle savedInstanceState)  
19.     \{  
20.         **super**.onCreate(savedInstanceState);  
21.         setContentView(R.layout.activity\_main);  
22.     \}  
23.   
24.       
25.   
26.     **public** **void** showLoginDialog(View view)  
27.     \{  
28.         LoginDialogFragment dialog = **new** LoginDialogFragment();  
29.         dialog.show(getFragmentManager(), "loginDialog");  
30.   
31.     \}  
32.   
33.     @Override  
34.     **public** **void** onLoginInputComplete(String username, String password)  
35.     \{  
36.         Toast.makeText(**this**, "帐号：" + username + ",  密码 :" + password,  
37.                 Toast.LENGTH\_SHORT).show();  
38.     \}  
39.   
40. \}

效果：

![20140715164912727][]

###### 6、DialogFragment做屏幕适配 ######

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

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

**\[java\]**  [view plain][Link 3] [copy][Link 3]

1.  **public** **void** showDialogInDifferentScreen(View view)  
2.      \{  
3.          FragmentManager fragmentManager = getFragmentManager();  
4.          EditNameDialogFragment newFragment = **new** EditNameDialogFragment();  
5.    
6.          **boolean** mIsLargeLayout = getResources().getBoolean(R.bool.large\_layout) ;  
7.          Log.e("TAG", mIsLargeLayout+"");  
8.          **if** (mIsLargeLayout )  
9.          \{  
10.             // The device is using a large layout, so show the fragment as a  
11.             // dialog  
12.             newFragment.show(fragmentManager, "dialog");  
13.         \} **else**  
14.         \{  
15.             // The device is smaller, so show the fragment fullscreen  
16.             FragmentTransaction transaction = fragmentManager  
17.                     .beginTransaction();  
18.             // For a little polish, specify a transition animation  
19.             transaction  
20.                     .setTransition(FragmentTransaction.TRANSIT\_FRAGMENT\_OPEN);  
21.             // To make it fullscreen, use the 'content' root view as the  
22.             // container  
23.             // for the fragment, which is always the root view for the activity  
24.             transaction.replace(R.id.id\_ly, newFragment)  
25.                     .commit();  
26.         \}  
27.     \}

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

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

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

**\[html\]**  [view plain][Link 3] [copy][Link 3]

1.  **<?****xml** version="1.0" encoding="utf-8"**?>**  
2.  **<****resources****>**  
3.    
4.      **<****bool** name="large\_layout"**>**false**</****bool****>**  
5.    
6.  **</****resources****>**

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

**\[html\]**  [view plain][Link 3] [copy][Link 3]

1.  **<?****xml** version="1.0" encoding="utf-8"**?>**  
2.  **<****resources****>**  
3.    
4.      **<****bool** name="large\_layout"**>**true**</****bool****>**  
5.    
6.  **</****resources****>**

最后测试：

![SouthEast 3][]          ![SouthEast 4][]

左边为模拟器，右边为我的手机~~~~~

###### 7、屏幕旋转 ######

当用户输入帐号密码时，忽然旋转了一下屏幕，帐号密码不见了~~~是不是会抓狂

传统的new AlertDialog在屏幕旋转时，第一不会保存用户输入的值，第二还会报异常，因为Activity销毁前不允许对话框未关闭。而通过DialogFragment实现的对话框则可以完全不必考虑旋转的问题。

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

**\[java\]**  [view plain][Link 3] [copy][Link 3]

1.  **public** **void** showLoginDialogWithoutFragment(View view)  
2.      \{  
3.          AlertDialog.Builder builder = **new** AlertDialog.Builder(**this**);  
4.          // Get the layout inflater  
5.          LayoutInflater inflater = **this**.getLayoutInflater();  
6.    
7.          // Inflate and set the layout for the dialog  
8.          // Pass null as the parent view because its going in the dialog layout  
9.          builder.setView(inflater.inflate(R.layout.fragment\_login\_dialog, **null**))  
10.                 // Add action buttons  
11.                 .setPositiveButton("Sign in",  
12.                         **new** DialogInterface.OnClickListener()  
13.                         \{  
14.                             @Override  
15.                             **public** **void** onClick(DialogInterface dialog, **int** id)  
16.                             \{  
17.                                 // sign in the user ...  
18.                             \}  
19.                         \}).setNegativeButton("Cancel", **null**).show();  
20.     \}

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

![20140715171150390][]

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

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

有任何疑问请留言

[源码点击下载][Link 4]

参考文档：

http://developer.android.com/guide/topics/ui/dialogs.html\#DialogFragment

https://github.com/thecodepath/android\_guides/wiki/Using-DialogFragment

[android]: http://blog.csdn.net/lmj623565791/article/category/2210589
[Android]: http://blog.csdn.net/lmj623565791/article/category/2680605
[Link 1]: http://blog.csdn.net/lmj623565791/article/details/37815413#comments
[Link 2]: http://blog.csdn.net/lmj623565791/article/details/37815413#report
[Android 1]: http://www.csdn.net/tag/Android
[DialogFragment]: http://www.csdn.net/tag/DialogFragment
[Link 3]: http://blog.csdn.net/lmj623565791/article/details/37815413#
[http_blog.csdn.net_lmj623565791_article_details_37815413]: http://blog.csdn.net/lmj623565791/article/details/37815413
[SouthEast]: /images/20220731/06cd41d910114c57a3b36f4bd2a909e1.png
[SouthEast 1]: /images/20220731/8a26d02871374e97a5636889a21512b0.png
[SouthEast 2]: /images/20220731/ad8394ee2b14425baca6fe84017fcbc3.png
[20140715164912727]: /images/20220731/39294c312aac4a1cad45d3bf2ba5bafc.png
[SouthEast 3]: https://img-blog.csdn.net/20140715170053093?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvbG1qNjIzNTY1Nzkx/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[SouthEast 4]: /images/20220731/1f3bae9a7ee444e2b13dd5bcb3c4c995.png
[20140715171150390]: /images/20220731/f13867d1edaf4148bc83edc182cf63cc.png
[Link 4]: http://download.csdn.net/detail/lmj623565791/7638357