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