android 引导页滑动

Android 引导页滑动

引言

在开发 Android 应用时，我们经常会遇到需要引导用户了解应用功能或者提供一些新功能介绍的场景。引导页是一种常见的实现方式，用户可以通过滑动屏幕来切换页面。本文将介绍如何在 Android 应用中实现引导页滑动功能。

在实现引导页滑动功能时，我们可以使用 ViewPager 控件来实现。ViewPager 是 Android 提供的用于在多个页面之间进行滑动切换的控件，它可以很方便地实现引导页功能。

准备工作

在开始编写代码之前，我们需要确保项目中已经引入了 ViewPager 相关的依赖库。在项目的 build.gradle 文件中添加以下依赖：

implementation 'androidx.viewpager2:viewpager2:1.0.0'

接下来，我们需要准备引导页的布局文件。通常情况下，引导页的布局文件包含一个 ViewPager 控件和一些指示当前页数的小圆点。

下面是一个简单的引导页布局文件示例（guide_layout.xml）：

<RelativeLayout xmlns:android="
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <androidx.viewpager2.widget.ViewPager2
        android:id="@+id/viewPager"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

    <LinearLayout
        android:id="@+id/dotsLayout"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentBottom="true"
        android:gravity="center"
        android:orientation="horizontal" />

</RelativeLayout>

在上面的布局文件中，我们使用了一个 ViewPager2 控件和一个 LinearLayout 作为小圆点的容器。

编写适配器

接下来，我们需要编写一个适配器类，用于提供引导页的内容。在适配器类中，我们需要继承 ViewPager2.Adapter，并实现其中的几个方法。

下面是一个简单的适配器类示例（GuideAdapter.java）：

public class GuideAdapter extends RecyclerView.Adapter<GuideAdapter.ViewHolder> {

    private List<Integer> imageList;

    public GuideAdapter(List<Integer> imageList) {
        this.imageList = imageList;
    }

    @NonNull
    @Override
    public ViewHolder onCreateViewHolder(@NonNull ViewGroup parent, int viewType) {
        View view = LayoutInflater.from(parent.getContext())
                .inflate(R.layout.guide_item, parent, false);
        return new ViewHolder(view);
    }

    @Override
    public void onBindViewHolder(@NonNull ViewHolder holder, int position) {
        holder.imageView.setImageResource(imageList.get(position));
    }

    @Override
    public int getItemCount() {
        return imageList.size();
    }

    public class ViewHolder extends RecyclerView.ViewHolder {

        ImageView imageView;

        public ViewHolder(@NonNull View itemView) {
            super(itemView);
            imageView = itemView.findViewById(R.id.imageView);
        }
    }
}

在上面的适配器类中，我们使用了一个 ViewHolder 内部类来持有每个引导页的布局，其中的 onCreateViewHolder 方法用于创建 ViewHolder 实例，onBindViewHolder 方法用于绑定数据。

设置适配器和指示器

在 Activity 或 Fragment 中，我们需要通过代码来设置适配器和指示器。首先，我们需要找到 ViewPager 控件，并创建一个适配器实例。

下面是一个简单的 Activity 示例代码：

public class GuideActivity extends AppCompatActivity {

    private ViewPager2 viewPager;
    private LinearLayout dotsLayout;

    private List<Integer> imageList;
    private GuideAdapter guideAdapter;
    private ImageView[] dots;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.guide_layout);

        viewPager = findViewById(R.id.viewPager);
        dotsLayout = findViewById(R.id.dotsLayout);

        imageList = new ArrayList<>();
        imageList.add(R.drawable.image1);
        imageList.add(R.drawable.image2);
        imageList.add(R.drawable.image3);

        guideAdapter = new GuideAdapter(imageList);
        viewPager.setAdapter(guideAdapter);

        addDots();
    }

    private void addDots() {
        dots = new ImageView[imageList.size()];
        for (int i = 0; i < imageList.size(); i++) {
            dots[i] = new ImageView(this);
            dots[i].setImageDrawable(ContextCompat.getDrawable(this, R.drawable.dot_inactive));
            LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(
                    ViewGroup.LayoutParams.WRAP_CONTENT,
                    ViewGroup