如何编程控制Android ViewPager2的初始显示页面与页面切换

在Android应用开发中，ViewPager2作为替代旧版ViewPager的组件，具备更灵活的页面管理能力和更好的兼容性，支持垂直和水平滑动，也支持Fragment和普通View作为页面内容。很多业务场景需要我们主动控制ViewPager2的初始显示页面，或者根据用户的操作、定时任务等触发页面切换，下面详细介绍具体的实现方法。

控制ViewPager2初始显示页面

ViewPager2提供了setCurrentItem方法来设置当前显示的页面，我们可以在ViewPager2初始化完成、适配器设置完毕之后调用这个方法，指定初始显示的页面位置。页面位置是从0开始计数的，也就是说第一个页面的位置是0，第二个是1，以此类推。

需要注意，setCurrentItem有两个重载方法，一个是setCurrentItem(int item)，切换页面时会有默认的平滑滚动动画；另一个是setCurrentItem(int item, boolean smoothScroll)，第二个参数可以控制是否开启平滑滚动，如果不需要动画可以传入false。

以下是一个简单的初始化ViewPager2并设置初始页面的示例代码：

// 获取ViewPager2实例
ViewPager2 viewPager2 = findViewById(R.id.view_pager2);
// 创建适配器并设置
MyPagerAdapter adapter = new MyPagerAdapter();
viewPager2.setAdapter(adapter);
// 设置初始显示第2个页面（位置为1），带平滑滚动动画
viewPager2.setCurrentItem(1);
// 如果不需要动画，可以这样写
// viewPager2.setCurrentItem(1, false);

实现ViewPager2的页面切换

手动触发页面切换

手动触发页面切换的场景通常是用户点击了某个按钮、导航项等，此时直接调用setCurrentItem方法即可，和设置初始页面的逻辑一致。我们可以给按钮设置点击事件，在点击回调中切换页面。

// 切换到下一个页面
Button nextBtn = findViewById(R.id.next_btn);
nextBtn.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        int currentItem = viewPager2.getCurrentItem();
        // 获取适配器中的页面总数
        int totalCount = viewPager2.getAdapter().getItemCount();
        // 如果当前不是最后一页，切换到下一页
        if (currentItem < totalCount - 1) {
            viewPager2.setCurrentItem(currentItem + 1);
        }
    }
});

// 切换到上一个页面
Button prevBtn = findViewById(R.id.prev_btn);
prevBtn.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        int currentItem = viewPager2.getCurrentItem();
        // 如果当前不是第一页，切换到上一页
        if (currentItem > 0) {
            viewPager2.setCurrentItem(currentItem - 1);
        }
    }
});

自动定时页面切换

有些场景需要实现轮播效果，也就是定时自动切换页面，这时候我们可以结合Handler或者协程来实现定时任务。使用Handler的话，需要注意在页面销毁时移除回调，避免内存泄漏。

private Handler autoSwitchHandler = new Handler(Looper.getMainLooper());
private Runnable autoSwitchRunnable;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    // 初始化ViewPager2的代码省略
    // 初始化自动切换任务
    autoSwitchRunnable = new Runnable() {
        @Override
        public void run() {
            int currentItem = viewPager2.getCurrentItem();
            int totalCount = viewPager2.getAdapter().getItemCount();
            // 切换到下一页，如果是最后一页则回到第一页
            int nextItem = currentItem < totalCount - 1 ? currentItem + 1 : 0;
            viewPager2.setCurrentItem(nextItem);
            // 每隔3秒执行一次
            autoSwitchHandler.postDelayed(this, 3000);
        }
    };
    // 启动自动切换
    autoSwitchHandler.postDelayed(autoSwitchRunnable, 3000);
}

@Override
protected void onDestroy() {
    super.onDestroy();
    // 移除回调，避免内存泄漏
    if (autoSwitchHandler != null) {
        autoSwitchHandler.removeCallbacks(autoSwitchRunnable);
    }
}

注意事项

• 调用setCurrentItem之前必须确保ViewPager2已经设置了适配器，否则会抛出异常或者没有效果。
• 如果需要监听页面切换的事件，可以给ViewPager2注册OnPageChangeCallback回调，在回调中可以获取当前页面的位置、滑动状态等信息。
• 自动轮播场景下，当页面处于不可见状态（比如应用退到后台）时，建议暂停自动切换任务，回到前台时再恢复，减少不必要的性能消耗。
• 如果ViewPager2的页面是Fragment，需要确保Fragment的生命周期和切换逻辑兼容，避免Fragment状态异常。

页面切换监听示例

如果需要在页面切换时执行额外的逻辑，比如更新指示器状态，可以注册页面切换回调：

viewPager2.registerOnPageChangeCallback(new ViewPager2.OnPageChangeCallback() {
    @Override
    public void onPageSelected(int position) {
        super.onPageSelected(position);
        // 页面选中时的逻辑，比如更新指示器
        Log.d("ViewPager2", "当前选中页面位置：" + position);
    }

    @Override
    public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {
        super.onPageScrolled(position, positionOffset, positionOffsetPixels);
        // 页面滑动过程中的回调
    }

    @Override
    public void onPageScrollStateChanged(int state) {
        super.onPageScrollStateChanged(state);
        // 滑动状态变化回调，state为0表示静止，1表示正在拖动，2表示正在自动滑动
    }
});

ViewPager2Android页面切换初始页面设置修改时间：2026-07-02 18:24:34