基于Kotlin的移动端动态导航组件实现方案咨询

1. 定义导航项数据模型 #

先创建一个数据类统一管理导航项的核心信息，方便后续根据角色动态生成菜单：

data class NavItem(
    val id: Int,
    val title: String,
    val iconResId: Int,
    val fragmentClass: Class<*>
)

2. 按用户角色配置导航项集合 #

根据不同用户角色，预定义对应的导航项列表：

object NavConfig {
    // 用户1的导航项
    val USER_1_ITEMS = listOf(
        NavItem(1, "Profile", R.drawable.ic_profile, ProfileFragment::class.java),
        NavItem(2, "Email", R.drawable.ic_email, EmailFragment::class.java)
    )

    // 用户2的导航项
    val USER_2_ITEMS = listOf(
        NavItem(1, "Profile", R.drawable.ic_profile, ProfileFragment::class.java),
        NavItem(3, "Location", R.drawable.ic_location, LocationFragment::class.java),
        NavItem(2, "Email", R.drawable.ic_email, EmailFragment::class.java),
        NavItem(4, "Holiday", R.drawable.ic_holiday, HolidayFragment::class.java),
        NavItem(5, "Leave", R.drawable.ic_leave, LeaveFragment::class.java)
    )

    // 根据用户角色获取对应导航项
    fun getNavItems(userRole: String): List<NavItem> {
        return when(userRole) {
            "USER_1" -> USER_1_ITEMS
            "USER_2" -> USER_2_ITEMS
            else -> emptyList() // 默认空列表或基础项
        }
    }
}

3. 动态加载侧边导航菜单 #

根据你使用的侧边栏组件，分两种常见实现方式：

方式一：使用NavigationView（原生菜单组件）

登录成功后，清空原有菜单并动态添加对应项：

fun setupDynamicNavMenu(navigationView: NavigationView, userRole: String) {
    val menu = navigationView.menu
    menu.clear() // 清空默认菜单

    val navItems = NavConfig.getNavItems(userRole)
    navItems.forEach { item ->
        menu.add(Menu.NONE, item.id, Menu.NONE, item.title)
            .setIcon(item.iconResId)
    }

    // 处理菜单点击跳转
    navigationView.setNavigationItemSelectedListener { menuItem ->
        val navItem = navItems.find { it.id == menuItem.itemId }
        navItem?.let {
            replaceFragment(it.fragmentClass)
        }
        drawerLayout.closeDrawers()
        true
    }
}

// Fragment切换工具方法
private fun replaceFragment(fragmentClass: Class<*>) {
    val fragment = fragmentClass.newInstance()
    supportFragmentManager.beginTransaction()
        .replace(R.id.fragment_container, fragment)
        .commit()
}

方式二：使用RecyclerView（更灵活的自定义侧边栏）

自定义Adapter绑定导航项数据，登录后更新Adapter的数据集：

class NavAdapter(private var navItems: List<NavItem>, private val onItemClick: (NavItem) -> Unit) :
    RecyclerView.Adapter<NavAdapter.ViewHolder>() {

    inner class ViewHolder(itemView: View) : RecyclerView.ViewHolder(itemView) {
        fun bind(item: NavItem) {
            itemView.tv_title.text = item.title
            itemView.iv_icon.setImageResource(item.iconResId)
            itemView.setOnClickListener { onItemClick(item) }
        }
    }

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): ViewHolder {
        val view = LayoutInflater.from(parent.context)
            .inflate(R.layout.item_nav, parent, false)
        return ViewHolder(view)
    }

    override fun onBindViewHolder(holder: ViewHolder, position: Int) {
        holder.bind(navItems[position])
    }

    override fun getItemCount() = navItems.size

    // 更新导航项数据
    fun updateItems(newItems: List<NavItem>) {
        navItems = newItems
        notifyDataSetChanged()
    }
}

// 登录成功后更新Adapter
fun setupRecyclerViewNav(userRole: String) {
    val navItems = NavConfig.getNavItems(userRole)
    navAdapter.updateItems(navItems)

    // 处理点击跳转
    navAdapter.onItemClick = { item ->
        replaceFragment(item.fragmentClass)
        drawerLayout.closeDrawers()
    }
}

4. 状态管理与持久化 #

• 登录成功后，将用户角色信息存储在SharedPreferences或ViewModel中，确保App重启或切换页面时能正确加载对应导航项。
• 在App启动时，检查是否已登录，若已登录则直接根据保存的角色加载导航菜单。

5. 注意事项 #

• 确保新增的EmailFragment、LocationFragment等已正确创建，继承自Fragment。
• 如果使用Jetpack Navigation组件，可以将导航项与NavGraph结合，通过动态修改NavGraph的节点来实现，但上述基础方案更轻量直接。
• 侧边栏的默认HomeFragment可以作为全局默认项，或者根据需求加入角色配置中。

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