Android 官方推薦 : DialogFragment 建立對話方塊

yangxi_001發表於2014-09-23
AndroidFragment

轉載請標明出處：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 plaincopy
  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 plaincopy
  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 plaincopy
  1. public void showEditDialog(View view)  
  2.     {  
  3.         EditNameDialogFragment editNameDialog = new EditNameDialogFragment();  
  4.         editNameDialog.show(getFragmentManager(), "EditNameDialog");  
  5.     }  
效果圖：

可以看到，對話方塊成功建立並顯示出來，不過預設對話方塊有個討厭的標題，我們怎麼去掉呢：可以在onCreateView中呼叫getDialog().requestWindowFeature(Window.FEATURE_NO_TITLE);即可去掉。即：
[java] view plaincopy
  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. }  

效果圖：

很完美的去掉了討厭的標題。

4、 重寫onCreateDialog建立Dialog
在onCreateDialog中一般可以使用AlertDialog或者Dialog建立對話方塊，不過既然google不推薦直接使用Dialog，我們就使用AlertDialog來建立一個登入的對話方塊。

a)佈局檔案

[html] view plaincopy
  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 plaincopy
  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.   
  16.     @Override  
  17.     public Dialog onCreateDialog(Bundle savedInstanceState)  
  18.     {  
  19.         AlertDialog.Builder builder = new AlertDialog.Builder(getActivity());  
  20.         // Get the layout inflater  
  21.         LayoutInflater inflater = getActivity().getLayoutInflater();  
  22.         View view = inflater.inflate(R.layout.fragment_login_dialog, null);  
  23.         // Inflate and set the layout for the dialog  
  24.         // Pass null as the parent view because its going in the dialog layout  
  25.         builder.setView(view)  
  26.                 // Add action buttons  
  27.                 .setPositiveButton("Sign in",  
  28.                         new DialogInterface.OnClickListener()  
  29.                         {  
  30.                             @Override  
  31.                             public void onClick(DialogInterface dialog, int id)  
  32.                             {  
  33.                             }  
  34.                         }).setNegativeButton("Cancel", null);  
  35.         return builder.create();  
  36.     }  
  37. }  

c)呼叫

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

效果圖：


可以看到通過重寫onCreateDialog同樣可以實現建立對話方塊，效果還是很nice的。

5、傳遞資料給Activity

從dialog傳遞資料給Activity，可以使用“fragment interface pattern”的方式，下面通過一個改造上面的登入框來展示這種模式。

改動比較小，直接貼程式碼了：

[java] view plaincopy
  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 plaincopy
  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. }  

效果：


6、DialogFragment做螢幕適配

我們希望，一個對話方塊在大螢幕上以對話方塊的形式展示，而小螢幕上則直接嵌入當前的Actvity中。這種效果的對話方塊，只能通過重寫onCreateView實現。下面我們利用上面的EditNameDialogFragment來顯示。

EditNameDialogFragment我們已經編寫好了，直接在MainActivity中寫呼叫

[java] view plaincopy
  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 plaincopy
  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 plaincopy
  1. <?xml version="1.0" encoding="utf-8"?>  
  2. <resources>  
  3.   
  4.     <bool name="large_layout">true</bool>  
  5.   
  6. </resources>  

最後測試：

          

左邊為模擬器，右邊為我的手機~~~~~

7、螢幕旋轉

當使用者輸入帳號密碼時，忽然旋轉了一下螢幕，帳號密碼不見了~~~是不是會抓狂

傳統的new AlertDialog在螢幕旋轉時，第一不會儲存使用者輸入的值，第二還會報異常，因為Activity銷燬前不允許對話方塊未關閉。而通過DialogFragment實現的對話方塊則可以完全不必考慮旋轉的問題。

我們直接把上面登入使用AlertDialog建立的登入框，拷貝到MainActivity中直接呼叫：

[java] view plaincopy
  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.     }  

下面我分別點選兩種方式建立的登入框，看效果圖：


可以看到，傳統的Dialog旋轉螢幕時就消失了，且後臺log會報異常~~~使用DialogFragment則不受影響。



好了，關於DialogFragment的介紹結束~~~~


有任何疑問請留言


原始碼點選下載


參考文件：

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

https://github.com/thecodepath/android_guides/wiki/Using-DialogFragment

相關文章