对话框 DialogFragment
对话框是提示用户作出决定或输入额外信息的小窗口。
对话框不会填充屏幕,通常用于需要用户采取行动才能继续执行的模式事件。
通常将 DialogFragment 用作对话框的容器,通过fragment实现dialog的好处是:
activity配置改变(例如转向)进行重构的情况下,fragment管理器能够自动重构,恢复原来的状态,无需人工干预,并且能够它能正确处理生命周期事件
创建
通过newInstance()创建实例,并返回
- 通过缺省构造函数创建对象
- 将传递的信息设置为fragment的参数
- 返回对象
public class MyDialogFragment extends DialogFragment {
public static MyDialogFragment newInstance(int num) {
MyDialogFragment f = new MyDialogFragment();
Bundle args = new Bundle();
args.putInt("num", num);
f.setArguments(args);
return f;
}
在onCreate
回调中可以设置对话框的style、theme等属性,恢复保存的数据等
setCancelable(boolean cancelable)
控制对话框是否可以取消
参数为true,点击dialog覆盖不到的activity的空白或按返回键,就取消,依次执行onCancel()和onDismiss()回调
如参数为false,则按空白处或返回键无反应
默认为true,可以取消
setStyle(int style, int theme)
设置dialog的显示风格
例如style为STYLE_NO_TITLE,将不显示title
theme为0,表示由系统选择合适的theme。
风格也可以在资源文件的styles.xml文件中自己设定,然后配置进来
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
if(savedInstanceState != null){
...
}
setCancelable(false);
int style = DialogFragment.STYLE_NO_TITLE;
int theme =android.R.style.Theme_Holo_Light_Dialog;
setStyle(style,theme);
}
...
}
通过onCreateView()设置UI和按键反馈
自定义对话框时通常重载Fragment的onCreateView(LayoutInflater, ViewGroup, Bundle)
,返回一个View,实现dialog的UI
- 通过inflate,根据layout XML定义,创建view
- 对view中的组件进行绑定、设置 (
findViewById
)
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
View v = inflater.inflate(R.layout.prompt_dialog, container,false);
TextView tv = (TextView)v.findViewById(R.id.prompt_message);
tv.setText(getPrompt());
Button dismissBtn = (Button)v.findViewById(R.id.button_dismiss);
dismissBtn.setOnClickListener(this);
Button saveBtn = (Button)v.findViewById(R.id.button_save);
saveBtn.setOnClickListener(this);
return v;
}
通过onCreateDialog()创建对话框UI
对于简单的对话框,可以通过AlterDialog.Builder直接创建对话框的UI,例如警告提醒,最后返回一个Dialog
@Override
public Dialog onCreateDialog(final Bundle savedInstanceState) {
AlertDialog.Builder b = new AlertDialog.Builder(getActivity())
.setTitle(R.string.select)
.setView(initView()) //setMessage(getMessage())
.setPositiveButton(android.R.string.ok, this) //设置回调函数
.setNegativeButton(android.R.string.cancel,this); //设置回调函数
.setNeutralButton(R.string.refresh, null);//中性按钮
builder.setPositiveButton(android.R.string.ok, mDialogClickListener);
builder.setNegativeButton(android.R.string.cancel, mDialogClickListener);
builder.setNeutralButton(R.string.refresh, null);
final Dialog dialog = builder.create();
dialog.setCancelable(true);
dialog.setCanceledOnTouchOutside(true);
return dialog;
}
set...Button()方法需要一个按钮标题(由字符串资源提供)和一个 DialogInterface.OnClickListener接口实现,用于定义用户按下该按钮时执行的操作。
调用 setView()将自定义布局放入对话框
final View rootView = getActivity().getLayoutInflater().inflate(R.layout.XXXXX, null);
显示和关闭对话框
显示有两个函数,两个方法内部都调用了 add()和commit()函数
- public void show(FragmentManager manager, String tag)
- public int show(FragmentTransaction transaction, String tag)
对于将fragment transaction作为参数的方式,在调用show()之前,可通过fragment transaction进行控制,如加入到back stack中
void showDialog() {
//清除已经存在的,同样的fragment
FragmentTransaction ft = getFragmentManager().beginTransaction();
Fragment prev = getFragmentManager().findFragmentByTag("dialog");
if (prev != null) {
ft.remove(prev);
}
ft.addToBackStack(null);
// Create and show the dialog.
DialogFragment newFragment = MyDialogFragment.newInstance();
newFragment.show(ft, "dialog");
}
关闭dismiss()
内部执行 FragmentTransaction的 remove()和commit() 并触发onDismiss()回调函数。如果back stack堆栈有该dialog,会将其弹出来
将事件传递回对话框的宿主
public class NoticeDialogFragment extends DialogFragment {
/* 创建对话框片段的Activity实现此接口,用来接收回调事件
* 每个方法传递DialogFragment,用来查询信息 */
public interface NoticeDialogListener {
public void onDialogPositiveClick(DialogFragment dialog);
public void onDialogNegativeClick(DialogFragment dialog);
}
// 接口实例来传递动作事件
NoticeDialogListener mListener;
// 方法来实例化NoticeDialogListener
@Override
public void onAttach(Activity activity) {
super.onAttach(activity);
// Verify that the host activity implements the callback interface
try {
// Instantiate the NoticeDialogListener so we can send events to the host
mListener = (NoticeDialogListener) activity;
} catch (ClassCastException e) {
// The activity doesn't implement the interface, throw exception
throw new ClassCastException(activity.toString()
+ " must implement NoticeDialogListener");
}
}
...
}
Reference
Android Developers:对话框
DialogFragment
DialogFragment详解