HarmonyOS开发案例：Swiper实现Stepper的能力案例

介绍

在许多场景下，我们都需要引导用户按照步骤完成任务，此功能在HarmonyOS Next中可以使用Stepper来实现，但是Stepper的定制化能力较弱，开发者无法定制上下页切换按钮的样式、位置，因此本例介绍了如何基于Swiper实现Stepper的能力。

效果图预览

使用说明

1. 在案例第一页，中间内容区域可以上下滑动。
2. 点击第一页的右下角的“下一页”，会进入到本案例的第二页。
3. 在案例第二页，必须选择一项数据之后才能进入案例第三页。
4. 第三页与第二页类似，必须所有数据填写完整才能提交（仅通过toast模拟）。

实现思路

1. 通过Swiper实现按步骤完成任务，各个页面内容由Swiper的Item承载，禁用掉Swiper的滑动切换等功能，仅通过Controller控制Swiper的Item切换；由于HeaderView中的返回/更多按钮在各个页面中是相同的，因此这里将其置于Swiper同级；但是为了便于进行各个页面的数据处理与校验，页面下方的上下页切换功能在Swiper内实现。

// TODO 知识点：页面上方的返回/更多按钮在各个页面是一样的，因此这里将其与页面Title一起置于Swiper同级
HeaderView({ titleArray: this.pageTitleArray, currentIndex: this.currentIndex })
// TODO 知识点：页面主体内容由Swiper承载，通过Swiper的Controller来通知页面去前进/后退        
Swiper(this.controller) {
  UserNoticeView()
  CategoryView()
  TableView()
}
.layoutWeight(1)
.duration(0)
.cachedCount(1)
.disableSwipe(true)
.backgroundColor(Color.Transparent)
.index($$this.currentIndex)
.width('100%')
.loop(false)
.autoPlay(false)
.indicator(false)

1. 在Swiper的每个Item中，只有在当前Item的数据都已填写时，才能通过controller.showNext()切换到Swiper的下一个Item继续操作。源码见CategoryView.ets与FooterView.ets。

// CategoryView.ets
export struct CategoryView {
  submitInfo: SubmitInfoWrapper | undefined = undefined;

  build() {
    Column() {
      // ...
      FooterView({
        // 各个页面定义自己的数据校验函数，只有当校验通过，返回true时，FooterView中才会通过Controller切换到下一页
        nextCb: () => {
          let verified: boolean = this.submitInfo?.category !== undefined;
          if (!verified) {
            promptAction.showToast({ message: $r("app.string.stepper_info_not_filled") });
          }
          return verified;
        }
      })
    }
  }
}

// FooterView.ets
@Component
export struct FooterView {
  controller: SwiperController | undefined = undefined;
  nextCb: Function | undefined = undefined;

  build() {
    Row() {
      // ...
      Button()
        // 只有没有定义校验函数或者校验通过，才能切换到下一页
        .onClick(() => {
          if (this.nextCb === undefined) {
            this.controller?.showNext();
          } else if (this.nextCb()) {
            this.controller?.showNext();
          }
        })
    }
  }
}

1. 每个Item的主体内容由Scroll承载（也可根据实际就情况使用其他方案），与上下页切换功能同级，确认主体内容超出页面后仍可正常显示且不会被上下页切换的按钮所遮挡。源码见UserNoticeView.ets。

@Component
export struct UserNoticeView {
  noticeItem: number[] = [];

  build() {
    Column() {
      Scroll() {
        Column({ space: this.ITEM_SPACE }) {
          ForEach(this.noticeItem, (_: number, __: number) => {
            Row()
              .height($r("app.integer.stepper_usernotice_item_height"))
              .width(getRandomNumber())
              .backgroundColor($r("sys.color.ohos_id_color_sub_background"))
          })
        }
        .width('100%')
        .alignItems(HorizontalAlign.Start)
      }
      .scrollBar(BarState.Off)
      .layoutWeight(1)
      .width('100%')
      .align(Alignment.Top)

      FooterView()
    }
  }
}

高性能知识点

不涉及

工程结构&模块类型

customstepper                        // har类型
|---common
|   |---DataModel.ets                // 数据模型
|   |---Utils.ets                    // 通用基础函数
|---view
|   |---CustomStepperView.ets        // 步骤导航器组件——入口
|   |---HeaderView.ets               // Header组件——页面上方公共部分
|   |---FooterView.ets               // Footer组件——页面下方前进后退按钮
|   |---UserNoticeView.ets           // 步骤导航器第一页主体内容
|   |---CategoryView.ets             // 步骤导航器第二页主体内容
|   |---TableView.ets                // 步骤导航器第三页主体内容

最后

小编在之前的鸿蒙系统扫盲中，有很多朋友给我留言，不同的角度的问了一些问题，我明显感觉到一点，那就是许多人参与鸿蒙开发，但是又不知道从哪里下手，因为资料太多，太杂，教授的人也多，无从选择。有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

为了确保高效学习，建议规划清晰的学习路线，涵盖以下关键阶段：

 点击→【纯血版鸿蒙全套最新学习资料】希望这一份鸿蒙学习资料能够给大家带来帮助~

---

 鸿蒙（HarmonyOS NEXT）最新学习路线

​

该路线图包含基础技能、就业必备技能、多媒体技术、六大电商APP、进阶高级技能、实战就业级设备开发，不仅补充了华为官网未涉及的解决方案

路线图适合人群：

IT开发人员：想要拓展职业边界
零基础小白：鸿蒙爱好者，希望从0到1学习，增加一项技能。
技术提升/进阶跳槽：发展瓶颈期，提升职场竞争力，快速掌握鸿蒙技术

点击→纯血版全套鸿蒙HarmonyOS学习资料

2.视频学习资料+学习PDF文档

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、（南向驱动、嵌入式等）鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

HarmonyOS Next 最新全套视频教程

​​

 （鸿蒙语法ArkTS、TypeScript、ArkUI教程……）

 纯血版鸿蒙全套学习资料（面试、文档、全套视频等）

                   

鸿蒙南向开发技术

​​

鸿蒙APP开发必备

​​

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

​​

《鸿蒙开发基础》

​​

《鸿蒙开发进阶》

《鸿蒙进阶实战》

​​

点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

参与鸿蒙开发，你要先认清适合你的方向，如果是想从事鸿蒙应用开发方向的话，可以参考本文的学习路径，简单来说就是：为了确保高效学习，建议规划清晰的学习路线