Fragment简介
Fragment(翻译为片段)可以作为Activity 布局的一部分,必须依托于Activity,但又拥有自己的生命周期。其生命周期同时受到宿主Activity生命周期的影响。例如,当 Activity 暂停时,Activity 的所有片段也会暂停;当 Activity 被销毁时,所有片段也会被销毁。
不过,当 Activity 正在运行(处于onResume生命周期状态)时,您可以独立操纵每个片段,如添加或移除片段。当执行此类片段事务时,您也可将其添加到由 Activity 管理的返回栈 — Activity 中的每个返回栈条目都是一条已发生片段事务的记录。
生命周期
image.png其中,onCreate()
、onStart()
、onPause()
和 onStop()
方法和Activity 非常相似。所以Google官方称Fragment有点像可以在不同 Activity 中重复使用的“子 Activity”。
onAttach():在片段已与 Activity 关联时进行调用(Activity
传递到此方法内)。
onCreate():系统会在创建片段时调用此方法。
onCreateView():系统会在片段首次绘制其界面布局时调用此方法。所以返回的 View
必须是片段布局的根视图。为方便返回视图,onCreateView()
提供(传入)了一个 LayoutInflater
对象,直接使用即可。
onActivityCreated():当 Activity 的 onCreate()
方法已返回时进行调用。
onCreate()
、onStart()
、onPause()
和 onStop()
与Activity的生命周期方法一致。
//布局的资源 ID,将作为扩展布局父项的 ViewGroup,
//是否在扩展期间将扩展布局附加至 ViewGroup【这里传TRUE则会多一个扩展视图】
return inflater.inflate(R.layout.example_fragment, container, false)
基本使用
- 1.布局中使用(静态使用)
<fragment
android:id="@+id/fragment"
android:name=".DemoFragment"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
注意别忘了id。
- 2.代码中使用(动态添加)
首先xml文件中得有个存放该Fragment的ViewGroup。不知道用哪个viewGroup就写androidx.fragment.app.FragmentContainerView
。
如要在您的 Activity 中执行片段事务(如添加、移除或替换片段),则必须使用 FragmentTransaction
中的 API。如下所示,您可以从 FragmentActivity
获取一个 FragmentTransaction
实例:
val fragmentManager = supportFragmentManager
val fragmentTransaction = fragmentManager.beginTransaction()
然后,您可以使用 add()
方法添加一个片段,指定要添加的片段以及将其插入哪个视图。例如:
val fragment = ExampleFragment()
fragmentTransaction.add(R.id.fragment_container, fragment)
fragmentTransaction.commit()
传递到 add()
的第一个参数是 ViewGroup
的id,即应放置片段的位置,由资源 ID 指定,第二个参数是要添加的片段。
一旦您通过 FragmentTransaction
做出了更改,就必须调用 commit()
以使更改生效。
上面代码中用到了fragmentManager
对象,它是用来管理Fragment的类。比如:
- 通过
findFragmentById()
(针对在 Activity 布局中提供界面的片段)或findFragmentByTag()
(针对提供或不提供界面的片段)获取 Activity 中存在的片段。 - 通过
popBackStack()
(模拟用户发出的返回命令)使片段从返回栈中弹出。 - 通过
addOnBackStackChangedListener()
注册侦听返回栈变化的侦听器。
从manager中获取到的管理相关类中有一个FragmentTransaction。transaction译为交易,这里指片段执行添加(add)、移除(remove)、替换(replace)以及其他操作,从而响应用户交互,所以官网 称之为片段事务。
然后,如要将事务应用到 Activity,您必须调用 commit()
。
在调用 commit()
之前,可以调用 addToBackStack()
,以将事务添加到片段事务返回栈。该返回栈由 Activity 管理,允许用户通过按返回按钮返回上一片段状态。
image.png提示:对于每个片段事务,您都可通过在提交前调用
setTransition()
来应用过渡动画。
与 Activity 通信
Fragment中获取Activity对象
片段可通过 getActivity()
访问 FragmentActivity
实例,并轻松执行在 Activity 布局中查找视图等任务:
val listView: View? = activity?.findViewById(R.id.list)
Activity中获取Fragment
主要是用到了上文说的fragmentManager来获取。
val fragment = supportFragmentManager.findFragmentById(R.id.example_fragment) as ExampleFragment
既然能取到Fragment对象,便可在Fragment中定义一个接口,然后在Activity中实现相关方法,从而完成事件回调。如下:
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:
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:
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()
。
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的方式进行通信。
常见错误:
Binary XML file line #?? Error inflating class fragment
- 先检查是否给了id 和name;
- 如果是动态加载,注意别用<fragment> 标签,改用一个ViewGroup,不知道用哪个就写
FragmentContainerView
; - 检查导包有没有导错,有v4下的,也有androidx下的,别弄混了。
网友评论