标签: android 教程 中文文档java
一个Fragment
看起来就是一个和Activity同样的用户界面。你能够结合多个Fragments到一个activity中,来构建一个有多方面功能的UI,还能够重用同一个Fragment在多个activities中。你能够把它当成是activity的一个组件,每一个Fragment有单独的生命周期,你能够在activity运行时进行进行添加和移除Fragment。相比较于activity,Fragment更加轻量级,更加灵活。android
一个Fragment老是被植入在一个activity中,而且其生命周期受其父activity直接影响,好比activity处于暂停,则其中的Fragment都暂停,activity销毁,则全部Fragment都销毁。然而,当一个activity运行时,你能够独立的操做每个Fragment,好比添加和删除他们。当你进行相似的操做时,你能够将Fragment添加入被activity管理的后退栈中,这样用户能够经过点击返回按钮来返回以前打开的Fragment。ide
你能够将一个Fragment做为activity的一部分添加到其布局文件中,经过声明<fragment>
元素做为ViewGroup
的一部分。固然,这不是必须的,你也能够将Fragment做为一个没有本身的UI的不可见的activity的工人。函数
Android在Android3.0(API 11)上介绍了fragmens,主要是支持在大屏幕上更动态和灵活的UI设计,好比平板。布局
为了建立一个Fragment,你必须建立一个Fragment
的子类,Fragment
编码就像是一个Activity
。包含一些相同的回调函数,好比onCreate()
,onStart()
,onPause()
,和onStop()
。事实上,若是你覆盖一个已有的Android应用来使用Fragment,你只用简单的移动对应的代码到对应的回调函数中。动画
一般状况下,你应该至少实现如下的生命周期函数:onCreate()
系统在建立fragment时调用。
你应该在这里初始化你想要在暂停或者中止恢复时保持的fragment部分。onCreateView()
系统在fragment第一次构造用户界面时调用。
为了给你的fragment构造一个UI,你必定要记得return一个View
,这个View是来自你的fragment的根布局,你也能够return null,若是这个fragment没有UI。onPause()
系统会在用户产生离开这个fragment的迹象时调用。
这里一般是你提交变化的地方。由于用户或许不会回来。this
大多数的应用都应该为至少每个fragment实现这三个方法,但还有其余的回调函数,你也应该用他们来处理fragment的各个阶段。编码
这里还有一些fragment的子类:DialogFragment
显示一个悬浮的对话框。好处是你能将其加入后退栈中,容许用户返回。ListFragment
显示一个经过adapter管理的列表,相似ListActivity
,它提供许多方法管理一个列表view。PreferenceFragment
在一个列表中显示一个分级Preference
对象,相似PreferenceActivity
。当你为你的应用建立“设置”activity时颇有用。spa
一个fragment常做为activity用户界面的一部分。
要使用一个fragment的布局文件,你必须实现onCreateView()
回调函数,return根布局。.net
若是你的fragment是
ListFragment
的子类,它会在onCreateView()
中自动返回一个ListView
。你就不用去实现了。
为了返回一个布局,能够从一个定义在xml中的布局资源中载入来提供帮助。onCreateView()
提供一个LayoutInflater
对象
public static class ExampleFragment extends Fragment { @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { // 载入布局资源 return inflater.inflate(R.layout.example_fragment, container, false); } }
container
参数是存放fragment的布局的ViewGroup对象,savedInstanceState
参数是一个Bundle,跟activity的onCreate()中Bundle差很少,用于状态恢复。可是fragment的onCreate()中也有Bundle参数,因此此处的Bundle中存放的数据与onCreate()中存放的数据仍是不一样的。至于详细信息,请参考“操控fragment的生命周期“。
Inflate()方法有三个参数:
1.layout的资源ID。
2.存放fragment的layout的ViewGroup。
3.布尔型数据表示是否在建立fragment的layout期间,把layout附加到container上(在这个例子中, 指定了false, 由于系统已经把展开的layout插入到container –传入true会在最后的layout中建立一个多余的view group.)
通常状况下,fragment把它的layout做为activitiy的layout的一部分合并到activity中,有两种方法将一个fragment添加到activity中:
在activity的layoutxml文件中声明fragment:
在这种状况下,你能够像为View同样, 为fragment指定layout属性.例子是一个有两个fragment的activity的layout:
<?xmlversion="1.0"encoding="utf-8"?> <LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android" android:orientation="horizontal" android:layout_width="match_parent" android:layout_height="match_parent"> <fragmentandroid:name="com.example.news.ArticleListFragment" android:id="@+id/list" android:layout_weight="1" android:layout_width="0dp" android:layout_height="match_parent"/> <fragmentandroid:name="com.example.news.ArticleReaderFragment" android:id="@+id/viewer" android:layout_weight="2" android:layout_width="0dp" android:layout_height="match_parent"/> </LinearLayout
在代码中添加fragment到一个ViewGroup:<fragment>
中的 android:name
属性指定了在layout中实例化的Fragment
类. 当系统建立这个activity layout时,它实例化每个在layout中指定的fragment,并调用每个上的onCreateView()
方法,来获取每个 fragment的layout.系统将从fragment返回的 View
直接插入到<fragment>
元素所在的地方.
每个fragment都须要一个惟一的标识,若是activity重启,系统能够用来恢复fragment(而且你也能够用来捕获fragment来处理事务,例如移除它.)
有3种方法来为一个fragment提供一个标识:
为 android:id 属性提供一个惟一ID.
为 android:tag 属性提供一个惟一字符串.
若是以上2个你都没有提供, 系统使用容器view的ID.
或者撰写代码将fragment添加到一个已存在的ViewGroup.
当activity运行的任什么时候候, 均可以将fragment添加到activity layout.只需简单的指定一个须要放置fragment的ViewGroup
.为了在你的 activity中操做fragment事务(例如添加,移除,或代替一个fragment),必须使用来自FragmentTransaction 的API.
能够按以下方法,从你的Activity取得一个 FragmentTransaction 的实例:
FragmentManager fragmentManager =getFragmentManager(); FragmentTransaction fragmentTransaction =fragmentManager.beginTransaction();
而后你可使用 add() 方法添加一个fragment, 指定要添加的fragment和要插入的view.
ExampleFragment fragment = newExampleFragment(); fragmentTransaction.add(R.id.fragment_container,fragment); fragmentTransaction.commit();
add()的第一个参数是fragment要放入的ViewGroup, 由resource ID指定,第二个参数是须要添加的fragment.一旦用FragmentTransaction作了改变,为了使改变生效,必须调用commit().
以前的例子展现了对UI的支持, 如何将一个fragment添加到activity.然而,也可使用fragment来为activity提供后台行为而不用展示额外的UI.
要添加一个无UI的fragment, 须要从activity使用 add(Fragment, String)
来添加fragment (为fragment提供一个惟一的字符串"tag", 而不是一个view ID).这么作添加了fragment,但由于它没有关联到一个activity layout中的一个view, 因此不会接收到onCreateView()
调用.所以没必要实现此方法.
为fragment提供一个字符串tag并非专门针对无UI的fragment的–也能够提供字符串tag给有UI的fragment–可是若是fragment没有UI,那么这个tag是仅有的标识它的途径.若是随后你想从activity获取这个fragment, 须要使用 findFragmentByTag()
.
要在activity中管理fragment,须要使用FragmentManager
. 经过调用activity的getFragmentManager()
取得它的实例.
能够经过FragmentManager
作一些事情, 包括:
使用findFragmentById()
(用于在activity layout中提供一个UI的fragment)或findFragmentByTag()
(适用于有或没有UI的fragment)获取activity中存在的fragment
将fragment从后台堆栈中弹出, 使用 popBackStack()
(模拟用户按下BACK 命令).
使用addOnBackStackChangeListener()
注册一个监听后台堆栈变化的listener.
关于在activity中使用fragment的很强的一个特性是:根据用户的交互状况,对fragment进行添加,移除,替换,以及执行其余动做.提交给activity的每一套变化被称为一个事务,可使用在FragmentTransaction
中的 API 处理.咱们也能够保存每个事务到一个activity管理的backstack,容许用户经由fragment的变化往回导航(相似于经过 activity日后导航).
从 FragmentManager 得到一个FragmentTransaction实例 :
FragmentManager fragmentManager =getFragmentManager(); FragmentTransaction fragmentTransaction =fragmentManager.beginTransaction();
每个事务都是同时要执行的一套变化.能够在一个给定的事务中设置你想执行的全部变化,使用诸如 add()、remove()和 replace().而后, 要给activity应用事务, 必须调用 commit().
在调用commit()以前, 你可能想调用 addToBackStack(),将事务添加到一个fragment事务的backstack. 这个back stack由activity管理, 并容许用户经过按下 BACK按键返回到前一个fragment状态.
举个例子, 这里是如何将一个fragment替换为另外一个, 并在后台堆栈中保留以前的状态:
// Create new fragment and transaction Fragment newFragment = newExampleFragment(); FragmentTransaction transaction =getFragmentManager().beginTransaction(); // Replace whatever is in thefragment_container view with this fragment, // and add the transaction to the backstack transaction.replace(R.id.fragment_container,newFragment); transaction.addToBackStack(null); // Commit the transaction transaction.commit();
在这个例子中,newFragment替换了当前layout容器中的由R.id.fragment_container标识的fragment.经过调用 addToBackStack(), replace事务被保存到back stack,所以用户能够回退事务,并经过按下BACK按键带回前一个fragment.
若是添加多个变化到事务(例如add()或remove())并调用addToBackStack(),而后在你调用commit()以前的全部应用的变化会被做为一个单个事务添加到后台堆栈, BACK按键会将它们一块儿回退.
添加变化到 FragmentTransaction的顺序不重要, 除如下例外:
必须最后调用 commit().
若是添加多个fragment到同一个容器, 那么添加的顺序决定了它们在view hierarchy中显示的顺序.
当执行一个移除fragment的事务时, 若是没有调用 addToBackStack(), 那么当事务提交后,那个fragment会被销毁,而且用户不能导航回到它. 有鉴于此, 当移除一个fragment时,若是调用了addToBackStack(), 那么fragment会被中止, 若是用户导航回来,它将会被恢复.
对于每个fragment事务, 你能够应用一个事务动画,经过在提交事务以前调用setTransition()实现.
调用 commit() 并不当即执行事务.偏偏相反, 它将事务安排排期, 一旦准备好,就在activity的UI线程上运行(主线程).若是有必要, 不管如何, 你能够从你的UI线程调用executePendingTransactions()来当即执行由commit()提交的事务. 但这么作一般没必要要,除非事务是其余线程中的任务的一个从属.
警告:你只能在activity保存它的状态(当用户离开activity)以前使用commit()提交事务.
尽管Fragment被实现为一个独立于Activity的对象,而且能够在多个activity中使用,但一个给定的fragment实例是直接绑定到包含它的activity的. 特别的,fragment可使用 getActivity() 访问Activity实例, 而且容易地执行好比在activity layout中查找一个view的任务.
View listView =getActivity().findViewById(R.id.list); <span style="font-family:System;"> </span>
一样地,activity能够经过从FragmentManager得到一个到Fragment的引用来调用fragment中的方法, 使用findFragmentById() 或 findFragmentByTag().
ExampleFragment fragment = (ExampleFragment) getFragmentManager().findFragmentById(R.id.example_fragment);
在一些状况下, 你可能须要一个fragment与activity分享事件. 一个好的方法是在fragment中定义一个回调的interface, 并要求宿主activity实现它.当activity经过interface接收到一个回调, 必要时它能够和在layout中的其余fragment分享信息.
例如, 若是一个新的应用在activity中有2个fragment – 一个用来显示文章列表(framgent A), 另外一个显示文章内容(fragment B) – 而后 framgent A必须告诉activity什么时候一个list item被选中,而后它能够告诉fragmentB去显示文章.
在这个例子中, OnArticleSelectedListener 接口在fragment A中声明:
public static class FragmentA extends ListFragment { ... // Container Activity must implement this interface public interface OnArticleSelectedListener { public void onArticleSelected(Uri articleUri); } ... }
而后fragment的宿主activity实现 OnArticleSelectedListener 接口, 并覆写 onArticleSelected() 来通知fragment B,从fragment A到来的事件.为了确保宿主activity实现这个接口, fragment A的 onAttach() 回调方法(当添加fragment到activity时由系统调用) 经过将做为参数传入onAttach()的Activity作类型转换来实例化一个OnArticleSelectedListener实例.
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 implementOnArticleSelectedListener"); } } ... }
若是activity没有实现接口, fragment会抛出 ClassCastException 异常. 正常情形下,mListener成员会保持一个到activity的OnArticleSelectedListener实现的引用, 所以fragment A能够经过调用在OnArticleSelectedListener接口中定义的方法分享事件给activity.例如, 若是fragment A是一个 ListFragment的子类, 每次用户点击一个列表项, 系统调用在fragment中的onListItemClick(),而后后者调用 onArticleSelected() 来分配事件给activity.
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, activity(或其余fragment)用来从应用的 ContentProvider 获取文章.
你的fragment能够经过实现 onCreateOptionMenu() 提供菜单项给activity的选项菜单(以此类推, Action Bar也同样).为了使这个方法接收调用,不管如何, 你必须在 onCreate() 期间调用 setHasOptionsMenu() 来指出fragment愿意添加item到选项菜单(不然, fragment将接收不到对 onCreateOptionsMenu()的调用).
随后从fragment添加到Option菜单的任何项,都会被追加到现有菜单项的后面.当一个菜单项被选择, fragment也会接收到 对 onOptionsItemSelected() 的回调.也能够在你的fragment layout中经过调用registerForContextMenu() 注册一个view来提供一个环境菜单.当用户打开环境菜单, fragment接收到一个对 onCreateContextMenu() 的调用.当用户选择一个项目, fragment接收到一个对onContextItemSelected() 的调用.
注意: 尽管你的fragment会接收到它所添加的每个菜单项被选择后的回调, 但实际上当用户选择一个菜单项时, activity会首先接收到对应的回调.若是activity的on-item-selected回调函数实现并无处理被选中的项目, 而后事件才会被传递到fragment的回调.
这个规则适用于选项菜单和环境菜单.
管理fragment的生命周期, 大多数地方和管理activity生命周期很像.和activity同样, fragment能够处于3种状态:
Resumed
在运行中的activity中fragment可见.
Paused
另外一个activity处于前台并拥有焦点, 可是这个fragment所在的activity仍然可见(前台activity局部透明或者没有覆盖整个屏幕).
Stopped
要么是宿主activity已经被中止, 要么是fragment从activity被移除但被添加到后台堆栈中.
中止状态的fragment仍然活着(全部状态和成员信息被系统保持着). 然而, 它对用户再也不可见, 而且若是activity被干掉,他也会被干掉.
其对应关系图以下:
和activity同样, 你可使用Bundle保持fragment的状态, 万一activity的进程被干掉,而且当activity被从新建立的时候, 你须要恢复fragment的状态时就能够用到. 你能够在fragment的 onSaveInstanceState()
期间保存状态, 并能够在 onCreate()
, onCreateView()
或 onActivityCreated()
期间恢复它.
生命周期方面activity和fragment之间最重要的区别是各自如何在它的后台堆栈中储存. 在默认状况下, activity在中止后, 它会被放到一个由系统管理的用于保存activity的后台堆栈.(所以用户可使用BACK按键导航回退到它).
然而, 仅当你在一个事务期间移除fragment时,显式调用addToBackStack()
请求保存实例时,才被放到一个由宿主activity管理的后台堆栈.
另外, 管理fragment的生命周期和管理activity生命周期很是相似.所以, "managing the activitylifecycle"中的相同实践也一样适用于fragment. 你须要理解的是, activity的生命如何影响fragment的生命.
fragment所生存的activity的生命周期,直接影响fragment的生命周期,每个activity的生命周期的回调行为都会引发每个fragment中相似的回调.
例如,当activity接收到`onPause()`时,activity中的每个fragment都会接收到`onPause()`. Fragment 有一些额外的生命周期回调方法, 那些是处理与activity的惟一的交互,为了执行例如建立和销毁fragment的UI的动做. 这些额外的回调方法是:
onAttach()
当fragment被绑定到activity时被调用(Activity会被传入.).
onCreateView()
建立和fragment关联的view hierarchy时调用.
onActivityCreated()
当activity的onCreate()方法返回时被调用.
onDestroyView()
当和fragment关联的view hierarchy正在被移除时调用.
onDetach()
当fragment从activity解除关联时被调用.
fragment生命周期的流程, 以及宿主activity对它的影响,在图activity_fragment_lifecycle
中显示.在这个图中,能够看到activity依次的每一个状态是如何决定fragment可能接收到的回调方法.
例如, 当activity接收到它的onCreate()
,activity中的fragment接收到最可能是onActivityCreated()
.
一旦activity到达了resumed状态, 你能够自由地在activity添加和移除fragment.所以,仅当activity处于resumed状态时, fragment的生命周期才能够独立变化.
不管如何, 当activity离开resumed状态,fragment再次被activity的推入它本身的生命周期过程.
(未完待续)