fragment



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

通常, 应当至少实现如下的生命周期方法:

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

大多数应用应当为每一个fragment实现至少这3个方法, 但是还有一些其他回调方法你也应当用来去处理fragment生命周期的各种阶段.全部的生命周期回调方法将会在后面章节 Handling the 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, 也可以从一个xml layout资源文件中读取并生成. 为了帮助你这么做, 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 参数是你的fragment layout将被插入的父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的整个view hierarchy的一部分被嵌入. 有2种方法你可以添加一个fragment到activity layout:

在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添加到activity layout.只需简单的指定一个需要放置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() (用于在activity layout中提供一个UI的fragment)或findFragmentByTag() (适用于有或没有UI的fragment)获取activity中存在的fragment
• 将fragment从后台堆栈中弹出, 使用 popBackStack() (模拟用户按下BACK 命令).
• 使用addOnBackStackChangeListener()注册一个监听后台堆栈变化的listener.