DialogFragment是Android3.0后引入的Fragment框架中的对传统Dialog效果用Fragment做的实现。android-support-v4兼容包中也包含了该类,所以我们可以通过导入兼容包在3.0之前的平台上使用它。Android开发文档上已经不推荐传统的Dialog使用了,而是用DialogFragment来代替。
下面开始照着Android的开发文档来说说DialogFragment的使用。
首先,要创建的Dialogfragment的布局文件fragment_edit_name:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/edit_name"
android:layout_width="wrap_content" android:layout_height="wrap_content"
android:layout_gravity="center" android:orientation="vertical" >
<TextView
android:id="@+id/lbl_your_name" android:text="Your name"
android:layout_width="wrap_content" android:layout_height="wrap_content" />
<EditText
android:id="@+id/txt_your_name"
android:layout_width="match_parent" android:layout_height="wrap_content"
android:inputType=”text”
android:imeOptions="actionDone" />
</LinearLayout>
很简单的一个布局文件,标签+输入框,输入框inputType设置成text,imeOptions="actionDone"会将弹出的键盘上的enter按钮显示为完成(或Done)。
继承DialogFragment,创建EditNameDialog:
import android.support.v4.app.DialogFragment;
// ...
public class EditNameDialog extends DialogFragment {
private EditText mEditText;
public EditNameDialog() {
// Empty constructor required for DialogFragment
}
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,
Bundle savedInstanceState) {
View view = inflater.inflate(R.layout.fragment_edit_name, container);
mEditText = (EditText) view.findViewById(R.id.txt_your_name);
getDialog().setTitle("Hello");
return view;
}
}
代码理解应该没什么问题,跟自定义Fragment的方法一样,实现onCreateView方法设置要显示的视图。
在Activity中显示EditNameDialog:
import android.support.v4.app.FragmentActivity;
import android.support.v4.app.FragmentManager;
// ...
public class FragmentDialogDemo extends FragmentActivity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
showEditDialog();
}
private void showEditDialog() {
FragmentManager fm = getSupportFragmentManager();
EditNameDialog editNameDialog = new EditNameDialog();
editNameDialog.show(fm, "fragment_edit_name");
}
}
showEditDialog方法就是展示Dialog,DialogFragment的显示方法和平常我们写的展示Fragment还有点不一样,一般自定义Fragment,用FragmentManager.beginTransaction得到一个Transaction,然后调用相应Transaction中做显示操作的方法(show,replace,attach、add),然后Transaction.commit(),展示Fragment。而上面的EditNameDialog则是用从DialogFragment继承下来的show方法,参数传入FragmentManager和Tag,这样来展示的。这里要注意一下。另外,默认情况下,回退键用来取消该dialog。
让EditNameDialog与Activity通信,先看代码:
import android.support.v4.app.DialogFragment;
// ...
public class EditNameDialog extends DialogFragment implements OnEditorActionListener {
public interface EditNameDialogListener {
void onFinishEditDialog(String inputText);
}
private EditText mEditText;
public EditNameDialog() {
// Empty constructor required for DialogFragment
}
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container,
Bundle savedInstanceState) {
View view = inflater.inflate(R.layout.fragment_edit_name, container);
mEditText = (EditText) view.findViewById(R.id.txt_your_name);
getDialog().setTitle("Hello");
mEditText.requestFocus(); // EditText获得焦点
getDialog().getWindow().setSoftInputMode(
LayoutParams.SOFT_INPUT_STATE_VISIBLE); // 显示软键盘
mEditText.setOnEditorActionListener(this); // 设置Action监听器
return view;
}
@Override
public boolean onEditorAction(TextView v, int actionId, KeyEvent event) {
if (EditorInfo.IME_ACTION_DONE == actionId) {
// Return input text to activity
EditNameDialogListener activity = (EditNameDialogListener) getActivity();
activity.onFinishEditDialog(mEditText.getText().toString());
this.dismiss();
return true;
}
return false;
}
}
记得在定义EditNameDialog的布局的时候,给EditText设置了弹出键盘的enter显示为Done,代码中EditNameDialog实现OnEditorActionListener,设置给EdiText,这个接口就是用来监听EditText的imeOptions所指定的动作事件的。实现接口方法onEditorAction,判断actionId若为EditorInfo.IME_ACTION_DONE,则取得所在Activity实现的EditNameDIalogListener接口,调用接口的onFinishEditDialog方法,将输入筐的内容传回给Activity做处理,最后取消Dialog。
EditNameDIalogListener接口在EditNameDialog中定义,展示EditNameDialog的Activity需要实现它这个接口,从而接收EditNameDialog传回的数据,实现通信。
注意一下RequestFocus的用法,这里是在代码里调用,也可以在xml文件中,给EditText加上<requestFocus/>,效果是一样的。然而,有些时候最好还是在代码中调用。例如,若在xml中设置了<requestFocus/>,当在Fragment的onCreateView方法给View添加了onFocusChangeListener监听器,那么接口的实现方法不会被调用。
最后补上实现了EditNameDialogListener的Activity代码:
import android.support.v4.app.FragmentActivity;
import android.support.v4.app.FragmentManager;
// ...
public class FragmentDialogDemo extends FragmentActivity implements EditNameDialogListener {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
showEditDialog();
}
private void showEditDialog() {
FragmentManager fm = getSupportFragmentManager();
EditNameDialog editNameDialog = new EditNameDialog();
editNameDialog.show(fm, "fragment_edit_name");
}
@Override
public void onFinishEditDialog(String inputText) {
Toast.makeText(this, "Hi, " + inputText, Toast.LENGTH_SHORT).show();
}
}
更多关于DialogFragment的使用方法请参考官方的Android文档…