Android中Fragment的应用文档格式.docx
《Android中Fragment的应用文档格式.docx》由会员分享，可在线阅读，更多相关《Android中Fragment的应用文档格式.docx（14页珍藏版）》请在冰点文库上搜索。
fragment在你的应用中应当是一个模块化和可重用的组件.即,因为fragment定义了它自己的布局,以及通过使用它自己的生命周期回调方法定义了它自己的行为,你可以将fragment包含到多个activity中.这点特别重要,因为这允许你将你的用户体验适配到不同的屏幕尺寸.举个例子,你可能会仅当在屏幕尺寸足够大时,在一个activity中包含多个fragment,并且,当不属于这种情况时,会启动另一个单独的,使用不同fragment的activity.
继续之前那个新闻的例子--当运行在一个特别大的屏幕时（例如平板电脑）,app可以在ActivityA中嵌入2个fragment.然而,在一个正常尺寸的屏幕（例如手机）上,没有足够的空间同时供2个fragment用,因此,ActivityA会仅包含文章列表的fragment,而当用户选择一篇文章时,它会启动ActivityB,它包含阅读文章的fragment.
因此,应用可以同时支持图1中的2种设计模式.
创建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生命周期的各种阶段.全部的生命周期回调方法将会在后面章节HandlingtheFragmentLifecycle中讨论.
除了继承基类Fragment,还有一些子类你可能会继承:
DialogFragment
显示一个浮动的对话框.
用这个类来创建一个对话框,是使用在Activity类的对话框工具方法之外的一个好的选择,
因为你可以将一个fragment对话框合并到activity管理的fragmentbackstack中,允许用户返回到一个之前曾被摒弃的fragment.
ListFragment
显示一个由一个adapter（例如SimpleCursorAdapter）管理的项目的列表,类似于ListActivity.
它提供一些方法来管理一个listview,例如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:
publicstaticclassExampleFragmentextendsFragment{
@Override
publicViewonCreateView（LayoutInflaterinflater,ViewGroupcontainer,BundlesavedInstanceState）{
//Inflatethelayoutforthisfragment
return
inflater.inflate（R.layout.example_fragment,container,false）;
}
}
传入onCreateView（）的container参数是你的fragmentlayout将被插入的父ViewGroup（来自activity的layout）.savedInstanceState参数是一个Bundle,如果fragment是被恢复的,它提供关于fragment的之前的实例的数据,
inflate（）方法有3个参数:
想要加载的layout的resourceID.
加载的layout的父ViewGroup.
传入container是很重要的,目的是为了让系统接受所要加载的layout的根view的layout参数,
由它将挂靠的父view指定.
布尔值指示在加载期间,展开的layout是否应当附着到ViewGroup（第二个参数）.
（在这个例子中,指定了false,因为系统已经把展开的layout插入到container–传入true会在最后的layout中创建一个多余的viewgroup.）
将fragment添加到activity
通常地,fragment为宿主activity提供UI的一部分,被作为activity的整个viewhierarchy的一部分被嵌入.
有2种方法你可以添加一个fragment到activitylayout:
在activity的layout文件中声明fragment
你可以像为View一样,为fragment指定layout属性.
例子是一个有2个fragment的activity:
<
?
xmlversion="
1.0"
encoding="
utf-8"
>
LinearLayout
xmlns:
android="
android:
orientation="
horizontal"
layout_width="
match_parent"
layout_height="
fragmentandroid:
name="
com.example.news.ArticleListFragment"
id="
@+id/list"
layout_weight="
1"
0dp"
/>
com.example.news.ArticleReaderFragment"
@+id/viewer"
2"
/LinearLayout>
fragment>
中的android:
name属性指定了在layout中实例化的Fragment类.
当系统创建这个activitylayout时,它实例化每一个在layout中指定的fragment,并调用每一个上的onCreateView（）方法,来获取每一个fragment的layout.系统将从fragment返回的View直接插入到<
元素所在的地方.
每一个fragment都需要一个唯一的标识,如果activity重启,系统可以用来恢复fragment（并且你也可以用来捕获fragment来处理事务,例如移除它.）
有3种方法来为一个fragment提供一个标识:
为android:
id属性提供一个唯一ID.
tag属性提供一个唯一字符串.
如果以上2个你都没有提供,系统使用容器view的ID.
撰写代码将fragment添加到一个已存在的ViewGroup.
当activity运行的任何时候,都可以将fragment添加到activitylayout.只需简单的指定一个需要放置fragment的ViewGroup.为了在你的activity中操作fragment事务（例如添加,移除,或代替一个fragment）,必须使用来自FragmentTransaction的API.
可以按如下方法,从你的Activity取得一个FragmentTransaction的实例:
FragmentManagerfragmentManager=getFragmentManager（）;
FragmentTransactionfragmentTransaction=fragmentManager.beginTransaction（）;
然后你可以使用add（）方法添加一个fragment,指定要添加的fragment,和要插入的view.
ExampleFragmentfragment=
new
ExampleFragment（）;
fragmentTransaction.add（R.id.fragment_container,fragment）;
fragmentTmit（）;
add（）的第一个参数是fragment要放入的ViewGroup,由resourceID指定,第二个参数是需要添加的fragment.一旦用FragmentTransaction做了改变,为了使改变生效,必须调用commit（）.
添加一个无UI的fragment
之前的例子展示了对UI的支持,如何将一个fragment添加到activity.
然而,也可以使用fragment来为activity提供后台行为而不用展现额外的UI.
要添加一个无UI的fragment,需要从activity使用add（Fragment,String）来添加fragment（为fragment提供一个唯一的字符串"
tag"
而不是一个viewID）.这么做添加了fragment,但因为它没有关联到一个activitylayout中的一个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的实例:
每一个事务都是同时要执行的一套变化.可以在一个给定的事务中设置你想执行的所有变化,使用诸如add（）,remove（）,和replace（）.然后,要给activity应用事务,必须调用commit（）.
在调用commit（）之前,你可能想调用addToBackStack（）,将事务添加到一个fragment事务的backstack.
这个backstack由activity管理,并允许用户通过按下BACK按键返回到前一个fragment状态.
举个例子,这里是如何将一个fragment替换为另一个,并在后台堆栈中保留之前的状态:
//Create
fragmentandtransaction
FragmentnewFragment=
FragmentTransactiontransaction=getFragmentManager（）.beginTransaction（）;
//Replacewhateverisinthefragment_containerviewwith
this
fragment,
//andaddthetransactiontothebackstack
transaction.replace（R.id.fragment_container,newFragment）;
transaction.addToBackStack（null）;
//Committhetransaction
mit（）;
在这个例子中,newFragment替换了当前layout容器中的由R.id.fragment_container标识的fragment.通过调用addToBackStack（）,replace事务被保存到backstack,因此用户可以回退事务,并通过按下BACK按键带回前一个fragment.
如果添加多个变化到事务（例如add（）或remove（））并调用addToBackStack（）,然后在你调用commit（）之前的所有应用的变化会被作为一个单个事务添加到后台堆栈,BACK按键会将它们一起回退.
添加变化到FragmentTransaction的顺序不重要,除以下例外:
必须最后调用commit（）.
如果添加多个fragment到同一个容器,那么添加的顺序决定了它们在viewhierarchy中显示的顺序.
当执行一个移除fragment的事务时,如果没有调用addToBackStack（）,那么当事务提交后,那个fragment会被销毁,并且用户不能导航回到它.有鉴于此,当移除一个fragment时,如果调用了addToBackStack（）,那么fragment会被停止,如果用户导航回来,它将会被恢复.
提示:
对于每一个fragment事务,你可以应用一个事务动画,通过在提交事务之前调用setTransition（）实现.
调用commit（）并不立即执行事务.恰恰相反,它将事务安排排期,一旦准备好,就在activity的UI线程上运行（主线程）.如果有必要,无论如何,你可以从你的UI线程调用executePendingTransactions（）来立即执行由commit（）提交的事务.
但这么做通常不必要,除非事务是其他线程中的job的一个从属.
警告:
你只能在activity保存它的状态（当用户离开activity）之前使用commit（）提交事务.
如果你试图在那个点之后提交,会抛出一个异常.这是因为如果activity需要被恢复,提交之后的状态可能会丢失.对于你觉得可以丢失提交的状况,使用commitAllowingStateLoss（）.
与Activity通信
尽管Fragment被实现为一个独立于Activity的对象,并且可以在多个activity中使用,但一个给定的fragment实例是直接绑定到包含它的activity的.
特别的,fragment可以使用getActivity（）访问Activity实例,并且容易地执行比如在activitylayout中查找一个view的任务.
ViewlistView=getActivity（）.findViewById（R.id.list）;
同样地,activity可以通过从FragmentManager获得一个到Fragment的引用来调用fragment中的方法,使用findFragmentById（）或findFragmentByTag（）.
ExampleFragmentfragment=（ExampleFragment）getFragmentManager（）.findFragmentById（R.id.example_fragment）;
为Activity创建事件回调方法
在一些情况下,你可能需要一个fragment与activity分享事件.一个好的方法是在fragment中定义一个回调的interface,
升级会员 