[Day12] Android - Kotlin笔记：JetPack - Fragments在Navigation中的参数传递(Safe Args)

Fragments在Navigation中的参数传递 - SafeArgs

继上篇我们得知如何运用Navigation在Fragment中做页面切换。
而今天要讲的是Safe Args，
他的作用是在Fragment中页面切换时，传递参数(Arguments)。

首先要在app的build.gradle加入:

dependencies {
    implementation("androidx.navigation:navigation-runtime-ktx:2.3.5")
    implementation("androidx.navigation:navigation-fragment-ktx:2.3.5")
    implementation("androidx.navigation:navigation-ui-ktx:2.3.5")
}

module层的build.gradle

apply plugin: "androidx.navigation.safeargs.kotlin"

我们将昨天的navigation.xml打开，会看到所有页面。

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    xmlns:android="http://schemas.android.com/apk/res/android"
    app:startDestination="@id/aFragment"
    android:id="@+id/nav_graph">
    <fragment
        android:id="@+id/aFragment"
        android:name="com.example.cashdog.cashdog.AFragment"
        android:label="@string/label_blank"
        tools:layout="@layout/fragment_blank" >
        <action
            android:id="@+id/action_aFragment_to_bFragment"
            app:destination="@id/bFragment" />
    </fragment>
    <fragment
        android:id="@+id/bFragment"
        android:name="com.example.cashdog.cashdog.BFragment"
        android:label="@string/label_blank_2"
        tools:layout="@layout/fragment_blank_fragment2" />
</navigation>

假设我们要从AFragment传递参至BFragment，
会在BFragment底下加入：

<argument
        android:name="userName"
        app:argType="string" 
        app:nullable="false"/>

• android:name: 可以视为argument的id
• app:nullable: AFragment页面转到BFragment时，是否为必传值。false为必填，true可不填。
• app:argType: argument的型态。

app:argType能选择的类型有：

加入navigation.xml中，会像这样：

<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    xmlns:android="http://schemas.android.com/apk/res/android"
    app:startDestination="@id/aFragment"
    android:id="@+id/nav_graph">
    <fragment
        android:id="@+id/aFragment"
        android:name="com.example.cashdog.cashdog.AFragment"
        android:label="@string/label_blank"
        tools:layout="@layout/fragment_blank" >
        <action
            android:id="@+id/action_aFragment_to_bFragment"
            app:destination="@id/bFragment" />
    </fragment>
    <fragment
        android:id="@+id/bFragment"
        android:name="com.example.cashdog.cashdog.BFragment"
        android:label="@string/label_blank_2"
        tools:layout="@layout/fragment_blank_fragment2">
        <argument
            android:name="userName"
            app:argType="string" 
            app:nullable="false"/>
    </fragment>
</navigation>

传递args的方式

直接将要传递的参数写入actionAFragmentToBFragment(argument)中，

val action = AFragmentDirections.actionAFragmentToBFragment(userName)

class AFragment : Fragment() {
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        view.findViewById<Button>(R.id.next)
            .setOnClickListener {
                val action = AFragmentDirections.actionAFragmentToBFragment(userName)
                view.findNavController().navigate(action)
            }
    }
}

取得args的方式 - by navArgs

在BFragment中取得传递过来的argument包裹：

val args by navArgs<BFragmentArgs>()

直接获取argument中的内容方式如下：

val userName = args.userName

class BFragment : Fragment() {

    private val args by navArgs<BFragmentArgs>()

    ...
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        val userName = args.userName
    
     }
     ...

}

比起以前的写法相较快很多：

val userName = arguments?.getString("userName") ?: ""

参考：

• https://developer.android.com/kotlin/ktx#kts
• https://willy2016.pixnet.net/blog/post/216922818-android-kotlin-java-jetpack-navigation-(%E4%BA%8C)-safe-args-%E4%BB%8B