【亲测免费】 MagicIndicator 使用教程

MagicIndicator 使用教程

项目介绍

MagicIndicator 是一个强大且高度可定制的 ViewPager 指示器框架，旨在替代 ViewPagerIndicator、TabLayout 和 PagerSlidingTabStrip。它提供了丰富的功能和灵活的扩展性，适用于各种复杂的导航栏需求。

项目快速启动

1. 添加依赖

首先，在项目的 build.gradle 文件中添加 MagicIndicator 的依赖：

dependencies {
    implementation 'com.github.hackware1993:MagicIndicator:1.7.0' // for AndroidX
}

2. 在布局文件中添加 MagicIndicator

在您的布局文件中添加 MagicIndicator 和 ViewPager：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <net.lucode.hackware.magicindicator.MagicIndicator
        android:id="@+id/magic_indicator"
        android:layout_width="match_parent"
        android:layout_height="40dp" />

    <androidx.viewpager.widget.ViewPager
        android:id="@+id/view_pager"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1" />
</LinearLayout>

3. 初始化 MagicIndicator

在您的 Activity 或 Fragment 中初始化 MagicIndicator：

MagicIndicator magicIndicator = findViewById(R.id.magic_indicator);
CommonNavigator commonNavigator = new CommonNavigator(this);
commonNavigator.setAdapter(new CommonNavigatorAdapter() {
    @Override
    public int getCount() {
        return mTitleDataList == null ? 0 : mTitleDataList.size();
    }

    @Override
    public IPagerTitleView getTitleView(Context context, final int index) {
        ColorTransitionPagerTitleView colorTransitionPagerTitleView = new ColorTransitionPagerTitleView(context);
        colorTransitionPagerTitleView.setText(mTitleDataList.get(index));
        colorTransitionPagerTitleView.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                mViewPager.setCurrentItem(index);
            }
        });
        return colorTransitionPagerTitleView;
    }

    @Override
    public IPagerIndicator getIndicator(Context context) {
        LinePagerIndicator indicator = new LinePagerIndicator(context);
        indicator.setMode(LinePagerIndicator.MODE_WRAP_CONTENT);
        return indicator;
    }
});
magicIndicator.setNavigator(commonNavigator);
ViewPagerHelper.bind(magicIndicator, mViewPager);

应用案例和最佳实践

案例一：底部导航栏

MagicIndicator 可以用于实现复杂的底部导航栏，支持图标和文本的颜色渐变，以及动画的回溯效果。以下是一个简单的实现示例：

// 初始化底部导航栏
MagicIndicator bottomNavIndicator = findViewById(R.id.bottom_nav_indicator);
CommonNavigator bottomNavigator = new CommonNavigator(this);
bottomNavigator.setAdapter(new CommonNavigatorAdapter() {
    @Override
    public int getCount() {
        return mBottomNavTitles.size();
    }

    @Override
    public IPagerTitleView getTitleView(Context context, final int index) {
        CommonPagerTitleView titleView = new CommonPagerTitleView(context);
        titleView.setContentView(R.layout.bottom_nav_item);
        titleView.setTitle(mBottomNavTitles.get(index));
        titleView.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                mViewPager.setCurrentItem(index);
            }
        });
        return titleView;
    }

    @Override
    public IPagerIndicator getIndicator(Context context) {
        LinePagerIndicator indicator = new LinePagerIndicator(context);
        indicator.setMode(LinePagerIndicator.MODE_WRAP_CONTENT);
        return indicator;
    }
});
bottomNavIndicator.setNavigator(bottomNavigator);
ViewPagerHelper.bind(bottomNavIndicator, mViewPager