Android中使用DialogFragment编写对话框的实例教程

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> 

最后测试：

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

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之间的过多进行交叉调用，不利于程序的管控。