Fragment简介

Fragment(翻译为片段)可以作为Activity 布局的一部分,必须依托于Activity,但又拥有自己的生命周期。其生命周期同时受到宿主Activity生命周期的影响。例如,当 Activity 暂停时,Activity 的所有片段也会暂停;当 Activity 被销毁时,所有片段也会被销毁。

不过,当 Activity 正在运行(处于onResume生命周期状态)时,您可以独立操纵每个片段,如添加或移除片段。当执行此类片段事务时,您也可将其添加到由 Activity 管理的返回栈 — Activity 中的每个返回栈条目都是一条已发生片段事务的记录。

生命周期

image-20201107112249695

其中,onCreate()onStart()onPause()onStop()方法和Activity 非常相似。所以Google官方称Fragment有点像可以在不同 Activity 中重复使用的“子 Activity”。

onAttach():在片段已与 Activity 关联时进行调用(Activity 传递到此方法内)。

onCreate():系统会在创建片段时调用此方法。

[onCreateView()](https://developer.android.com/reference/androidx/fragment/app/Fragment#onCreateView(android.view.LayoutInflater, android.view.ViewGroup, android.os.Bundle)):系统会在片段首次绘制其界面布局时调用此方法。所以返回的 View 必须是片段布局的根视图。为方便返回视图,onCreateView() 提供(传入)了一个 LayoutInflater 对象,直接使用即可。

onActivityCreated():当 Activity 的 onCreate() 方法已返回时进行调用。

onCreate()onStart()onPause()onStop()与Activity的生命周期方法一致。

1
2
3
//布局的资源 ID,将作为扩展布局父项的 ViewGroup,
//是否在扩展期间将扩展布局附加至 ViewGroup【这里传TRUE则会多一个扩展视图】
return inflater.inflate(R.layout.example_fragment, container, false)

基本使用

  • 1.布局中使用(静态使用)<略>
  • 2.代码中使用(动态添加)

如要在您的 Activity 中执行片段事务(如添加、移除或替换片段),则必须使用 FragmentTransaction 中的 API。如下所示,您可以从 FragmentActivity 获取一个 FragmentTransaction 实例:

1
2
val fragmentManager = supportFragmentManager
val fragmentTransaction = fragmentManager.beginTransaction()

然后,您可以使用 add() 方法添加一个片段,指定要添加的片段以及将其插入哪个视图。例如:

1
2
3
val fragment = ExampleFragment()
fragmentTransaction.add(R.id.fragment_container, fragment)
fragmentTransaction.commit()

传递到 add() 的第一个参数是 ViewGroup,即应放置片段的位置,由资源 ID 指定,第二个参数是要添加的片段。

一旦您通过 FragmentTransaction 做出了更改,就必须调用 commit() 以使更改生效。


上面代码中用到了fragmentManager对象,它是用来管理Fragment的类。比如:

  • 通过 findFragmentById()(针对在 Activity 布局中提供界面的片段)或 findFragmentByTag()(针对提供或不提供界面的片段)获取 Activity 中存在的片段。
  • 通过 popBackStack()(模拟用户发出的返回命令)使片段从返回栈中弹出。
  • 通过 addOnBackStackChangedListener() 注册侦听返回栈变化的侦听器。

从manager中获取到的管理相关类中有一个FragmentTransaction。transaction译为交易,这里指片段执行添加(add)、移除(remove)、替换(replace)以及其他操作,从而响应用户交互,所以官网 称之为片段事务

然后,如要将事务应用到 Activity,您必须调用 commit()

在调用 commit() 之前,可以调用 addToBackStack(),以将事务添加到片段事务返回栈。该返回栈由 Activity 管理,允许用户通过按返回按钮返回上一片段状态。

提示:对于每个片段事务,您都可通过在提交前调用 setTransition() 来应用过渡动画。

image-20201107120536097

与 Activity 通信

Fragment中获取Activity对象

片段可通过 getActivity() 访问 FragmentActivity 实例,并轻松执行在 Activity 布局中查找视图等任务:

1
val listView: View? = activity?.findViewById(R.id.list)

Activity中获取Fragment

主要是用到了上文说的fragmentManager来获取。

1
val fragment = supportFragmentManager.findFragmentById(R.id.example_fragment) as ExampleFragment

既然能取到Fragment对象,便可在Fragment中定义一个接口,然后在Activity中实现相关方法,从而完成事件回调。如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
public class FragmentA : ListFragment() {

var listener: OnArticleSelectedListener? = null
...
override fun onAttach(context: Context) {
super.onAttach(context)
listener = context as? OnArticleSelectedListener
if (listener == null) {
throw ClassCastException("$context must implement OnArticleSelectedListener")
}

}
// Container Activity must implement this interface
interface OnArticleSelectedListener {
fun onArticleSelected(articleUri: Uri)
}
...
}

更多情况下,Google官方更推荐我们使用ViewModle来进行在片段之间的共享数据。上面代码只提供了事件处理和控件共享。

向应用栏(ActionBar/Toolbar)添加项目

您的片段可通过实现 onCreateOptionsMenu() 向 Activity 的选项菜单(并因此向应用栏)贡献菜单项。不过,为使此方法能够收到调用,您必须在 onCreate() 期间调用 setHasOptionsMenu(),以指示片段想要向选项菜单添加菜单项。否则,片段不会收到对 onCreateOptionsMenu() 的调用。

选定菜单项时,片段还会收到对 onOptionsItemSelected() 的回调。【是通过Activity 的回调传递而来,如果 Activity 对 on-item-selected 回调的实现不处理选定的菜单项,则系统会将事件传递至片段的回调。】

您还可通过调用 registerForContextMenu(),在片段布局中注册一个视图来提供上下文菜单。当用户打开上下文菜单时,片段会收到对 onCreateContextMenu() 的调用。当用户选择某个菜单项时,片段会收到对 onContextItemSelected() 的调用。

Fragment之间数据传递

Fragment 1.3.0-alpha04 开始,每个 FragmentManager 都会实现 FragmentResultOwner。即数据存放在Fragment中,Fragment彼此之间无须彼此引用,只需监听结果即可。

如需将数据从 Fragment B 传回到 Fragment A,只需要在A中设置监听器 setFragmentResultListener(),B中使用 setFragmentResult() API进行操作即可。

FragmentA:

1
2
3
4
5
6
7
8
9
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// Use the Kotlin extension in the fragment-ktx artifact
setResultListener("requestKey") { key, bundle ->
// We use a String here, but any type that can be put in a Bundle is supported
val result = bundle.getString("bundleKey")
// Do something with the result...
}
}

FragmentB:

1
2
3
4
5
button.setOnClickListener {
val result = "result"
// Use the Kotlin extension in the fragment-ktx artifact
setResult("requestKey", bundleOf("bundleKey" to result))
}

在父级 Fragment 和子级 Fragment 之间传递结果

如需将结果从子级 Fragment 传递到父级 Fragment,父级 Fragment 在调用 setFragmentResultListener() 时应使用 getChildFragmentManager()

1
2
3
4
5
6
7
8
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// We set the listener on the child fragmentManager
childFragmentManager.setResultListener("requestKey") { key, bundle ->
val result = bundle.getString("bundleKey")
// Do something with the result..
}
}

最后,Fragment作为一个独立的界面组件,是可复用的。所以Google再次推荐使用ViewModle+LiveData的方式进行通信。