Android中BottomNavigation的actionLayout不生效问题求助

问题场景 #

开发BottomNavigation时，通过menu的actionLayout属性给导航项绑定了自定义布局文件，Menu预览中样式正常，但Activity里的BottomNavigationView无法显示自定义样式。

截图说明 #

• 主页面导航项样式未显示
• Menu XML中样式正常显示

相关代码 #

MainActivity.xml #

<com.google.android.material.bottomnavigation.BottomNavigationView
        android:id="@+id/bott_nav"
        android:layout_width="match_parent"
        android:layout_marginStart="10dp"
        android:layout_marginEnd="10dp"
        android:layout_marginBottom="10dp"
        android:background="@drawable/bottom_nav_bg"
        android:layout_height="wrap_content"
        android:layout_alignParentBottom="true"
        app:menu="@menu/navmenu"/>

navmenu.xml #

<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">

    <item
        android:id="@+id/home"
        android:title="Home"
        app:showAsAction="always"
        app:actionLayout="@layout/item_home"/>
  

</menu>

item_home.xml（自定义导航项布局） #

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:orientation="horizontal"
    android:background="@drawable/bg_full_rounded"
    android:gravity="center_vertical"
    android:paddingStart="@dimen/_5sdp"
    android:paddingEnd="@dimen/_5sdp"
    android:backgroundTint="@color/itemTranBg"
    android:paddingTop="@dimen/_3sdp"
    android:paddingBottom="@dimen/_3sdp">

    <ImageView
        android:layout_width="@dimen/_15sdp"
        android:layout_height="@dimen/_15sdp"
        android:src="@drawable/ic_homeicon"/>

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textColor="@color/primaryDark"
        android:layout_marginStart="@dimen/_5sdp"
        android:text="Home"/>

</LinearLayout>

解决步骤 #

BottomNavigationView不支持通过XML的actionLayout直接加载自定义布局，必须通过代码手动绑定：

1. 在Activity中获取BottomNavigationView实例，遍历菜单项并设置自定义视图：

val bottomNav = findViewById<BottomNavigationView>(R.id.bott_nav)
val menu = bottomNav.menu

for (i in 0 until menu.size()) {
    val menuItem = menu.getItem(i)
    // 根据菜单项ID匹配对应自定义布局，多导航项可分支处理
    val layoutId = when(menuItem.itemId) {
        R.id.home -> R.layout.item_home
        // 其他导航项的布局ID
        else -> R.layout.item_home
    }
    val customView = LayoutInflater.from(this).inflate(layoutId, null)
    menuItem.actionView = customView
}

2. 给自定义视图绑定点击事件，确保选中状态同步：

customView.setOnClickListener {
    bottomNav.selectedItemId = menuItem.itemId
    // 此处添加页面切换等业务逻辑
}

3. 额外注意点：

• 自定义布局高度不要超过BottomNavigationView的高度，可设置android:layout_height="match_parent"或适配wrap_content避免布局截断
• 若使用了app:labelVisibilityMode，建议设置为labelVisibilityMode="labeled"，或隐藏menu中默认title避免重复显示
• 检查自定义布局中的资源引用（如dimen、drawable、color）是否存在，防止因资源缺失导致布局不显示

内容的提问来源于stack exchange，提问作者VUELOVER