©2023 RAKUS Co., Ltd. M3 NavigationBar をマスターする Shibuya.apk #45 2023/11/10 @akkiee76

Akihiko Sato 株式会社ラクス / 楽楽精算 / モバイル開発チーム @akkiee76 自己紹介

M3 NavigationBar 概要 ● 画面下部に表示し、ナビゲーションを提供するコンポーネント ● M2 BottomNavigation が M3 NavigationBar に名称変更 ● NavigationBar の要素は NavigationBarItem ● 「Bottom Navigation Views Activity」 は M3 Compose 非対応 https://developer.android.com/jetpack/compose/designsystems/material2-material3?hl=ja#bottom-navigation NavigationBar BottomNavigation

Implementation 1. NavigationBar を設定する 2. NavigationBarItem を追加する 3. 画面切り替えを行う 4. Badge を付ける

Let's Implement 🛠

1. NavigationBar を設定する Scaffold( bottomBar = { NavigationBar { } } ) { Surface( modifier = Modifier .padding(bottom = it.calculateBottomPadding()) ) { }

2. NavigationBarItem を追加する enum class NavigationItem ( val label: String, @DrawableRes val resId: Int ) { HOME("Home", R.drawable.ic_home), EXPLORE("Explore", R.drawable.ic_fmd_good), MESSAGE("Message", R.drawable.ic_chat), STARRED("For You", R.drawable.ic_star); }

Scaffold( bottomBar = { NavigationBar { NavigationItem.entries.forEach { item -> NavigationBarItem( selected = false, onClick = {}, icon = { Icon( painter = painterResource(id = item.resId), contentDescription = null ) }, label = { Text(text = item.label) } ) } } } 2. NavigationBarItem を追加する

NavigationBarItem の注意点（M3 Guidelines） OK Don’t ● ユーザにとって遷移が明確であること ● NavigationBarItem は 3 ~ 5 であること ● Label を表示すること https://m3.material.io/components/navigation-bar/guidelines

build.gradle.kts dependencies { implementation("androidx.navigation:navigation-compose:2.7.4" ) } val navController = rememberNavController () Scaffold(bottomBar = { // NavigationBar } ) { Surface(modifier = Modifier.padding(bottom = it.calculateBottomPadding())) { NavHost(navController = navController , startDestination = NavigationItem .HOME.route) { composable(NavigationItem .HOME.route) { HomeScreen() } composable(NavigationItem .EXPLORE.route) { ExploreScreen () } composable(NavigationItem .MESSAGE.route) { MessageScreen () } composable(NavigationItem .STARRED.route) { FavoriteScreen () } } 3. Navigation を行う

val navBackStackEntry by navController.currentBackStackEntryAsState() val destination = navBackStackEntry?.destination NavigationBar { NavigationItem.entries.forEach { item -> val selected = destination?.hierarchy ?.any { it.route == item.route } == true NavigationBarItem( selected = selected, onClick = { navController.navigate(item.route) { launchSingleTop = true } }, icon = { }, label = { } ) } } 3. Navigation を行う https://developer.android.com/jetpack/compose/navigation?hl=ja#bottom-nav

NavigationBarItem( icon = { BadgedBox( badge = { Badge() } ) { Icon( painter = painterResource(id = item.resId), contentDescription = null ) } 4. Badge を付ける

@ExperimentalMaterial3Api @Composable fun Badge( modifier: Modifier = Modifier, containerColor: Color = BadgeDefaults.containerColor, contentColor: Color = contentColorFor(containerColor), content: @Composable (RowScope.() -> Unit)? = null, ) BadgedBox( badge = { Badge { Text(text = "1") } }) { Icon( painter = painterResource(id = item.resId), contentDescription = null ) } 4. Badge を付ける（カスタマイズ）

Implementation completed 🛠

Material Design 3 Guidelines 👀

Item 設定の注意点 ● 選択時のアイコンは filled（塗りつぶし）を使用すること https://m3.material.io/components/navigation-bar/guidelines OK Caution ● Label は明確かつ十分なコントラストを設定すること OK Don’t Don’t

NavigationBarItem( selected = selected, onClick = onClick, icon = { val resId = if (selected) item.filledResId else item.outlinedResId Icon( painter = painterResource(id = resId), contentDescription = null ) }, label = { val fontWeight = if (selected) FontWeight.Bold else FontWeight.Normal Text( text = item.label, fontWeight = fontWeight ) } ) M3 Guidelines に準拠する

Implementation completed 🎉

まとめ ● NavigationBar は Item を content に指定するだけで 実装可能 ○ NavigationBarItem の Composable に詳細設定 ● M3 Guidelines のチェックも忘れずに

Thank you 🎉