MagicHeaderViewPager 使用教程

伏保淼

于 2024-09-09 09:58:46 发布

阅读量884

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_01097/article/details/142050587

MagicHeaderViewPager 使用教程

MagicHeaderViewPagerAndroid HeaderViewPager control. A ViewPager with a header can be fixed and many scrollable Fragments (listFragments, gridFragments and ScrollFragments) inside.项目地址:https://gitcode.com/gh_mirrors/ma/MagicHeaderViewPager

1、项目介绍

MagicHeaderViewPager 是一个 Android 开源库，旨在提供一个带有固定头部的 ViewPager，并且可以在其中嵌入多个可滚动的 Fragment（如列表型 Fragment、网格型 Fragment 和自定义滚动 Fragment）。该项目的主要特点包括：

固定头部：支持固定头部的 ViewPager，头部可以随着用户的滚动自由调整。
大标题支持：支持高度超过屏幕的大标题。
混合列表项：支持混合类型的 ListView 项，且项的高度可以不同。
下拉刷新：与下拉刷新功能无缝集成。
触摸事件处理：内外部滚动视图可以独立响应触摸事件，避免滚动冲突。

尽管该项目已被归档，但它仍然是 Android 开发者工具箱中的宝贵遗产，特别是对于那些寻求在 APP 内实现创新导航方式的开发者们。

2、项目快速启动

2.1 添加依赖

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

dependencies {
    implementation 'com.culiu.android:mhvp-core:2.1.2@aar'
    // 如果需要集成下拉刷新功能
    implementation 'com.culiu.android:mhvp-integrated-ptr:2.1.2@aar'
}

2.2 布局文件

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

<com.culiu.android.mhvp.MagicHeaderViewPager
    android:id="@+id/magic_header_view_pager"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

2.3 代码实现

在你的 Activity 或 Fragment 中初始化 MagicHeaderViewPager：

MagicHeaderViewPager magicHeaderViewPager = findViewById(R.id.magic_header_view_pager);

// 设置头部视图
View headerView = LayoutInflater.from(this).inflate(R.layout.header_layout, null);
magicHeaderViewPager.setHeaderView(headerView);

// 添加 Fragment
List<Fragment> fragments = new ArrayList<>();
fragments.add(new ListFragment());
fragments.add(new GridFragment());
fragments.add(new ScrollFragment());

FragmentPagerAdapter adapter = new FragmentPagerAdapter(getSupportFragmentManager()) {
    @Override
    public Fragment getItem(int position) {
        return fragments.get(position);
    }

    @Override
    public int getCount() {
        return fragments.size();
    }
};

magicHeaderViewPager.setAdapter(adapter);