引数を渡す
遷移先にデータを送ります
「引数を渡す」はCoddyKit上の無料Android Academyレッスンです。 これはレッスン3/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはAndroid Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Android Academyコースには全4レッスンが含まれています。
画面間でデータを渡す
遷移先では、表示する項目のIDなどのデータが必要になることがあります。Navigation Composeでは、URLと同じように、引数をルートに直接組み込みます。
プレースホルダーを含むルート
波かっこを使って、ルートにプレースホルダーを宣言します。ここで{id}は、idという名前の引数です。
composable("details/{id}") { backStackEntry ->
// read id here
}引数の型を宣言する
argumentsとnavArgumentを使って、引数の型をナビゲーターに伝えます。値の検証と変換は自動的に行われます。
composable(
"details/{id}",
arguments = listOf(navArgument("id") { type = NavType.IntType })
) { /* ... */ }NavType
NavTypeで引数のデータ型を宣言します。IntType、StringType、BoolTypeなどを指定でき、ナビゲーターがルートの値を適切に解析します。
引数を読み取る
遷移先のラムダにはbackStackEntryが渡されます。backStackEntry.argumentsから引数を読み取ります。
composable(
"details/{id}",
arguments = listOf(navArgument("id") { type = NavType.IntType })
) { backStackEntry ->
val id = backStackEntry.arguments?.getInt("id") ?: 0
DetailsScreen(id = id)
}値を指定して移動する
画面を開くには、プレースホルダーを実際の値に置き換えてルート文字列を作成します。
navController.navigate("details/42")安全にルートを作成する
文字列テンプレートを使って値を挿入します。パスのセグメントが、宣言したルートと完全に一致するようにしてください。
val itemId = 42
navController.navigate("details/$itemId")オプションの引数
オプションの引数には、?name=valueのようなクエリ文字列形式とdefaultValueを使用します。ナビゲーション時に省略できます。
composable(
"search?query={query}",
arguments = listOf(navArgument("query") {
defaultValue = ""
})
) { /* ... */ }文字列の引数には注意が必要
文字列の引数はURLで安全に扱える形式でなければなりません。長いテキストやスラッシュをルート経由で渡すのは避け、そのような場合はIDをキーにした共有ViewModelまたはリポジトリを使用してください。
オブジェクトではなくIDを渡す
ベストプラクティスは、項目IDなどの小さな識別子をルート経由で渡し、遷移先の画面で完全なオブジェクトを取得することです。大きなオブジェクトをルートにシリアライズしないでください。
全体を組み合わせる
一覧画面から詳細画面へ移動し、選択したIDを渡します。
composable("list") {
ListScreen(onItemClick = { id ->
navController.navigate("details/$id")
})
}
composable(
"details/{id}",
arguments = listOf(navArgument("id") { type = NavType.IntType })
) { entry ->
val id = entry.arguments?.getInt("id") ?: 0
DetailsScreen(id = id)
}理解度チェック
ルートで、idという名前の必須の整数引数をどのように宣言しますか。
まとめ
引数の受け渡し:
- ルートに
{placeholder}を記述します。 navArgumentとNavTypeで型を宣言します。backStackEntry.argumentsから読み取ります。- 値を置き換えてナビゲーションし、大きなオブジェクトではなく小さなIDを渡します。
よくある質問
「引数を渡す」レッスンは無料ですか？
はい。「引数を渡す」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Android Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Android Academyコースには全4レッスンが含まれています。
「引数を渡す」で何を学びますか？
遷移先にデータを送ります ブラウザで直接実行するハンズオンコードでAndroid Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
Android Academyを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのAndroid Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン3/4です。
「引数を渡す」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このAndroid Academyレッスンでコードを書いて実行できますか？
はい。すべてのAndroid Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。