【亲测免费】 BottomNavigationViewEx 使用教程

项目介绍

BottomNavigationViewEx 是一个增强版的 BottomNavigationView 库，旨在提供更多的自定义选项和功能，以满足开发者对底部导航栏的更高需求。该库基于 Android 官方的 BottomNavigationView，通过添加额外的方法和属性，使得导航栏的使用更加灵活和强大。

项目快速启动

添加依赖

首先，在你的 build.gradle 文件中添加以下依赖：

implementation 'com.github.ittianyu:BottomNavigationViewEx:2.0.4'

布局文件

在你的布局文件中使用 BottomNavigationViewEx：

<com.ittianyu.bottomnavigationviewex.BottomNavigationViewEx
    android:id="@+id/bnve"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_alignParentBottom="true"
    android:background="@color/colorPrimary"
    app:itemIconTint="@color/selector_item_color"
    app:itemTextColor="@color/selector_item_color"
    app:menu="@menu/menu_navigation_with_view_pager" />

代码绑定

在你的 Activity 或 Fragment 中绑定视图并进行自定义设置：

BottomNavigationViewEx bnve = (BottomNavigationViewEx) findViewById(R.id.bnve);

// 禁用所有动画
bnve.enableAnimation(false);
bnve.enableShiftingMode(false);
bnve.enableItemShiftingMode(false);

// 自定义图标和文字大小
bnve.setIconSize(24, 24);
bnve.setTextSize(12);

// 绑定 ViewPager
ViewPager viewPager = findViewById(R.id.view_pager);
viewPager.setAdapter(new VpAdapter(getSupportFragmentManager()));
bnve.setupWithViewPager(viewPager);

应用案例和最佳实践

禁用动画和模式

在某些情况下，你可能希望禁用 BottomNavigationView 的动画和模式，以提供更简洁的用户体验。以下是如何禁用这些功能的示例：

bnve.enableAnimation(false);
bnve.enableShiftingMode(false);
bnve.enableItemShiftingMode(false);

自定义图标和文字大小

通过设置图标和文字的大小，可以使 BottomNavigationView 更符合你的设计需求：

bnve.setIconSize(24, 24);
bnve.setTextSize(12);

绑定 ViewPager

将 BottomNavigationViewEx 与 ViewPager 结合使用，可以实现页面之间的平滑切换：

ViewPager viewPager = findViewById(R.id.view_pager);
viewPager.setAdapter(new VpAdapter(getSupportFragmentManager()));
bnve.setupWithViewPager(viewPager);

典型生态项目

结合 ViewPager2

虽然 BottomNavigationViewEx 主要与 ViewPager 结合使用，但也可以与 ViewPager2 结合，以利用其更现代的特性和改进的性能：

ViewPager2 viewPager2 = findViewById(R.id.view_pager2);
viewPager2.setAdapter(new Vp2Adapter(this));
bnve.setupWithViewPager2(viewPager2);

结合 Fragment

通过将 BottomNavigationViewEx 与 Fragment 结合使用，可以实现更复杂的导航结构和页面管理：

bnve.setOnNavigationItemSelectedListener(item -> {
    switch (item.getItemId()) {
        case R.id.navigation_home:
            getSupportFragmentManager().beginTransaction().replace(R.id.container, new HomeFragment()).commit();
            return true;
        case R.id.navigation_dashboard:
            getSupportFragmentManager().beginTransaction().replace(R.id.container, new DashboardFragment()).commit();
            return true;
        case R.id.navigation_notifications:
            getSupportFragmentManager().beginTransaction().replace(R.id.container, new NotificationsFragment()).commit();
            return true;
    }
    return false;
});

通过这些示例和最佳实践，你可以充分利用 BottomNavigationViewEx 库，为你的 Android 应用创建一个强大且灵活的底部导航栏。