运行时动态修改 BottomNavigationView 图标方法

本文深入探讨了在 Android 开发中如何动态更新 BottomNavigationView 图标以响应业务状态（如未读通知），既详细讲解了通过 Java 代码调用 `setIcon()` 手动替换图标的传统方案及其兼容性与维护隐患，更重点推荐并手把手演示了 Material 3 官方原生支持的 `Badge` 机制——只需几行代码即可实现语义清晰、深色模式自适应、带动画效果且无需额外资源的红点或数字徽章，兼顾设计规范性、开发效率与长期可维护性，是现代 Android 底部导航动态提示的首选实践。

本文详解如何通过 Java 代码在运行时动态更新 BottomNavigationView 中指定菜单项的图标（如未读通知红点图标），并推荐使用 Material 3 官方支持的 Badge 机制替代手动换图，兼顾规范性与可维护性。

本文详解如何通过 Java 代码在运行时动态更新 BottomNavigationView 中指定菜单项的图标（如未读通知红点图标），并推荐使用 Material 3 官方支持的 Badge 机制替代手动换图，兼顾规范性与可维护性。

在 Android 开发中，BottomNavigationView 是实现底部导航栏的标准组件。当需要根据业务状态（例如存在未读通知）动态改变某一项的视觉表现时，常见需求是高亮或替换图标。虽然可通过 setIcon() 手动切换图标资源，但 Material Design 3 更推荐使用 Badge（徽章） 进行未读提示——它语义清晰、适配深色模式、支持动画且无需额外图标资源。

✅ 推荐方案：使用 Badge（Material 3+）

自 Material Components 1.8.0 起，BottomNavigationView 原生支持 Badge API。只需调用 getOrCreateBadge() 即可为指定菜单项添加/更新徽章：

BottomNavigationView bottomNav = findViewById(R.id.bottomNavigationView);

// 假设 notification 菜单项的 ID 为 R.id.menu_notification
BadgeDrawable badge = bottomNav.getOrCreateBadge(R.id.menu_notification);
badge.setVisible(true);     // 显示徽章
badge.setNumber(3);         // 可选：显示数字（如“3”条未读）
badge.setBackgroundColor(ContextCompat.getColor(this, R.color.red_500));
badge.setTextColor(ContextCompat.getColor(this, R.color.white));

? 注意：R.id.menu_notification 必须与 @menu/bottom_nav.xml 中对应 的 android:id 一致。若仅需红点（无数字），调用 badge.setNumber(0) 并保持 setVisible(true) 即可渲染纯色圆点。

⚠️ 备用方案：手动更换图标（兼容旧版或特殊场景）

若因兼容性或设计需求必须更换图标（如使用带红点的静态 drawable），可通过 Menu API 操作：

Menu menu = bottomNav.getMenu();
MenuItem notificationItem = menu.findItem(R.id.menu_notification);
notificationItem.setIcon(R.drawable.ic_notification_red); // 替换为自定义图标

⚠️ 重要限制与注意事项：

• setIcon() 会完全替换原始图标，丢失 app:itemIconTint 的颜色控制；
• 图标尺寸需严格匹配（建议使用 vector drawable 并统一设置 android:width/height）；
• 若启用 app:labelVisibilityMode="labeled"，图标更换后文字颜色不受影响，但需确保新图标与文字的可读性对比度达标；
• 不推荐在 onCreate() 中直接调用 setIcon() —— 应确保 BottomNavigationView 已完成菜单 inflate（通常在 setOnItemSelectedListener 设置后操作更稳妥）。

✅ 最佳实践总结

最后提醒：无论采用哪种方式，请始终在主线程操作 UI，并在 Activity/Fragment 生命周期安全时调用（例如避免在 onDestroy() 后更新 Badge）。对于通知状态，建议将 Badge 更新逻辑封装进统一的通知管理器，便于后续扩展（如清除徽章、联动 Push 服务等）。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~