Fragments (Android官方文档中文版) (转)

时间  2019-11-08
标签 fragments android 官方 文档 中文版 栏目 Android 繁體版
原文   原文链接

概述


html




        Fragment 表现 Activity 中用UI的一个行为或者一部分.能够组合多个fragment放在一个单独的activity中来建立一个多界面区域的UI,并能够在多个activity里重用某一个fragment.把fragment想象成一个activity的模块化区域, 有它本身的生命周期, 接收属于它的输入事件,而且能够在activity运行期间添加和删除.

       Fragment 必须老是被嵌入到一个activity中, 它们的生命周期直接被其所属的宿主activity的生命周期影响.例如, 当activity被暂停,那么在其中的全部fragment也被暂停; 当activity被销毁,全部隶属于它的fragment也被销毁. 然而,当一个activity正在运行时(处于resumed状态),咱们能够独立地操做每个fragment, 好比添加或删除它们. 当处理这样一个fragment事务时,也能够将它添加到activity所管理的back stack -- 每个activity中的backstack实体都是一个发生过的fragment事务的记录. back stack容许用户经过按下 BACK按键从一个fragment事务后退(日后导航).

       将一个fragment做为activity布局的一部分添加进来时, 它处在activity的viewhierarchy中的ViewGroup中,而且定义有它本身的view布局.经过在activity的布局文件中声明fragment来插入一个fragment到你的activity布局中,或者能够写代码将它添加到一个已存在的ViewGroup.然而, fragment并不必定必须是activity布局的一部分;也能够将一个fragment做为activity的隐藏的后台工做者.

       本文档描述了如何使用fragment建立你的应用程序, 包括:当被添加到activity的back stack后,fragment如何维护他们的状态.在activity中,与activity和其余fragment共享事件.构建到activity的actionbar.以及更多内容.

设计哲学


android



        Android在3.0中引入了fragments的概念,主要目的是用在大屏幕设备上--例如平板电脑上,支持更加动态和灵活的UI设计.平板电脑的屏幕要比手机的大得多,有更多的空间来放更多的UI组件,而且这些组件之间会产生更多的交互.Fragment容许这样的一种设计,而不须要你亲自来管理viewhierarchy的复杂变化. 经过将activity的布局分散到fragment中, 你能够在运行时修改activity的外观,并在由activity管理的back stack中保存那些变化. 

       例如, 一个新闻应用能够在屏幕左侧使用一个fragment来展现一个文章的列表,而后在屏幕右侧使用另外一个fragment来展现一篇文章 – 2个fragment并排显示在相同的一个activity中,而且每个fragment拥有它本身的一套生命周期回调方法,而且处理它们本身的用户输入事件. 所以, 取代使用一个activity来选择一篇文章,而另外一个activity来阅读文章 的方式,用户能够在相同的activity中选择一篇文章而且阅读, 如图所示: 


设计模式

 



       fragment在你的应用中应当是一个模块化和可重用的组件.即,由于fragment定义了它本身的布局, 以及经过使用它本身的生命周期回调方法定义了它本身的行为,你能够将fragment包含到多个activity中. 这点特别重要, 由于这容许你将你的用户体验适配到不一样的屏幕尺寸.举个例子,你可能会仅当在屏幕尺寸足够大时,在一个activity中包含多个fragment,而且,当不属于这种状况时,会启动另外一个单独的,使用不一样fragment的activity.

       继续以前那个新闻的例子 -- 当运行在一个特别大的屏幕时(例如平板电脑),app能够在Activity A中嵌入2个fragment.然而,在一个正常尺寸的屏幕(例如手机)上,没有足够的空间同时供2个fragment用, 所以, Activity A会仅包含文章列表的fragment, 而当用户选择一篇文章时, 它会启动Activity B,它包含阅读文章的fragment. 所以, 应用能够同时支持图1中的2种设计模式.

建立Fragment

app


    


    要建立一个fragment, 必须建立一个 Fragment 的子类 (或者继承自一个已存在的它的子类). Fragment类的代码看起来很像 Activity .它包含了和activity相似的回调方法, 例如 onCreate(), onStart(),onPause, 以及 onStop(). 事实上, 若是你准备将一个现成的Android应用转换到使用fragment,你可能只需简单的将代码从你的activity的回调函数分别移动到你的fragment的回调方法.

    一般, 应当至少实现以下的生命周期方法:



ide

  • onCreate()
    当建立fragment时, 系统调用此方法. 
    在实现代码中,应当初始化想要在fragment中保持的必要组件, 当fragment被暂停或者中止后能够恢复.
  • onCreateView()
    fragment第一次绘制它的用户界面的时候, 系统会调用此方法. 为了绘制fragment的UI,此方法必须返回一个View, 这个view是你的fragment布局的根view. 若是fragment不提供UI, 能够返回null.
  • onPause()
    用户将要离开fragment时,系统调用这个方法做为第一个指示(然而它不老是意味着fragment将被销毁.) 在当前用户会话结束以前,一般应当在这里提交任何应该持久化的变化(由于用户有可能不会返回).


    大多数应用应当为每个fragment实现至少这3个方法,可是还有一些其余回调方法你也应当用来去处理fragment生命周期的各类阶段.所有的生命周期回调方法将会在后面章节 Handlingthe Fragment Lifecycle 中讨论.

    除了继承基类 Fragment , 还有一些子类你可能会继承:



模块化

  • DialogFragment
    显示一个浮动的对话框.  
    用这个类来建立一个对话框,是使用在Activity类的对话框工具方法以外的一个好的选择,
    由于你能够将一个fragment对话框合并到activity管理的fragment back stack中,容许用户返回到一个以前曾被摒弃的fragment.
  • ListFragment
    显示一个由一个adapter(例如 SimpleCursorAdapter)管理的项目的列表, 相似于ListActivity.
    它提供一些方法来管理一个list view, 例如 onListItemClick()回调来处理点击事件.
  • PreferenceFragment
    显示一个 Preference对象的层次结构的列表, 相似于PreferenceActivity. 
    这在为你的应用建立一个"设置"activity时有用处.


添加一个用户界面

函数


       fragment一般用来做为一个activity的用户界面的一部分,并将它的layout提供给activity.为了给一个fragment提供一个layout,你必须实现 onCreateView()回调方法, 当到了fragment绘制它本身的layout的时候,Android系统调用它.你的此方法的实现代码必须返回一个你的fragment的layout的根view. 

       注意: 若是你的fragment是ListFragment的子类,它的默认实现是返回从onCreateView()返回一个ListView,因此通常状况下没必要实现它. 

      从onCreateView()返回的View, 也能够从一个xmllayout资源文件中读取并生成. 为了帮助你这么作, onCreateView() 提供了一个LayoutInflater 对象.

      举个例子, 这里有一个Fragment的子类, 从文件 example_fragment.xml 加载了一个layout:工具

 

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 参数是你的fragmentlayout将被插入的父ViewGroup(来自activity的layout).savedInstanceState 参数是一个Bundle, 若是fragment是被恢复的,它提供关于fragment的以前的实例的数据,

inflate() 方法有3个参数:



布局

  • 想要加载的layout的resource ID.
  • 加载的layout的父ViewGroup.
    传入container是很重要的, 目的是为了让系统接受所要加载的layout的根view的layout参数,
    由它将挂靠的父view指定.
  • 布尔值指示在加载期间, 展开的layout是否应当附着到ViewGroup (第二个参数).
    (在这个例子中, 指定了false, 由于系统已经把展开的layout插入到container –传入true会在最后的layout中建立一个多余的view group.)


将fragment添加到activity
      一般地, fragment为宿主activity提供UI的一部分, 被做为activity的整个viewhierarchy的一部分被嵌入. 有2种方法你能够添加一个fragment到activitylayout:

在activity的layout文件中声明fragment
       你能够像为View同样, 为fragment指定layout属性.
       例子是一个有2个fragment的activity:动画

 

<?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>

 

<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添加到activitylayout.只需简单的指定一个须要放置fragment的ViewGroup.为了在你的activity中操做fragment事务(例如添加,移除,或代替一个fragment),必须使用来自FragmentTransaction 的API.

       能够按以下方法,从你的Activity取得一个 FragmentTransaction 的实例:

 

FragmentManager fragmentManager = getFragmentManager();
FragmentTransaction fragmentTransaction = fragmentManager.beginTransaction();

 

而后你可使用 add() 方法添加一个fragment, 指定要添加的fragment, 和要插入的view.

 

ExampleFragment fragment = new ExampleFragment();
fragmentTransaction.add(R.id.fragment_container, fragment);
fragmentTransaction.commit();

 

add()的第一个参数是fragment要放入的ViewGroup, 由resource ID指定,第二个参数是须要添加的fragment.一旦用FragmentTransaction作了改变,为了使改变生效,必须调用commit(). 

添加一个无UI的fragment

       以前的例子展现了对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().

管理Fragment


       要在activity中管理fragment,须要使用FragmentManager. 经过调用activity的getFragmentManager()取得它的实例.

       能够经过FragmentManager作一些事情, 包括:



  • 使用findFragmentById() (用于在activitylayout中提供一个UI的fragment)或findFragmentByTag()(适用于有或没有UI的fragment)获取activity中存在的fragment
  • 将fragment从后台堆栈中弹出, 使用 popBackStack() (模拟用户按下BACK 命令).
  • 使用addOnBackStackChangeListener()注册一个监听后台堆栈变化的listener.


处理Fragment事务


       关于在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 = 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替换了当前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()提交的事务. 但这么作一般没必要要,除非事务是其余线程中的job的一个从属.

       警告:你只能在activity保存它的状态(当用户离开activity)以前使用commit()提交事务.

       若是你试图在那个点以后提交, 会抛出一个异常.这是由于若是activity须要被恢复,提交以后的状态可能会丢失.对于你以为能够丢失提交的情况, 使用 commitAllowingStateLoss().

 

   

你可能想调用 addToBackStack(),将事务添加到一个fragment事务的backstack. 这个back stack由activity管理, 并容许用户经过按下 BACK按键返回到前一个fragment状态.
举个例子, 这里是如何将一个fragment替换为另外一个, 并在后台堆栈中保留以前的状态:

Fragment newFragment = new ExampleFragment();
FragmentTransaction transaction = getFragmentManager().beginTransaction();
transaction.replace(R.id.fragment_container, newFragment);
transaction.addToBackStack(null);
transaction.commit();

 



与Activity通讯


       尽管Fragment被实现为一个独立于Activity的对象,而且能够在多个activity中使用,但一个给定的fragment实例是直接绑定到包含它的activity的. 特别的,fragment可使用 getActivity() 访问Activity实例, 而且容易地执行好比在activitylayout中查找一个view的任务.

 

View listView = getActivity().findViewById(R.id.list);

 

一样地,activity能够经过从FragmentManager得到一个到Fragment的引用来调用fragment中的方法, 使用findFragmentById() 或 findFragmentByTag().

 

ExampleFragment fragment = (ExampleFragment) getFragmentManager().findFragmentById(R.id.example_fragment);

 

为Activity建立事件回调方法
       在一些状况下, 你可能须要一个fragment与activity分享事件. 一个好的方法是在fragment中定义一个回调的interface, 并要求宿主activity实现它.当activity经过interface接收到一个回调, 必要时它能够和在layout中的其余fragment分享信息.

       例如, 若是一个新的应用在activity中有2个fragment – 一个用来显示文章列表(framgent A), 另外一个显示文章内容(fragment B) – 而后 framgent A必须告诉activity什么时候一个list item被选中,而后它能够告诉fragment B去显示文章.

       在这个例子中, 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 implement OnArticleSelectedListener");
         }
     }

     ... 

}

 

若是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 获取文章.

 

 

添加项目到Action Bar
       你的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生命周期

        管理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 activity lifecycle"中的相同实践也一样适用于fragment. 你须要理解的是,  activity的生命如何影响fragment的生命.

与activity生命周期的协调工做
       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对它的影响, 在图3中显示.在这个图中,能够看到activity依次的每一个状态是如何决定fragment可能接收到的回调方法.例如, 当activity接收到它的onCreate(), activity中的fragment接收到最可能是onActivityCreated().

       一旦activity到达了resumed状态, 你能够自由地在activity添加和移除fragment.所以,仅当activity处于resumed状态时, fragment的生命周期才能够独立变化.

      不管如何, 当activity离开resumed状态,fragment再次被activity的推入它本身的生命周期过程. 

 

 

 

  转自：http://www.eoeandroid.com/thread-71642-1-1.html

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程