Android中使用DialogFragment編寫對話方塊的執行個體教程_Android

Android提供alert、prompt、pick-list，單選、多選，progress、time-picker和date-picker對話方塊，並提供自訂的dialog。在Android 3.0後，dialog基於fragment，並對之前版本提供相容支援庫，也就是說對於開發人員而言，dialog是基於DialogFragment的，但此時需要在應用中加入相關的相容庫。
和Windows或者網頁JS的Dialog不同，Android的dialog是非同步，而不是同步的。對於同步的dialog，顯示dialog後，下一行代碼會等到dialog結束，即下一行代碼可以知道dialog的輸入以及使用者點擊的button。而對於非同步dialog，dialog顯示後，下一行代碼繼續執行，而不是等dialog消失，通過callback來處理dialog的事件。非同步dialog也意味著應用的代碼也可以關閉dialog。

使用DialogFragment來管理對話方塊，當旋轉螢幕和按下後退鍵時可以更好的管理其聲明周期，它和Fragment有著基本一致的聲明周期。且DialogFragment也允許開發人員把Dialog作為內嵌的組件進行重用，類似Fragment（可以在大螢幕和小螢幕顯示出不同的效果）。上面會通過例子展示這些好處~
使用DialogFragment至少需要實現onCreateView或者onCreateDIalog方法。onCreateView即使用定義的xml布局檔案展示Dialog。onCreateDialog即利用AlertDialog或者Dialog建立出Dialog。

下面我們就來看一個使用DialogFragment編寫對話方塊的例子：
1.重寫onCreateView建立Dialog
a)布局檔案，我們建立一個設定名稱的布局檔案：

<?xml version="1.0" encoding="utf-8"?> <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"   android:layout_width="wrap_content"   android:layout_height="wrap_content" >    <TextView     android:id="@+id/id_label_your_name"     android:layout_width="wrap_content"     android:layout_height="32dp"     android:gravity="center_vertical"     android:text="Your name:" />    <EditText     android:id="@+id/id_txt_your_name"     android:layout_width="match_parent"     android:layout_height="wrap_content"     android:layout_toRightOf="@id/id_label_your_name"     android:imeOptions="actionDone"     android:inputType="text" />    <Button     android:id="@+id/id_sure_edit_name"     android:layout_width="wrap_content"     android:layout_height="wrap_content"     android:layout_alignParentRight="true"     android:layout_below="@id/id_txt_your_name"     android:text="ok" />  </RelativeLayout> 

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;   }  } 

效果圖：

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

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

<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"   android:layout_width="wrap_content"   android:layout_height="wrap_content"   android:orientation="vertical" >    <ImageView     android:layout_width="match_parent"     android:layout_height="64dp"     android:background="#FFFFBB33"     android:contentDescription="@string/app_name"     android:scaleType="center"     android:src="@drawable/title" />    <EditText     android:id="@+id/id_txt_username"     android:layout_width="match_parent"     android:layout_height="wrap_content"     android:layout_marginBottom="4dp"     android:layout_marginLeft="4dp"     android:layout_marginRight="4dp"     android:layout_marginTop="16dp"     android:hint="input username"     android:inputType="textEmailAddress" />    <EditText     android:id="@+id/id_txt_password"     android:layout_width="match_parent"     android:layout_height="wrap_content"     android:layout_marginBottom="16dp"     android:layout_marginLeft="4dp"     android:layout_marginRight="4dp"     android:layout_marginTop="4dp"     android:fontFamily="sans-serif"     android:hint="input password"     android:inputType="textPassword" />  </LinearLayout> 

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);     return builder.create();   } } 

c)調用

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

效果圖：

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

3.傳遞資料給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();   }  } 

效果：

4.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

<?xml version="1.0" encoding="utf-8"?> <resources>    <bool name="large_layout">false</bool>  </resources> 

然後在res下建立一個values-large，在values-large下再建立一個bools.xml

<?xml version="1.0" encoding="utf-8"?> <resources>    <bool name="large_layout">true</bool>  </resources> 

最後測試：

左邊為模擬器，右邊為My Phone~~~~~

5.旋轉螢幕
當使用者輸入帳號密碼時，忽然旋轉了一下螢幕，帳號密碼不見了~~~是不是會抓狂
傳統的new AlertDialog在旋轉螢幕時，第一不會儲存使用者輸入的值，第二還會報異常，因為Activity銷毀前不允許對話方塊未關閉。而通過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則不受影響。

PS：再談fragment管理器
通過fragment管理器或者fragment transaction，我們可以對dialog fragment進行具體地控制。show()就是在管理器中加入fragment，dismiss()就是從管理器中去掉fragment。我們不能先進行add()，然後在進行show()，因此一個fragment對象只能加入管理器一次。如果fragment被dismiss()，將從管理器中刪除，我們不能再通過管理器擷取該fragment的資訊。因此，如果我們想保留被dismiss的dialog的一些狀態或資訊，需要在dialog外進行儲存，例如利用activity。
總結：
編程思想：封裝介面
在小例子中，fragment會調用activity的onDialogDone()來顯示Toast等資訊。在真正項目中，fragment的編寫並不需要瞭解activity的各類方法，好的編程風格是將fragment所涉及的方法以介面的方式封裝起來，如下：

public interface OnMyDialogClickListener {   public void onDialogDone(String tag, boolean cancelled, CharSequence message);}

在activity中，增加介面的實現，如下：

public class MainActivity extends Activity implements OnMyDialogClickListener{  ......     public void onDialogDone(String tag, boolean cancelled, CharSequence message) {    String s = tag + " responds with: " + message;    if(cancelled)       s = tag + " was cancelled by the user";     Toast.makeText(this, s, Toast.LENGTH_LONG).show();     showInfo(s);   } }

相應地，在fragment中，對該方法的調用，可以寫為：

OnMyDialogClickListener act = (OnMyDialogClickListener)getActivity(); act.onDialogDone(……); 

對於一些大型項目，如果我們無法確定activity是否真的實現了介面，可以在fragment的早期，即剛關聯activity的階段進行檢測，如下：

@Override public void onAttach(Activity activity) {   //onAttach()是合適的早期階段進行檢查MyActivity是否真的實現了介面。  //採用介面的方式，dialog無需詳細瞭解MyActivity，只需瞭解其所需的介面函數，這是真正項目中應採用的方式。   try{     OnMyDialogClickListener act = (OnMyDialogClickListener)activity;   }catch(ClassCastException e){    …... activity並不真正支援介面的異常處理......   }   super.onAttach(activity); } 

fragment和activity以其他fragment之間的通訊：
小例子示範了通過getActivity()擷取介面對象或者直接擷取activity的對象，實現兩者之間的通訊。此外fragment也可以通過fragment管理器，通過tag，擷取其他fragment執行個體，從而進行fragment之間的通訊。當然從編程思想的角度看，fragment之間的過多進行交叉調用，不利於程式的管控。