Fragment学习

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 管理，允许用户通过按返回按钮返回上一片段状态。

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

image.png

与 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

1. 先检查是否给了id 和name;
2. 如果是动态加载，注意别用<fragment> 标签，改用一个ViewGroup，不知道用哪个就写FragmentContainerView;
3. 检查导包有没有导错，有v4下的，也有androidx下的，别弄混了。