5、Adding a fragment without a UI
上面的例子是如何添加fragment到activity中以便提供一个UI。然而,你也可以利用fragment提供后台处理而不需要展现UI。
为了添加没有UI的fragment,可以利用add(Fragment,String)方法从activity添加一个fragment(提供一个唯一的字符串“tag”而不是一个视图ID)。这种方法添加了这个fragment但是由于没有跟activity布局的view关联,不需要接收对onCreateView()的调用,因此不需要实现该方法。
为fragment提供字符串tag的方式并不只适合于非UI Fragment,你也可以为有UI的fragment提供字符串tag,但如果没有UI,只有这一种方式来指定。如果想在activity中获取这个fragment,可以利用findFragmentByTag()方法。
以fragment作为后台处理者的例子可以参考FragmentRetainInstance.java。
6、Managing Fragments
为了在activity中管理fragments,你需要利用FragmentManager。从activity中调用getFragmentManager()方法获取。利用FragmentManager可以做以下事情:
- 获取已经在activity中存在的fragments,利用findFragmentById()来获取在activity布局中提供一个UI的fragments,利用findFragmentByTag()来获取不提供UI的fragments。
- 利用popBackStack()方法从回栈中弹出fragments
- 利用addOnBackStackChangeListener()方法为回栈的变化注册一个监听 器
要查看这些方法更详细的信息,可以查看FragmentManager的文档。除了上面提到的,还有通过FragmentManager开启一个FragmentTransaction,用于执行像add和remove的事务。
7、Performing Fragment Transactions
在activity中使用fragments的最大特性是能够add、remove、replace以及执行与之有关的操作,响应用户的交互。提交到activity的每个变化集称为事务,可以利用FragmentTransaction的API来执行事务。你也可以保存每个事务到由activity管理的回栈中,可以通过fragments的改变来导航回上一个fragment。
可以像下面这样从FragmentManager获取FragmentTransaction的实例:
FragmentManager fragmentManager = getFragmentManager();
FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
每个事务是你想在同一时间执行的变化集。你可以通过add()、remove()和replace()方法为给定的事务设置所有的变化,然后应用这个事务到activity,记住,必须调用commit();
然而,在你调用commit()之前,你可能会调用addToBackStack()方法,以便添加该事务到fragment事务的回栈中,这个回栈由activity管理并且允许用户通过回退按钮回到上一个fragment状态。
例如:下面是你如果用一个fragment代替另一个,并且在回栈中保留上一个状态。
// Create new fragment and transaction
Fragment newFragment = newExampleFragment();
FragmentTransaction transaction = getFragmentManager().beginTransaction();
// Replace whatever is in the fragment_container view with this fragment,
// and add the transaction to the back stack
transaction.replace(R.id.fragment_container, newFragment);
transaction.addToBackStack(null);
// Commit the transaction
transaction.commit();
这个例子中,newFragment替换当前在布局容器中以R.id.fragment_container为ID的任何fragment。通过调用addToBackStack()方法,替换事务被保存到回栈中,因此用户可以通过回退按钮获取这个事务并回到上一个fragment。
如果你添加多个变化到事务中(例如add()或remove()然后调用addToBackStack()),这时,在调用commit()使所有变化都生效之前,这些变化作为一个单独的事务都被加入到回栈中,按回退按钮会使得所有的一起回退。
添加变化到FragmentTransaction中的顺序并不重要,除非:
- 必须最后调用commit()
- 如果你添加多个fragments到同一个容器,这时你添加到容器中的顺序决定了在视图中展示的顺序。
当执行remove一个fragment事务时没有调用addToBackStack()方法,那么当事务commit时这个fragment就会被销毁,所有用户不能再返回到这个fragment。如果当remove一个fragment时调用addToBackStack(),那么这个fragment会停止并且当用户回退时恢复该fragment。
提示:对于每个fragment事务,可以在commit之前调用setTransition()来应用一个事务动画。
调用commit()不会立即执行该事务。而是在activity的UI线程中调度执行,只要这个线程具备条件可以处理。如果必要,在执行commit()后,可以从UI线程中调用executePendingTransaction()方法立即执行该事务。这样做通常是没有必要的,除非这个事务依赖与其他线程工作。
注意:你只有在activity保存其状态之前调用commit()提交事务(当用户离开当前activity)。如果你试图在这个点后提交事务,就会报异常。这是因为如果需要恢复这个activity,提交之后的状态会被丢弃。这种情况下,可以利用commitAllowingStateLoss()方法丢弃提交。
8、Communicating with the Activity
一个Fragment可以作为独立于Activity的对象实现,并且可以在多个activity中使用,一个给定的fragment实例可以直接与包含它的activity建立联系。
具体来说,fragment可以通过getActivity()访问Activity实例,以及在activity布局中执行例如查找一个视图的任务。
View listView = getActivity().findViewById(R.id.list);
同样,你的activity可以在fragment里调用方法来从FragmentManager获取对fragment的引用,方法有findFragmentById()或findFragmentByTag()。例如:
ExampleFragment fragment = (ExampleFragment) getFragmentManager()
.findFragmentById(R.id.example_fragment);
9、Creating event callbacks to the activity
在一些情况下,你可能需要一个fragment来与activity共享事件。一个好的方法就是在fragment内部定义一个回调接口并且要求主activity实现它。当这个activity通过而过接口接收一个回调时,就可以与布局中的其他fragments共享信息。
例如:如果新闻应用程序在一个activity中有两个fragments,一个是显示文章的列表(fragment A)另一个是显示这篇文章(fragment B)。这时fragment A必须告诉activity什么时间列表项被选中以至于可以告诉fragment B显示这篇文章。这种情况下,OnArticleSelectedListener接口声明在fragment A中。
publicstatic class FragmentA extendsListFragment {
...
// Container Activity must implement this interface
publicinterface OnArticleSelectedListener {
publicvoid onArticleSelected(Uri articleUri);
}
...
}
这时,该fragment的主activity实现OnArticleSelectedListener接口并且覆盖onArticleSelected()方法来通知fragment B来自fragment A的事件。为了确保主activity实现这个接口,fragment A在onAttach()回调方法(当添加fragment到activity时由系统调用)中通过转换传入到onAttch()方法中的activity参数实例化一个OnArticleSelectedListener接口实例。
publicstatic class FragmentA extendsListFragment {
OnArticleSelectedListener mListener;
...
@Override
publicvoid onAttach(Activity activity) {
super.onAttach(activity);
try{
mListener = (OnArticleSelectedListener) activity;
}catch(ClassCastException e) {
thrownew ClassCastException(activity.toString()
+" must implement OnArticleSelectedListener");
}
}
...
}
如果activity没有实现这个接口,这时fragment抛出一个ClassCastException异常。一旦转换成功,mListener成员持有一个到activity的OnArticleSelectedListener接口实现的引用。因此fragment A可以通过调用定义在OnArticleSelectedListener接口中的回调方法来与activity共享事件。例如,如果fragment A是ListFragment的扩展,每次用户点击列表项时,系统调用fragment中的onListItemClick()方法,这里调用onArticleSelected()方法与activity共享事件。
publicstatic class FragmentA extendsListFragment {
OnArticleSelectedListener mListener;
...
@Override
publicvoid onListItemClick(ListView l, View v, intposition, longid) {
// Append the clicked item's row ID with the content provider Uri
Uri noteUri = ContentUris.withAppendedId(ArticleColumns.CONTENT_URI, id);
// Send the event and Uri to the host activity
mListener.onArticleSelected(noteUri);
}
...
}
传递到onListItemClick()中的id参数时点击项的行ID,activity利用这个ID来从应用程序的ContentProvider中获取这篇文章。
10、Adding items to the Action Bar
你的fragments可以为activity的Options Menu添加菜单项,通过实现onCreateOptionsMenu()方法。为了保证这个方法被调用,你必须在onCreate()中调用setHasOptionMenu()方法,以标识该fragment支持将菜单项添加到Options Menu中(否则 fragment不会接收onCreateOptionsMenu()的调用)。
从fragment中添加到Options Menu的任何项都是附加到一个已存在的菜单项中。当菜单项被选中时,这个fragment也能接收onOptionsItemSelected()回调方法。
你也可以在fragment布局中注册一个view来提供上下文菜单,通过调用registerForContextMenu()方法。当用户开启上下文菜单时,fragment接收onCreateContextMenu()方法的调用。当用户选择上下文菜单中的一项,fragment接收到onContextItemSelected()方法的调用。
注意:虽然你的fragment接收每个菜单项的on-item-selected调用,当用户选择一项时,activity首先接收这个调用。如果activity对on-item-selected的实现不能处理这个选择项,这时这个事件就被传递到fragments的回调中。这个在Options Menu和上下文meuns中都是对的。
11、Handling the Fragment Lifecycle
对fragment的生命周期管理有点像activity的生命周期管理,一个fragment可以三种状态存在。
- Resumed: fragment在运行的activity中可见。
- Paused:另一个activity在前台并获有焦点,但是fragment所在的activity仍然可见(前台的activity部分透明或不能完全覆盖整个屏幕)。
- Stopped: fragment不可见。主activity已经停止或是fragment已经从activity中移除放到回栈里。一个停止的fragment仍然活着的(所有的状态和成员信息由系统保留),然而,不再对用户可见并且当activity销毁时被销毁。
如下图所示:
跟activity类似,当activity的进程并杀掉时,你可以利用一个Bundle来保留fragment的状态,并且当activity重建时来恢复fragment的状态。你可以在fragment的onSaveInstanceState()回调方法中保存状态,在onCreate()、onCreateView()或onActivityCreated()中恢复状态。
在activity与fragment之间生命周期最显著的区别是如何在各自的回栈中存储。一个activity当停止时默认被放置在有系统管理的activity的回栈中。然而,一个fragment在执行remove一个fragment事务时,显式调用addToBackStack()方法来保存该实例时别存储在由主activity管理的回栈中。
由于管理fragment的生命周期与管理activity生命周期非常相像,因此管理activity生命周期的实践同样适用于fragment,另外,你需要理解的是,activity的生命周期是如何影响fragment的生命周期的。
12、Coordinating with the activity lifecycle
fragment所在activity的生命周期直接影响该fragment的生命周期。使得activity的每个生命周期回调结果在每个fragment的类似回调中。例如,当activity接收onPause(),activity中的每个fragment也接收onPause().
fragments还有一些额外的生命周期回调函数。然而,这些将处理与activity唯一的交互,为了执行例如构建和销毁fragment的UI操作。这些额外的回调方法有:
onAttach():当fragment已经与activity建立关联时调用。
onCreateView():创建一个新的view层级来与fragment关联。
onActivityCreated():当activity的onCreate()方法已经返回时调用。
onDestroyView():当与fragment关联的view层级被移除时调用。
onDetach():当fragment与activity脱离关联时调用。
被主activity影响的fragment生命周期流在上图中展示了,在这个图中,你可以看到activity的每个连续状态决定了fragment接收那个回调方法。例如,当activity接收了onCreate()回调,activity中的一个fragment只能接收onActivityCreate()回调。
一旦activity到达了resumed状态,你可以自由的在activity中添加和移除fragment。这样,只有当activity在resumed状态时,fragment的生命周期才能独立的改变。
然而,当activity离开resumed状态时,fragment再一次通过生命周期被activity拽回。
13、Example
为了在本章能够谈论更多东西,下面的activity的例子展示利用两个fragment创建两个面板的布局。一个fragment用于展示Shakespeare播放标题的列表,另一个展示每个播放的概要当选中一项时。并且也描述了如何基于屏幕的配置提供不同的fragment的配置。
这个主activity在onCreate()中以通用的方式应用一个布局。
@Override
protectedvoid onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.fragment_layout);
}
利用这个布局,只要activity加载完这个布局文件系统就会实例化TitlesFragment(用于显示播放标题列表),而FrameLayout(fragment在此显示播放概要)将占用屏幕的右侧空间,但开始的时候为空。正如在下面所示,直到用户从列表中选择一项,fragment才被填充到FrameLayout中。
然而,并不是所有的屏幕配置都足够宽来同时并排显示播放列表和概要。因此上面的布局只能用于宽屏配置,通过在res/layout-land/fragment_layout.xml中保存。
这样,当屏幕在纵向方向时,系统应用保存在res/layout/fragment_layout.xml的布局。
<FrameLayoutxmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"android:layout_height="match_parent">
<fragment
android:id="@+id/titles"
android:layout_width="match_parent"android:layout_height="match_parent"/>
</FrameLayout>
这个布局只包含TitlesFragment,这就意味着当设备在纵向方向时,只有播放列表可见。因此当用户在这个配置下点击列表项时,应用程序会启动一个新的activity用于显示概要,而不是加载第二个fragment。
接下来,分析如何在fragment类中完成这些工作。首先是TitlesFragment,用于显示播放标题列表。这个fragment扩展了ListFragment并通过它处理大部分列表视图工作。
当你检查这个代码,当用户点击列表项时有两种可能的行为,这取决于两个布局中哪个处于活动状态,他可以在同一个activity中创建并展示一个新的fragment用于显示详细信息(添加fragment到FrameLayout)或者启动一个新的activity(fragment可以在此显示)。
publicstatic class TitlesFragment extendsListFragment {
booleanmDualPane;
intmCurCheckPosition = 0;
@Override
publicvoid onActivityCreated(Bundle savedInstanceState) {
super.onActivityCreated(savedInstanceState);
// Populate list with our static array of titles.
setListAdapter(newArrayAdapter(getActivity(),
android.R.layout.simple_list_item_activated_1, Shakespeare.TITLES));
// Check to see if we have a frame in which to embed the details
// fragment directly in the containing UI.
View detailsFrame = getActivity().findViewById(R.id.details);
mDualPane = detailsFrame != null&& detailsFrame.getVisibility() == View.VISIBLE;
if(savedInstanceState != null) {
// Restore last state for checked position.
mCurCheckPosition = savedInstanceState.getInt("curChoice",0);
}
if(mDualPane) {
// In dual-pane mode, the list view highlights the selected item.
getListView().setChoiceMode(ListView.CHOICE_MODE_SINGLE);
// Make sure our UI is in the correct state.
showDetails(mCurCheckPosition);
}
}
@Override
publicvoid onSaveInstanceState(Bundle outState) {
super.onSaveInstanceState(outState);
outState.putInt("curChoice", mCurCheckPosition);
}
@Override
publicvoid onListItemClick(ListView l, View v, intposition, longid) {
showDetails(position);
}
/**
* Helper function to show the details of a selected item, either by
* displaying a fragment in-place in the current UI, or starting a
* whole new activity in which it is displayed.
*/
voidshowDetails(intindex) {
mCurCheckPosition = index;
if(mDualPane) {
// We can display everything in-place with fragments, so update
// the list to highlight the selected item and show the data.
getListView().setItemChecked(index,true);
// Check what fragment is currently shown, replace if needed.
DetailsFragment details = (DetailsFragment)
getFragmentManager().findFragmentById(R.id.details);
if(details == null|| details.getShownIndex() != index) {
// Make new fragment to show this selection.
details = DetailsFragment.newInstance(index);
// Execute a transaction, replacing any existing fragment
// with this one inside the frame.
FragmentTransaction ft = getFragmentManager().beginTransaction();
ft.replace(R.id.details, details);
ft.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE);
ft.commit();
}
}else{
// Otherwise we need to launch a new activity to display
// the dialog fragment with selected text.
Intent intent = newIntent();
intent.setClass(getActivity(), DetailsActivity.class);
intent.putExtra("index", index);
startActivity(intent);
}
}
}
第二个fragment,DetailsFragment显示从TitlesFragment列表中选择项的播放概要。
publicstatic class DetailsFragment extendsFragment {
/**
* Create a new instance of DetailsFragment, initialized to
* show the text at 'index'.
*/
publicstatic DetailsFragment newInstance(intindex) {
DetailsFragment f = newDetailsFragment();
// Supply index input as an argument.
Bundle args = newBundle();
args.putInt("index", index);
f.setArguments(args);
returnf;
}
publicint getShownIndex() {
returngetArguments().getInt("index",0);
}
@Override
publicView onCreateView(LayoutInflater inflater, ViewGroup container,
Bundle savedInstanceState) {
if(container == null) {
// We have different layouts, and in one of them this
// fragment's containing frame doesn't exist. The fragment
// may still be created from its saved state, but there is
// no reason to try to create its view hierarchy because it
// won't be displayed. Note this is not needed -- we could
// just run the code below, where we would create and return
// the view hierarchy; it would just never be used.
returnnull;
}
ScrollView scroller = newScrollView(getActivity());
TextView text = newTextView(getActivity());
intpadding = (int)TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP,
4, getActivity().getResources().getDisplayMetrics());
text.setPadding(padding, padding, padding, padding);
scroller.addView(text);
text.setText(Shakespeare.DIALOGUE[getShownIndex()]);
returnscroller;
}
}
回想TitleFragment类,如果用户点击列表项并且当前布局不包含R.id.detail视图(包含DetailsFragment),这时应用程序启动DetailsActivity来显示列表项的内容。
下面是DetatilsActivity,简单的嵌入到DetailsFragment中当屏幕为纵向方向时显示选择的播放概要。
publicstatic class DetailsActivity extendsActivity {
@Override
protectedvoid onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
if(getResources().getConfiguration().orientation
== Configuration.ORIENTATION_LANDSCAPE) {
// If the screen is now in landscape mode, we can show the
// dialog in-line with the list so we don't need this activity.
finish();
return;
}
if(savedInstanceState == null) {
// During initial setup, plug in the details fragment.
DetailsFragment details = newDetailsFragment();
details.setArguments(getIntent().getExtras());
getFragmentManager().beginTransaction()
.add(android.R.id.content, details).commit();
}
}
}
注意:如果屏幕配置时宽屏的该activity会自己结束,因此主activity可以接管并显示DetailsFragment,伴随着TitlesFragment。这可能发生在,当用户在纵向方向时启动DetailsActivity时,然后在旋转到宽屏(这会重启动当前的activity)。