首页
/ StepView:优雅的步骤指示器和流程指示器

StepView:优雅的步骤指示器和流程指示器

2024-08-08 19:59:18作者:温艾琴Wonderful

项目介绍

StepView 是一个开源的 Android 库,旨在提供一个直观且灵活的步骤指示器和流程指示器。无论是水平还是垂直布局,StepView 都能轻松实现步骤的展示和流程的跟踪。通过简单的配置,开发者可以快速集成这一功能到自己的应用中,提升用户体验。

项目技术分析

StepView 基于 Android 平台开发,利用了 Android 的视图系统和资源管理机制。它提供了两种主要的视图类型:HorizontalStepViewVerticalStepView,分别用于水平和垂直步骤展示。这两种视图都支持自定义步骤文本、颜色、图标等属性,使得步骤指示器既美观又实用。

项目及技术应用场景

StepView 适用于多种场景,特别是在需要展示多步骤流程的应用中,如:

  • 电商应用:展示订单状态,从下单到配送的每一个步骤。
  • 设置向导:在新用户注册或应用设置过程中,引导用户完成一系列步骤。
  • 工作流程:在企业应用中,展示任务或项目的进度。

项目特点

  1. 灵活性:支持水平和垂直两种布局,满足不同设计需求。
  2. 可定制性:提供丰富的自定义选项,包括文本、颜色、图标等。
  3. 易用性:集成简单,通过几行代码即可实现复杂的步骤指示器。
  4. 美观性:提供现代化的设计风格,提升应用的整体视觉效果。

使用示例

水平步骤指示器

在 XML 中添加 HorizontalStepView

<com.baoyachi.stepview.HorizontalStepView
    android:id="@+id/step_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_centerInParent="true"
/>

在代码中配置步骤:

HorizontalStepView setpview5 = (HorizontalStepView) mView.findViewById(R.id.step_view5);
List<StepBean> stepsBeanList = new ArrayList<>();
StepBean stepBean0 = new StepBean("接单",1);
StepBean stepBean1 = new StepBean("打包",1);
StepBean stepBean2 = new StepBean("出发",1);
StepBean stepBean3 = new StepBean("送单",0);
StepBean stepBean4 = new StepBean("完成",-1);
stepsBeanList.add(stepBean0);
stepsBeanList.add(stepBean1);
stepsBeanList.add(stepBean2);
stepsBeanList.add(stepBean3);
stepsBeanList.add(stepBean4);

setpview5
    .setStepViewTexts(stepsBeanList)
    .setTextSize(12)
    .setStepsViewIndicatorCompletedLineColor(ContextCompat.getColor(getActivity(), android.R.color.white))
    .setStepsViewIndicatorUnCompletedLineColor(ContextCompat.getColor(getActivity(), R.color.uncompleted_text_color))
    .setStepViewComplectedTextColor(ContextCompat.getColor(getActivity(), android.R.color.white))
    .setStepViewUnComplectedTextColor(ContextCompat.getColor(getActivity(), R.color.uncompleted_text_color))
    .setStepsViewIndicatorCompleteIcon(ContextCompat.getDrawable(getActivity(), R.drawable.complted))
    .setStepsViewIndicatorDefaultIcon(ContextCompat.getDrawable(getActivity(), R.drawable.default_icon))
    .setStepsViewIndicatorAttentionIcon(ContextCompat.getDrawable(getActivity(), R.drawable.attention));

垂直步骤指示器

在 XML 中添加 VerticalStepView

<com.baoyachi.stepview.VerticalStepView
    android:id="@+id/step_view0"
    android:layout_width="wrap_content"
    android:layout_height="match_parent"
/>

在代码中配置步骤:

mSetpview0 = (VerticalStepView) findViewById(R.id.step_view0);

List<String> list0 = new ArrayList<>();
list0.add("接已提交定案,等待系统确认");
list0.add("您的商品需要从外地调拨,我们会尽快处理,请耐心等待");