原文地址：http://developer.android.com/guide/components/fragments.html
Fragments
fragments 代表一种在activity用户界面的一种行为或者一个部分。你可以结合多个fragments在同一个activity去构建一个multi-pane 界面或者二次使用一个fragment在多个activity中。你可以将fragment作为一个activity模块化区域，这个区域有自己的生命周期，接受自身输入的事件以及你可以在activity运行时添加与删除fragment（某种程度上像是子activity，你也可以二次使用在不同的activity）.
fragment常常需要嵌入activity且fragment的生存周期直接被绑定的activity生命周期影响。 举个例子，当activity paused,所有在这个activity中的fragments也paused，且当一个activity destroyed，所有的fragments也destroyed.然而，当activity运行时（在resumed状态），你可以独立地操作每一个fragment,像是添加或者是删除他们。当你执行一个fragment transaction时，你同时可以将它添加进入由activity管理的back stack,每一个在activity中的back stack记录fragment transaction的发生。这个back stack允许用户使用back按钮reverse fragment的transation.
当你将一个fragment作为你activity layout的一部分添加时，它存在于位于activity view 子类中的ViewGroup且fragment会定义它自身的view layout.你可以将fragment插入你activity layout中,只要在activity layout中使用 元素声明，或者在你的app code中将fragment添加到已存在的ViewGroup.然而，fragment不必要成为activity layout的一部分，你也可以使用fragment而不使用它的UI作为不可见对象为activity 服务。
本篇文档描述如何建立自己app去使用fragments,包括当activity添加fragment进入back stat时如何维持自身的状态，如何与activity和其他fragments分享事件，与activity action bar协作(contribute to)等
Design Philosophy
Android 在 Android3.0中(API level 11)引入fragments，主要是为了支持更加动态与了灵活支持在大屏幕的上Ui设计,像是平板(tablets).因为一个平板屏幕比一个手机更大，拥有更多的空间结合与交换Ui组件。fragments 允许这样的设计，不需要你对view hierarchy进行复杂的操作。通过分割activity的layout嵌入到fragments,你可以在运行时改变activity的界面以及通过activity管理的back stack保存这些改变.
例如，一个新闻类的app可以使用一个fragment在左边展示文章的列表以及使用另一个fragment在右边展示文章－两个fragments同时出现在同一个activity中以及每一个fragment拥有自身一系列生命周期callback方法且处理自身输入时间。因此，不同于使用一个activity选择一个文章且另一个activity阅读文章，用户可以选择一个文章且阅读这篇文章在同一个activity中，像是figure 1中显示的layout。
你应该将每个fragment作为一个模块化、可复用的activity组件来设计。那是因为每一个fragment定义自身的layout以及自身相关与生命周期callbacks的行为，你可以将同一个fragment用于多个activity中，所以你的设计应该复用以及避免直接操作从一个fragment到另一个。这点异常重要因为一个模块化的fragment容许你可以改变fragment通过不同大小的屏幕。 当设计你的app时为了同时支持平板与手机，你可以复用你的fragments通过不同的layout 配置在可用的屏幕空间上优化用户体验。举例，在手机上，当同一个activity只能显示一个fragment时，分割fragments提供单pane Ui是十分有必要的。
Figure 1.样例：通过fragments定义两个Ui模块，在平板中，fragments结合在同一个activity中，而在手机中，被分离。
举个例子：仍然在新闻类app样例中，当运行在平板大小的设备时，app可以结合两个fragments在Activity A中。然而在手机大小的屏幕时，没有足够的空间同事显示两个fragments,所以Activity A包含一个fragment用于显示文章列表，以及当用户选择一篇文章的时候，它将启动Activity B,包含第二个fragment用于阅读文章。因此app通过不同的结合复用fragments同时支持平板以及手机。如Figure 所显示。
更多关于使用不同fragments结合方式设配不同屏幕配置的信息，可见教程Supporting Tablets and Handsets.
Create a Fragment
为了创建一个fragment,你必须构建一个Fragment的子类（或者一个已存在的fragment子类).Fragment类从code方面来看存在很多相似于Activity的地方。它存在callback 回调函数相似于activity, 像是onCreate(),onStart(),onPause()以及onStop().实际上，如果你将以存在的Android app转换使用fragments,你可以简单地将code从activity回调中移动到fragment中相对应的callback函数。
通常，你应该至少实现以下lifecycle方法：
onCreate() 当创建fragment时，系统调用这个函数。在你实现中，你应该初始化fragment基本的组件，这些组件将在fragment暂停、停止以及resumed时保留。
onCreateView() 当fragment第一次绘制自身的用户界面时，系统调用这个函数。为了绘制fragment的UI，你必须从这个函数中返回一个View，这个View是你的fragment布局的根。如果fragment不提供UI,你也可以返回一个null.
onPause() 当用户第一次有迹象离开这个fragment时，系统调用这个函数（这不表明fragment被销毁（destroyed））。在这里，你应该提交任何不依赖于当然用户会话（session）的持久化（persisted）更改（因为用户可能不返回该fragment）
大多数的app应该实现至少以上3个函数在任意一个fragment中，但是存在若干其他的callback函数，你需要用于处理不同阶段的fragment lifecycle.所有lifecycle的callback函数将会在关于Handle the Fragment Lifecycle中详细讨论。
存在一些Fragment子类可能是你想继承的，而不是Fragment类
DialogFragment 展现一个悬浮dialog.通过使用这个类创建一个dialog比使用在Activity类中的dialog helper函数创建dialog更加好的选择。因为你可以将fragment合并入由activity管理的fragments back stack,容许用户返回一个已消失的fragment
ListFragment 展现一个列表的items，通过使用adapter来管理（像是SimpleCursorAdapter）,像是ListActivity.它提供一些方法管理list view,像是onListItemClick()回调函数用于处理点击事件。
PreferenceFragment 通过list,展现Preference对象的层级,相似于PreferenActivity.当为app创建settings Activity时，特别有用。
Adding a user interface
fragment 通常被作为一个activity用户界面的一部分以及使用自身的布局补充对应的activity.
为了提供fragment布局，你必须实现onCreateView()回调函数，当fragment绘制自身布局时，Android系统将调用这个函数。你对这个函数的实现必须返回一个View作为fragment布局的root.
Note 如果你的fragment是ListFragment的子类，默认的实现将从onCreateView()中返回一个ListView(),所以你不需要实现它。
为了从onCreateView()中返回一个layout,你必须从定义在xml的layout资源实现（inflate）.为了帮助你实现，onCreateView()提供一个LayoutInflater对象。
举个例子，一个Fragment的子类从example_fragment.xml中加载一个布局：
java public static class ExampleFragment extends Fragment { @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { // Inflate the layout for this fragment return inflater.inflate(R.layout.example_fragment, container,false); } }
在onCreateView()中传递的container参数是父ViewGroup(从Activity中而来),fragment layout 将插入其中。savedInstanceState参数是一个Bundle,它提供相关于之前fragment实例的一些数据。如果这个fragment正在重新被唤起（resumed）(将在Handling the Fragment Lifecycle中讨论更加详细的恢复状态)
inflate()函数需要3个参数： * 你想要填充布局的资源id. * 被填充布局的父布局，它是一个ViewGroup。为了系统可以将parent view指定的布局parameters(container)作为被填充布局的root,传递container变得非常重要。 * 一个boolean值说明被填充布局是否在填充过程中附属到ViewGroup(第二个参数)。(在这个情况下，由于系统已经将被填充layout添加到container中，应当是false.传递true会创建一个多余的view group)
现在你已经明白如何创建一个含有layout的fragment.接下来，你需要将fragment添加到activity.
Adding a fragment to an activity
通常，一个fragment作为对应activity的部分Ui存在，通过view hierarchy作为activity一部分嵌入。存在2种方式，你可以将fragment添加到activity布局中:
在activity布局文件中声明fragment
xml <?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="horizontal" android:layout_width="match_parent" android:layout_height="match_parent"> <fragment android:name="com.example.news.ArticleListFragment" android:id="@+id/list" android:layout_weight="1" android:layout_width="0dp" android:layout_height="match_parent" /> <fragment android:name="com.example.news.ArticleReaderFragment" android:id="@+id/viewer" android:layout_weight="2" android:layout_width="0dp" android:layout_height="match_parent" /> </LinearLayout>
在中android:name属性指定Fragment类在layout中初始化。当系统创建这个activity布局时，将创建在layout中指定的每一个fragment以及调用每一个的onCreateView()函数去初始化fragments的布局。系统将fragment直接返回的view插入在元素中。
Note:每一个fragment需要独特唯一id,系统需要使用这个id恢复fragment如果activity被重新唤起(以及你可以使用id捕获这个fragment执行变换(transactions),像是删除它) 存在三种方式提供一个id给fragment
1. android:id属性提供
2. android:tag属性提供
3. 如果你没有使用前2种方法，系统将使用container view的id
或者在程序中添加fragment到一个已存在的ViewGroup
在你的activity运行的任意时刻，你可以添加fragment到activity布局中。你必须简单地指定一个ViewGroup添加fragment.
为了在activity使fragment变换(像是add、remove或者是replace a fragment),你必须使用FragmentTransaction的APIs.你可以在Activity中通过以下方式获取一个FragmentTransaction实例：
java FragmentManager fragmentManager = getFragmentManager() FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
你可以在这之后通过add()函数添加fragment,同时指定添加fragment到哪个view中。举个例子:
java ExampleFragment fragment = new ExampleFragment(); fragmentTransaction.add(R.id.fragment_container, fragment); fragmentTransaction.commit();
第一个传递给add()的参数是ViewGroup，fragment将会通过resoucre Id指定到添加这个ViewGroup中。第二个参数是将被添加的fragment.
一旦你使FragmentTransaction发生了改变，你必须调用commit()才能发生效果。
Adding a fragment without a UI
以上样例展示如何添加一个fragment到你的activity，其目的是提供UI.然而，你也可以使用fragment提供后台操作且没有附加的UI.
添加一个没有Ui的fragment,你可以在activity中使用add(Frament,String)的方式添加（提供一个独特的string tag, 而不是一个view Id).这样添加fragment,由于它没有关联activity layout中的view,它不会调用onCreateView().所以你不需要实现这个函数。
提供一个string tag给fragment并不是严格使用给non-UI fragments，你也可以提供一个string tags给存在UI的fragment。但是如果fragment没有存在UI，那么string tag是唯一的方式识别这个fragment.如果你想要之后在activity中获取fragment,你需要使用finfFragmentByTag().
activity使用没有UI的后台fragment，可见FragmentRetainInstance.java 样例.
Managing Fragments
为了在activity中管理fragments,你需要使用FragmentManager。在activity中，调用getFragmentManager()，你可以或者它。
你可以通过FragmentManager做以下的事情：
- 使用findFragmentById()获取存在在activity中的fragments(这些fragments在activity layout提供UI)或者是findFragmentByTag()
- popBackStack()，使在back stack中的fragments出栈（模拟用户的back操作）
- addOnBackStackChangedListener()，注册一个listener，监听back stack的变化
更多地信息关于这些函数以及其他的，详见FragmentManager class 文档。
就像以上展示的区域，你可以使用FragmentManager打开一个FragmentTransaction,通过这个FragmentTransaction允许执行变换，像是add以及remove fragments.
Performing Fragment Transactions
一个在activity中使用fragments的特别好功能是可以添加，删除，替换以及执行各种相关的actions来回应用户的操作。每一次的commit包含的一系列变化被成为一个变换(transaction)且你可以通过使用FragmentTransaction中的APIs来执行。你也可以保存每个transaction到由activity来管理的back stack操作，允许用户导航回退fragments的变化（相似于导航回退activities).
你需要从F ragmentManager中获取FragmentTransacation的实例：
java FragmentManager fragmentManager = getFragmentManager(); FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();
每一个transaction是一系列你想同时执行的改变。你可以通过使用接口像是add(),remove()以及replace()等方法来，建立你想执行的改变。之后，你必须要调用commit()来申请对于activity的transaction.
在你调用commit()之前，然而，你可能想要调用addToBackStack(),为了将transaction添加到fragment transactions的back stack.这个back stack由activity来管理，允许用户通过Back按钮返回之前的fragment状态。
举个例子：这里展示如何替换一个fragments以及在back stack中保存之前的状态：
java Fragment newFragment = new ExampleFragment(); 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识别的layout容器中的fragment(如果存在)。通过调用addToBackStack()的方法，替换的transaction将被保存在back stack中，所以用户可以通过Back按钮返回到之前的fragment.
如果你添加多次改变到transaction以及调用addToBackStack(),在你调用commit()之前的所有申请的变化将作一个单独的transaction被添加到back stack中，Back按钮将会撤销所有的操作。
添加改变到FragmentTransaction的顺便没有关系，除了以下几点：
- 你必须在最后调用commit()
- 如果你添加多个fragments到同一个container时，你添加它们的顺便将决定它们在view层级中显示的顺序
当你执行transaction时也就是删除fragment时，没用调用addToBackStack()，那个fragment将被销毁在transaction被提交时且用户不能通过back导航到它。然而，你可以调用addToBackStack()当删除一个fragment时，fragment将被停止且在用户back导航时又将被重新唤起。
Tip:对于每一个fragment transaction，你在commit()之前可以调用setTransition()申请transaction时的动画
调用commit()之后不会立即执行transaction.它将会立即安排在activity的Ui线程执行（主线程)当主线程可以执行时。如果有必要，然而，你可以调用executePendingTransactions()在你的Ui线程中将会立即执行通过commit()立即执行的transactions.通过情况下这样做是不必要的，除非transaction依赖的在其他程序中执行的jobs.
Caution:只有在activity保存自身状态前当用户离开activity时），你可以通过使用commit()提交你的transaction.如果你尝试在这个点之后提交commit()，exception将会被抛出。这是因为在这之后的commit将被丢弃，如果activity需要被保存。在这种情况下如果丢失commit是容许的话，可以使用commitAllowingStateLoss()
Commnunicating with the Activity
虽然Fragment作为object被实现且独立于activity、可在多个activity中被使用，一个给定的fragment实例直接绑定在一个包含它的activity中。
特别是，fragment可以通过getActivity方法操作Activity以及简单地执行像是查找一个在activity layout中的View等操作。
java View listView = getActivity().findViewById(R.id.list);
同样的，activity可以通过使用findFragmentById()或者是findFragmentByTag()的方式从FragmentManger中获取fragment的引用并调用fragment的所有方法。如下：
java ExampleFragment fragment = (ExampleFragment) getFragmentManager().findFragmentById(R.id.example_fragment);
Creating event callbacks to the activity
在这些示例中，你可能需要一个fragment与activity共享events。一个不错的方式完成这个目标是在fragment内部定义一个callback接口且需要对应的activity实现它。当activity接受到来自接口的callback,如果有必要的情况它可以与其他fragments共享信息。
举个例子，如果新闻类app有2个fragments在一个activity中，其中一个显示文章的列表(fragment A)且另一个展示某篇文章(fragment B)，当某个列表项被选中之后fragment A 必须告诉activity，这样的化activity可以调用fragment B 去展示对应的文章。在这个案例中，onActicleSelectedListener 接口在fragment A声明:
java public static class FragmentA extends ListFragment { ... // Container Activity must implement this interface public interface OnArticleSelectedListener { public void onArticleSelected(Uri articleUri); } ... } 之后对应的activity实现onArticleSelectedListener接口以及重载onArticleSelected()通知fragment B来自fragment A中的消息。为了确保对应的activity实现了接口，fragment A的onAttach()回调函数（当添加fragment到activity时，由系统调用),检验activity是否是OnArtcleSelectedListener的实例，添加以下代码到onAttach():
java public static class FragmentA extends ListFragment { OnArticleSelectedListener mListener; ... @Override public void onAttach(Activity activity) { super.onAttach(activity); try { mListener = (OnArticleSelectedListener) activity; } catch (ClassCastException e) { throw new ClassCastException(activity.toString() + " must implement OnArticleSelectedListener"); } } ... }
如果activity没有实现接口，fragment之后将会抛出ClassCastException.当成功时，成员变量mListener获取activity对onArticleSelectedListener的实现的引用。举个例子，如果fragment A是ListFragment的子类，每次user点击列表中某个项时，系统将在fragment中调用onListItemClick()，在onListItemClick()中将会调用onArtcleSelected()与activity共享event.
java public static class FragmentA extends ListFragment { OnArticleSelectedListener mListener; ... @Override public void onListItemClick(ListView l, View v, int position, long id) { // 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 ,通过这个id activity（或者是其他fragment）可以在app的ContentProvider中获取到article.
更多关于使用content provider的信息在 Content Providers 文档中
Adding items to the Action Bar
你的fragments通过实现onCreateOptionsMenu()在activity Options Menu上构建menu items.为了这个函数接受调用，你必须在onCreate()时调用setHasOptionsMenu()，说明fragment将会添加items到Options Menu()(否则，fragment不会接受到onCreateOptionsMenu()的调用).
每个你从fragements中添加到Options Menu的items将会添加到已存在menu items中。当menu item会选择时，fragment也可以接受到onOptionsItemSelected()的调用。
你也可以通过调用registerForContextMenu()在fragment layout中注册一个view提供context menu。当用户打开context menu时，fragment接收到onCreateContextMenu()的调用。当用户选择一个item时，fragment接受到onContextItemSelected()的调用。
*Note:当用户选择一个menu item时，虽然你的fragment接受到对应每一个被添加menu item的选中回调，但是activity将会是第一个接受到各个回调.如果你的activity对 on-item-selected 回调的实现没有处理被选中的item,那么event将会被传递给fragment callback。
更多关于menus的信息，详见Menus以及Action Bar 开发者教程。
Handling the Fragment Lifecycle
管理fragment的lifecycle与管理activity的lifecycle十分相似。相似于activity，fragment存在三个状态：
- Resumed fragment在运行中的activity可见
- Paused 另一个activity在前台(foreground)以及拥有焦点，但是fragment所在的activity仍然可见(前台activity部分透明或者没有全部覆盖整个屏幕)
- Stopped fragment不可见.对应的activity已经被stop或者fragment已经被activity中移除但是被添加到back stack中。一个已停止的fragment,可能仍然存活(所有的状态以及成员信息被系统保存).然而，它对用户不可见且可能被killed当activity被killed时。
同样像activity，在activity进程被kill以及当activity被重新唤起的时候你需要恢复fragment的状态，可以通过bundle保存fragment的状态。你在fragment's onSaveInstanceState()回调的的时候保存状态，在onCreate(),onCreateView(),onActivityCreated()的时候恢复。更多关于保存状态的信息，可见Activities 文档
activity与fragment在生命周期上最为显著的不同点是fragment将会存储在activity管理的back stack中。当activity停止的时候，activity则是将会放入activities的back stack将会由系统管理。（所以当用户使用back按键的时候可以回退到activity，在Tasks and Back Stack中讨论).然而，当一个transaction移除一个fragment的时候通过调用addTobackStack()表明你想要将被移除的fragment实例保存在由对应activity管理的back stack.
因此，管理fragment的生命周期十分相似于管理activity的生命周期。所以对于管理activity生命周期的练习同样适用于fragments.你所需要理解的仅仅是activity的生命周期是如何影响fragment的生命周期。
*Caution:如果你需要context对象在你的fragment中，你可以调用getActivity的方法。然而，只有在fragment添加到activity之后才能调用getActivity，必须要小心。当一个fragment没有被添加时或者detached的时候，getActivity将会返回 null.
Coordinating with the activity lifecycle
activity的生命周期将直接影响到fragment的生命周期，像是每一个activity的生命周期回调函数都将影响到在fragment中相似的生命周期回调函数。举个例子，当activity接受到onPause()的时候，每个在activity中的fragment将会接受到onPause()调用。
Fragments 拥有少量额外生命周期回调函数，然而，这些回调函数处理独特与activity的关联是为了在执行像是构建或是删除fragments Ui的操作。那些额外添加的函数是：
- onAttach() 在fragment连接到activity的时候调用(activity被传递到这里)
- onCreateView() 在创建关联到fragment的view图层时被调用
- onActivityCreated()
当activity onCreate()函数返回时被调用 - onDestroyView() 当关联到fragment的图层被移除的时候调用
- onDetach() 当fragment取消与activity关联的时候调用
fragment的生命周期流，被对应activity影响，在上图中显示.在图中，你可以见每个activity的状态决定fragment哪个回调将被调用。举个例子，当activity接受到onCreate()调用时，在activity中的fragment将接受到onActivityCreated()以上的回调。
一旦activity到达了resumed的状态，你可以自由在activity中添加以及删除fragments.因此，只有当activity在resumed的状态时，fragment的生命周期才能独立改变。
然而，当activity离开resumed状态，fragment又将被activity影响它的生命周期。
Example
为了将文档中所有被讨论的地方集合在一起，这里有个activity使用两个fragments创建2个pane的layout的例子。以下的activity包含一个fragment显示Shakespeare戏剧标题的列表，另一个显示在列表中被选中的戏剧的概要。它同时也展示了如何根据屏幕配置显示不同fragments配置。
Note:完整的源代码在sample demo中
主activity通过常用方式申请layout，在onCreate():
java @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.fragment_layout); } 所使用的layout,fragment_layout.xml:
xml <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:orientation="horizontal" android:layout_width="match_parent" android:layout_height="match_parent"> <fragment class="com.example.android.apis.app.FragmentLayout$TitlesFragment" android:id="@+id/titles" android:layout_weight="1" android:layout_width="0px" android:layout_height="match_parent" /> <FrameLayout android:id="@+id/details" android:layout_weight="1" android:layout_width="0px" android:layout_height="match_parent" android:background="?android:attr/detailsElementBackground" /> </LinearLayout> 使用这个layout时，当activity加载layout时，系统实例化TitleFragment(这个fragmnet显示戏剧的标题)，然而FrameLayout(该fragment用于展示戏剧的概要)占据屏幕右边的空间，但是一开始的时候仍然是空白的。当在下面可见，当用户选择在列表中选择一个item的时候，fragment将会被放入到FragmentLayout中。
然而，并不是所有屏幕配置都足够宽可以容纳下同时显示戏剧的列表以及概要。所以以上的layout仅仅被使用在landscape(横屏)screen配置下，将layout保存在res/layout-land/fragment_layout.xml
因此，当屏幕是竖屏模式时，系统申请使用以下layout,这个layout保存在res/layout/fragment_layout.xml
java <FrameLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="match_parent" android:layout_height="match_parent"> <fragment class="com.example.android.apis.app.FragmentLayout$TitlesFragment" android:id="@+id/titles" android:layout_width="match_parent" android:layout_height="match_parent" /> </FrameLayout>
这个layout仅仅包含TitlesFragment.这表示，当设备在竖屏模式下，仅仅显示戏剧title的列表。所以当用户在此配置情况下点击列表某个item时，app将会启动一个新的activity展示概要，而不是加载第二个fragment.
接下来，可见如何在fragment类中实现。首先在TitlesFragment展现Shakespeare戏剧标题的列表。这个fragment继承ListFragment以及在此之上处理了绝大多数的list view的工作。
当你查看code的时候，注意当用户点击列表某一项时，可能存在2种行为，依赖于哪种layout是被使用的，它可以是创建以及展示一个新的fragment用于显示详情在同一个activity中（添加fragment到fragmentLayout）或者是启动一个新的activity（fragment在那里被显示）。
java public static class TitlesFragment extends ListFragment { boolean mDualPane; int mCurCheckPosition = 0; @Override public void onActivityCreated(Bundle savedInstanceState) { super.onActivityCreated(savedInstanceState); // Populate list with our static array of titles. setListAdapter(new ArrayAdapter<String>(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 public void onSaveInstanceState(Bundle outState) { super.onSaveInstanceState(outState); outState.putInt("curChoice", mCurCheckPosition); } @Override public void onListItemClick(ListView l, View v, int position, long id) { 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. */ void showDetails(int index) { 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(); if (index == 0) { ft.replace(R.id.details, details); } else { ft.replace(R.id.a_item, 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 = new Intent(); intent.setClass(getActivity(), DetailsActivity.class); intent.putExtra("index", index); startActivity(intent); } } }
第二个fragment,DetailsFragment显示从TitlesFragment列表中选中的某个item的戏剧概要：
java public static class DetailsFragment extends Fragment { /** * Create a new instance of DetailsFragment, initialized to * show the text at 'index'. */ public static DetailsFragment newInstance(int index) { DetailsFragment f = new DetailsFragment(); // Supply index input as an argument. Bundle args = new Bundle(); args.putInt("index", index); f.setArguments(args); return f; } public int getShownIndex() { return getArguments().getInt("index", 0); } @Override public View 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. return null; } ScrollView scroller = new ScrollView(getActivity()); TextView text = new TextView(getActivity()); int padding = (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()]); return scroller; } }
从TitlesFragment中重新调用，如果用户点击列表某个item而当前的layout并不包含R.id.details view（这个view存在于detailFragment中),之后app将会启动DetailsActivity 展示item的内容。
这里的DetailActivity，只是在竖屏模式下简单地包含DetailsFragment去展示被选中的戏剧概要
java public static class DetailsActivity extends Activity { @Override protected void 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 = new DetailsFragment(); details.setArguments(getIntent().getExtras()); getFragmentManager().beginTransaction().add(android.R.id.content, details).commit(); } } }
注意点：当回复到横屏模式下，这个activity自动结束，这样的化，主activity可以显示并在TitlesFragment一边展示DetailsFragment.这种情况可能发生，如果用户在竖屏模式下打开DetailActivity然后旋转到横屏模式（这将会重新启动当前activity）.
更多使用fragments的样例（以及上述案例的source code），可见Api Demos sample app
预计费时：10小时，实际：7小时
1303
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
