Android Fragment使用

通常地 fragment做为宿主activity UI的一部分, 被作为activity整个view hierarchy的一部分被嵌入.<wbr>有2种方法你可以添加一个fragment到activity layout：</wbr>

一、在activity的layout文件中声明fragment

你可以像为View一样, 为fragment指定layout属性（sdk3.0以后）.

例子是一个有2个fragment的activity:

<?xml version="1.0"encoding="utf-8"?>

<LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"

<wbr><wbr>android:orientation=<span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">"horizontal"</span></wbr></wbr>

<wbr><wbr>android:layout_width=<span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">"match_parent"</span></wbr></wbr>

<wbr><wbr>android:layout_height=<span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">"match_parent"</span>&gt;</wbr></wbr>

<wbr><wbr><wbr>&lt;fragment android:name=<span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">"com.example.news.ArticleListFragment"</span></wbr></wbr></wbr>

<wbr><wbr><wbr><wbr><wbr><wbr>android:id=<span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">"@+id/list"</span></wbr></wbr></wbr></wbr></wbr></wbr>

<wbr><wbr><wbr><wbr><wbr><wbr>android:layout_weight=<span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">"1"</span></wbr></wbr></wbr></wbr></wbr></wbr>

<wbr><wbr><wbr><wbr><wbr><wbr>android:layout_width=<span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">"0dp"</span></wbr></wbr></wbr></wbr></wbr></wbr>

<wbr><wbr><wbr><wbr><wbr><wbr>android:layout_height=<span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">"match_parent"</span>/&gt;</wbr></wbr></wbr></wbr></wbr></wbr>

<wbr><wbr><wbr>&lt;fragment android:name=<span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">"com.example.news.ArticleReaderFragment"</span></wbr></wbr></wbr>

<wbr><wbr><wbr><wbr><wbr><wbr>android:id=<span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">"@+id/viewer"</span></wbr></wbr></wbr></wbr></wbr></wbr>

<wbr><wbr><wbr><wbr><wbr><wbr>android:layout_weight=<span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">"2"</span></wbr></wbr></wbr></wbr></wbr></wbr>

<wbr><wbr><wbr><wbr><wbr><wbr>android:layout_width=<span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">"0dp"</span></wbr></wbr></wbr></wbr></wbr></wbr>

<wbr><wbr><wbr><wbr><wbr><wbr>android:layout_height=<span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">"match_parent"</span>/&gt;</wbr></wbr></wbr></wbr></wbr></wbr>

<wbr><span style="line-height:19px; word-break:normal; word-wrap:normal; background-color:inherit">&lt;/LinearLayout&gt;</span></wbr>

<fragment> 中的 android:name 属性指定了在layout中实例化的Fragment类.<wbr></wbr>

当系统创建这个activity layout时, 它实例化每一个在layout中指定的fragment,并调用每一个上的onCreateView()方法,来获取每一个fragment的layout. 系统将从fragment返回的 View 直接插入到<fragment>元素所在的地方.<wbr></wbr>

注意: 每一个fragment都需要一个唯一的标识, 如果activity重启,系统可以用来恢复fragment(并且你也可以用来捕获fragment来处理事务,例如移除它.)<wbr></wbr>

有3种方法来为一个fragment提供一个标识:

• 为 android:id 属性提供一个唯一ID.
• 为 android:tag 属性提供一个唯一字符串.
• 如果以上2个你都没有提供, 系统使用容器view的ID.

二、使用FragmentManager将fragment添加到一个已存在的ViewGroup.

当activity运行的任何时候, 都可以将fragment添加到activity layout.只需简单的指定一个需要放置fragment的ViewGroup.为了在你的activity中操作fragment事务(例如添加,移除,或代替一个fragment),必须使用来自 FragmentTransaction 的API.

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

FragmentManager fragmentManager = getFragmentManager();<wbr></wbr>

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().

Fragments 诞生初衷

自从Android 3.0中引入fragments 的概念,根据词海的翻译可以译为:碎片、片段。其上的是为了解决不同屏幕分辩率的动态和灵活UI设计。大屏幕如平板小屏幕如手机，平板电脑的设计使得其有更多的空间来放更多的UI组件，而多出来的空间存放UI使其会产生更多的交互，从而诞生了fragments 。fragments 的设计不需要你来亲自管理view hierarchy 的复杂变化，通过将Activity 的布局分散到frament 中，可以在运行时修改activity 的外观，并且由activity 管理的back stack 中保存些变化。

Fragments 设计理念

在设计应用时特别是Android 应用 ，有众多的分辨率要去适应，而fragments 可以让你在屏幕不同的屏幕上动态管理UI。例如：通讯应用程序（QQ），用户列表可以在左边，消息窗口在右边的设计。而在手机屏幕用户列表填充屏幕当点击某一用户时，则弹出对话窗口的设计，如下图：

Fragments的生命周期

每一个fragments 都有自己的一套生命周期回调方法和处理自己的用户输入事件。 对应生命周期可参考下图：

其中大多数程序必须使用Fragments 必须实现的三个回调方法分别为：

onCreate

系统创建Fragments 时调用，可做执行初始化工作或者当程序被暂停或停止时用来恢复状态，跟Activity 中的onCreate相当。

onCreateView

用于首次绘制用户界面的回调方法，必须返回要创建的Fragments 视图UI。假如你不希望提供Fragments用户界面则可以返回NULL。

onPause

当用户离开这个Fragments 的时候调用，这时你要提交任何应该持久的变化，因为用户可能不会回来。更多的事件可以参考上图的生命周期关系图。

Fragments 的类别

系统内置了三种Fragments ，这三种Fragments 分别有不同的应用场景分别为：

DialogFragment

对话框式的Fragments，可以将一个fragments 对话框并到activity 管理的fragments back stack中，允许用户回到一个前曾摒弃fragments.

ListFragments

类似于ListActivity 的效果，并且还提供了ListActivity 类似的onListItemCLick和setListAdapter等功能。

PreferenceFragments

类似于PreferenceActivity .可以创建类似IPAD的设置界面。

Fragments 的详细使用

首先先来看一张DEMO 效果图：

左边点击时，右边的字符会与左边选中的项的字符相同。与IPAD上的设置界面很相似，这一点是否借鉴了ipad 上的UI呢？

相就的XML文件：

<? xmlversion="1.0"encoding="utf-8" ?>
< LinearLayout xmlns:android ="http://schemas.android.com/apk/res/android"
android:layout_width ="match_parent"
android:layout_height ="match_parent"
android:orientation ="horizontal" >

< fragment class ="com.xuzhi.fragment.FragmentDemoActivity$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"
></ FrameLayout >
</ LinearLayout >

主界面代码（己做注释）：

package com.xuzhi.fragment;
importandroid.app.Activity;
importandroid.app.AlertDialog;
importandroid.app.Fragment;
importandroid.app.FragmentTransaction;
importandroid.app.ListFragment;
importandroid.os.Bundle;
importandroid.util.TypedValue;
importandroid.view.LayoutInflater;
importandroid.view.View;
importandroid.view.ViewGroup;
importandroid.widget.ArrayAdapter;
importandroid.widget.ListView;
importandroid.widget.ScrollView;
importandroid.widget.TextView;

public classFragmentDemoActivity extendsActivity{

public staticString[]array={"text1,","text2","text3","text4",
"text5,","text6","text7","text8"};

/** Calledwhentheactivityisfirstcreated. */
@Override
public voidonCreate(BundlesavedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
}


public static classTitlesFragment extendsListFragment{

booleanmDualPane;
intmCurCheckPosition=0;

@Override
public voidonCreate(BundlesavedInstanceState){
// TODOAuto-generatedmethodstub
super.onCreate(savedInstanceState);
System.out.println("Fragment-->onCreate");
}

@Override
publicViewonCreateView(LayoutInflaterinflater,ViewGroupcontainer,
BundlesavedInstanceState){
// TODOAuto-generatedmethodstub
System.out.println("Fragment-->onCreateView");
return super.onCreateView(inflater,container,savedInstanceState);
}

@Override
public voidonPause(){
// TODOAuto-generatedmethodstub
super.onPause();
System.out.println("Fragment-->onPause");
}


@Override
public voidonStop(){
// TODOAuto-generatedmethodstub
super.onStop();

System.out.println("Fragment-->onStop");
}

@Override
public voidonAttach(Activityactivity){
// TODOAuto-generatedmethodstub
super.onAttach(activity);
System.out.println("Fragment-->onAttach");
}

@Override
public voidonStart(){
// TODOAuto-generatedmethodstub
super.onStart();
System.out.println("Fragment-->onStart");
}

@Override
public voidonResume(){
// TODOAuto-generatedmethodstub
super.onResume();
System.out.println("Fragment-->onResume");
}

@Override
public voidonDestroy(){
// TODOAuto-generatedmethodstub
super.onDestroy();
System.out.println("Fragment-->onDestroy");
}



@Override
public voidonActivityCreated(BundlesavedInstanceState){
// TODOAuto-generatedmethodstub
super.onActivityCreated(savedInstanceState);
System.out.println("Fragment-->onActivityCreted");
setListAdapter( newArrayAdapter<String>(getActivity(),
android.R.layout.simple_list_item_1,array));

ViewdetailsFrame=getActivity().findViewById(R.id.details);

mDualPane=detailsFrame!= null
&&detailsFrame.getVisibility()==View.VISIBLE;

if(savedInstanceState!= null){
mCurCheckPosition=savedInstanceState.getInt("curChoice",0); // 从保存的状态中取出数据
}

if(mDualPane){
getListView().setChoiceMode(ListView.CHOICE_MODE_SINGLE);

showDetails(mCurCheckPosition);
}
}

@Override
public voidonSaveInstanceState(BundleoutState){
// TODOAuto-generatedmethodstub
super.onSaveInstanceState(outState);

outState.putInt("curChoice",mCurCheckPosition); // 保存当前的下标
}

@Override
public voidonListItemClick(ListViewl,Viewv, intposition, longid){
// TODOAuto-generatedmethodstub
super.onListItemClick(l,v,position,id);
showDetails(position);
}

voidshowDetails( intindex){
mCurCheckPosition=index;
if(mDualPane){
getListView().setItemChecked(index, true);
DetailsFragmentdetails=(DetailsFragment)getFragmentManager()
.findFragmentById(R.id.details);
if(details== null||details.getShownIndex()!=index){
details=DetailsFragment.newInstance(mCurCheckPosition);

// 得到一个fragment事务（类似sqlite的操作）
FragmentTransactionft=getFragmentManager()
.beginTransaction();
ft.replace(R.id.details,details); // 将得到的fragment替换当前的viewGroup内容，add则不替换会依次累加
ft.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE); // 设置动画效果
ft.commit(); // 提交
}
} else{
newAlertDialog.Builder(getActivity()).setTitle(
android.R.string.dialog_alert_title).setMessage(
array[index]).setPositiveButton(android.R.string.ok,
null).show();
}
}
}

/**
*作为界面的一部分，为fragment提供一个layout
* @author terry
*
*/
public static classDetailsFragment extendsFragment{

public staticDetailsFragmentnewInstance( intindex){
DetailsFragmentdetails= newDetailsFragment();
Bundleargs= newBundle();
args.putInt("index",index);
details.setArguments(args);
returndetails;
}

public intgetShownIndex(){
returngetArguments().getInt("index",0);
}

@Override
publicViewonCreateView(LayoutInflaterinflater,ViewGroupcontainer,
BundlesavedInstanceState){
// TODOAuto-generatedmethodstub
if(container== null)
return null;

ScrollViewscroller= newScrollView(getActivity());
TextViewtext= 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(array[getShownIndex()]);
returnscroller;
}
}
}

注意：

1. 如果你想在Fragment 里面创建menu，则必须在onCreate的时候设置让它可以存在optionMenu才可以创建，代码为：
   
   

   public static classDetailsFragment extendsFragment{
   
   @Override
   public voidonCreate(BundlesavedInstanceState){
   // TODOAuto-generatedmethodstub
   super.onCreate(savedInstanceState);
   setHasOptionsMenu( true);
   }
   }

   
   之后的操作即可以像平常Android的menu用法一样,代码为：
   
   

   @Override
   public voidonCreateOptionsMenu(Menumenu,MenuInflaterinflater){
   // TODOAuto-generatedmethodstub
   super.onCreateOptionsMenu(menu,inflater);
   menu.add("Menu1a").setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
   menu.add("Menu1b").setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
   }
   
   @Override
   public booleanonOptionsItemSelected(MenuItemitem){
   // TODOAuto-generatedmethodstub
   Toast.makeText(getActivity(),"indexis"+getShownIndex()+"&&menutextis"+item.getTitle(),1000).show();
   return super.onOptionsItemSelected(item);
   }

   

更多详细的使用方法，请参考SDK和APIDEMO中相关的例子和解释。

DEMO下载：

Android FramentDEMO