百度360必应搜狗淘宝本站头条
当前位置:网站首页 > IT技术 > 正文

HarmonyOS实战:3秒实现一个自定义轮播图

wptr33 2025-06-04 02:10 10 浏览

前言

轮播图作为应用程序中最普通使用的控件被广泛应用,相信对于来发者来说并不陌生。在 Android 中实现一个 轮播图很多选择使用第三方的插件,毕竟在有限的开发排期中自己动手去实现一个轮播图 并不那么简单,需要考虑的细节很多。不过在 HarmonyOS 中实现一个轮播图却是十分的简单,本篇文章教你在最短的时间内快速实现一个自定义的 轮播图,建议点赞收藏!

实现效果

需求分析

  • 支持自定义循环播放,自动播放。
  • 支持自定义播放时间间隔。
  • 支持横向和竖向轮播。
  • 支持自定义指示器。

技术实现

  1. 在鸿蒙原生开发中,为开发者提供了很多自由度高的控件,要想实现一个轮播图,最简单的方式就是选择合适的控件,这里使用的是官方提供的 Swiper 控件。Swiper 控件支持多种功能属性。

swiperController: SwiperController = new SwiperController()

Swiper(this.swiperController)
  1. 选择好 Swiper 控件后,需要为 Swiper 控件提供数据。这里使用 LazyForEach 懒加载的方式,提高性能。注意如果使用 LazyForEach 的 方式就需要搭配IDataSource 使用
@State data: LazyData<PhotoData> = new LazyData()

Swiper(this.swiperController) {
        LazyForEach(this.data, (item: PhotoData, index: number) => {
          Image($r(`app.media.` + item.id))
            .width('100%')
            .height('30%')
        }, (item: PhotoData) => JSON.stringify(item))
      }

export class LazyData<T> implements IDataSource{
  // 监听器
  private listeners: DataChangeListener[] = []
  private array:Array<T> = []
  totalCount(): number {
   return this.array.length
  }

  getData(index: number): T {
    return this.array[index]
  }

  registerDataChangeListener(listener: DataChangeListener): void {
    if (this.listeners.indexOf(listener)<0) {
      this.listeners.push(listener)
    }
  }

  unregisterDataChangeListener(listener: DataChangeListener): void {
    const index = this.listeners.indexOf(listener)
    if (index>=0) {
      this.listeners.splice(index,1)
    }
  }
  push(data:T){
    this.array.push(data)
  }

}

自定义LazyData 类,实现 IDataSource 接口,并实现其中的方法即可。

  1. 简单实现了展示功能后,接下来为轮播图提供一些基本属性。
      .loop(true) //是否轮播
      .autoPlay(true) //是否自动播放
      .interval(this.duration) //播放间隔时间
      .indicator(true) //是否显示指示器
      .vertical(false) //是否竖向播放
      .indicatorStyle({selectedColor:this.bgColor,color:Color.White}) //指示器的相关配置
  1. 由于 Swiper 提供的默认指示器可能不满足实际的开发需求,这里实现一个自定义的指示器。首先将默认指示器设置为 false,然后实现 onChange 方法,用来获取图片切换的下标。
 .indicator(false)
.onChange((index:number)=>{
          this.currentIndex = index
        })
  1. 自定义指示器组件。


 @Builder
  progressView() {
    Row({ space: 5 }) {
      LazyForEach(this.data, (item: PhotoData, index: number) => {
        Stack({ alignContent: Alignment.Start }) {
          Row()
            .zIndex(1)
            .width(this.currentIndex >= index && !this.slide ? '100%' : '0')
            .height(2)
            .borderRadius(2)
            .backgroundColor(this.bgColor)
            .animation(!this.slide ? {
              duration: this.duration - 400,
              curve: Curve.Linear,
              iterations: 1,
              playMode: PlayMode.Normal,
              onFinish: () => {
                if (this.currentIndex === this.data.totalCount() - 1) {
                  this.duration = 400;
                  this.currentIndex = -1;
                }
              }
            } : { duration: 0, iterations: 1 })
        }
        .width('100%')
        .height(2)
        .borderRadius(2)
        .backgroundColor(this.currentIndex >= index && this.slide ? this.bgColor : Color.Grey)
        .layoutWeight(1)
      }, (item: PhotoData) => JSON.stringify(item))
    }
    .width('50%')
    .height(50)
  }


总结

在鸿蒙实际开发中,实现一个轮播图是十分方便的,但是这并不是意味着所有功能都简单,还有一些看似简单的效果实现起来却是十分的复杂。学会的小伙伴赶紧动手试试吧!

相关推荐

Linux文件系统操作常用命令(linux文件内容操作命令)

在Linux系统中,有一些常用的文件系统操作命令,以下是这些命令的介绍和作用:#切换目录,其中./代表当前目录,../代表上一级目录cd#查看当前目录里的文件和文件夹ls#...

别小看tail 命令,它难倒了技术总监

我把自己以往的文章汇总成为了Github,欢迎各位大佬star...

lnav:基于 Linux 的高级控制台日志文件查看器

lnav是一款开源的控制台日志文件查看器,专为Linux和Unix-like系统设计。它通过自动检测日志文件的格式,提取时间戳、日志级别等关键信息,并将多个日志文件的内容按时间顺序合并显示,...

声明式与命令式代码(声明模式和命令模式)

编程范式中的术语和差异信不信由你,你可能已经以开发人员的身份使用了多种编程范例。因为没有什么比用编程理论招待朋友更有趣的了,所以这篇文章可以帮助您认识代码中的流行范例。命令式编程命令式编程是我们从As...

linux中的常用命令(linux常用命令和作用)

linux中的常用命令linux中的命令统称shell命令shell是一个命令行解释器,将用户命令解析为操作系统所能理解的指令,实现用户与操作系统的交互shell终端:我们平时输入命令,执行程序的那个...

提高工作效率的--Linux常用命令,能够决解95%以上的问题

点击上方关注,第一时间接受干货转发,点赞,收藏,不如一次关注评论区第一条注意查看回复:Linux命令获取linux常用命令大全pdf+Linux命令行大全pdf...

如何限制他人操作自己的电脑?(如何控制别人的电脑不让发现)

这段时间,小猪罗志祥正处于风口浪尖,具体是为啥?还不知道的小伙伴赶紧去补一下最近的娱乐圈八卦~简单来说,就是我们的小罗同事,以自己超强的体力,以及超强的时间管理能力,重新定义了「多人运动」的含义,重新...

最通俗易懂的命令模式讲解(命令模式百科)

我们先不讲什么是命令模式,先通过一个场景来引出命令模式,看看命令模式能解决什么样的问题。现在有一个渣男张三,他有还几个女朋友,你现在是不是还是单身狗,你就说你气不气?然后他需要每天分别叫几个女朋友起床...

互联网大厂后端必看!Spring Boot 中Runtime执行与停止命令?

你是否曾在使用SpringBoot开发项目时,遇到需要执行系统命令的场景?比如调用脚本进行文件处理,又或是启动外部程序?很多后端开发人员会使用Processexec=Runtime.get...

Linux 常用命令(linux常用的20个命令面试)

日志排查类操作命令...

Java字节码指令:if_icmpgt(0xA3)(java字节码使用的汇编语言)

if_icmpgt是Java字节码中的一条条件跳转指令,其全称是"IfIntegerCompareGreaterThan"。它用于比较两个整数值的大小。如果栈顶的第一个...

外贸干货|如何增加领英的曝光量和询盘

#跨境电商#...

golang执行linux命令(golang调用shell脚本)

需求需要通过openssl生成rsa秘钥,然后保存该秘钥。代码实例packagemainimport("io/ioutil""bytes"&...

LINUX磁盘挂载(linux磁盘挂载到windows)

1、使用root用户查看磁盘挂载情况:fdisk-l2、使用df查看当前磁盘挂载情况,根据和fdisk-l的结果进行对比,查看还有那些磁盘未使用3、挂载:mount磁盘挂载路径...

Linux命令学习——nl命令(linux ln命令的使用)

nl命令主要功能为每一个文件添加行号,每一个输入的文件添加行号后发送到标准输出。当没有文件或文件为-时,读取标准输入...