Android中使用StepView库实现带自定义图标的横向步骤视图

1. 替换步骤数字为自定义图标 #

该库支持通过自定义Step对象来替换默认数字图标，你需要构建包含自定义图标的步骤列表并传入控件：

• 创建List<Step>集合，为每个步骤指定专属图标：

List<Step> steps = new ArrayList<>();
steps.add(new Step.Builder()
        .setIcon(R.drawable.icon_step_initial) // 第一步的自定义图标
        .setTitle("信息填写")
        .build());
steps.add(new Step.Builder()
        .setIcon(R.drawable.icon_step_verify)
        .setTitle("身份验证")
        .build());
steps.add(new Step.Builder()
        .setIcon(R.drawable.icon_step_complete)
        .setTitle("完成提交")
        .build());
stepView.setSteps(steps);

• 建议准备不同分辨率的图标资源，避免显示时拉伸变形。

若需要区分步骤的选中/未选中状态，可分别设置对应图标：

steps.add(new Step.Builder()
        .setIcon(R.drawable.icon_step1_unactive) // 未激活状态图标
        .setCompletedIcon(R.drawable.icon_step1_active) // 已完成状态图标
        .setTitle("第一步")
        .build());

2. 用按钮控制步骤切换（无需ViewPager） #

库本身提供了go()方法来切换步骤，直接给按钮绑定点击逻辑即可：

• 先初始化当前步骤索引：private int currentStep = 0;
• 下一步按钮逻辑：

btnNext.setOnClickListener(v -> {
    if (currentStep < stepView.getStepCount() - 1) {
        currentStep++;
        stepView.go(currentStep, true); // 第二个参数为true时启用切换动画
    }
});

• 上一步按钮逻辑：

btnPrev.setOnClickListener(v -> {
    if (currentStep > 0) {
        currentStep--;
        stepView.go(currentStep, true);
    }
});

• 可选：根据当前步骤状态禁用按钮，提升交互体验：

private void updateButtonStatus() {
    btnPrev.setEnabled(currentStep > 0);
    btnNext.setEnabled(currentStep < stepView.getStepCount() - 1);
}
// 在初始化和每次步骤切换后调用此方法

内容的提问来源于stack exchange，提问作者Ahsan Murtaza