0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

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

尤枫 来源:jf_54996641 2025-06-24 17:06 次阅读
加入交流群
微信小助手二维码

扫码添加小助手

加入工程师交流群

前言

轮播图作为应用程序中最普通使用的控件被广泛应用,相信对于来发者来说并不陌生。在 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)
  }

总结

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

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • Android
    +关注

    关注

    12

    文章

    3978

    浏览量

    130824
  • 应用程序
    +关注

    关注

    38

    文章

    3339

    浏览量

    59285
  • HarmonyOS
    +关注

    关注

    80

    文章

    2130

    浏览量

    33766
收藏 人收藏
加入交流群
微信小助手二维码

扫码添加小助手

加入工程师交流群

    评论

    相关推荐
    热点推荐

    大彩讲堂:VisualTFT软件如何自定义圆形进度条

    VisualTFT软件如何自定义圆形进度条
    的头像 发表于 07-07 17:10 668次阅读
    大彩讲堂:VisualTFT软件如何<b class='flag-5'>自定义</b>圆形进度条

    HarmonyOS实战:快速实现上下滚动的广告控件

    广告功能基本上算是每个软件的必备功能之,常见的除了轮播,列表之外,就是上下滚动的形式。广告内容不仅支持上下滚动,还需要支持手势操作,以及关闭当前正在预览的广告内容。在 Android 或 iOS
    的头像 发表于 06-24 17:05 207次阅读

    KiCad 中的自定义规则(KiCon 演讲)

    “  Seth Hillbrand 在 KiCon US 2025 上为大家介绍了 KiCad 的规则系统,并详细讲解了自定义规则的设计与实例。  ”   演讲主要围绕 加强 KiCad 中的自定义
    的头像 发表于 06-16 11:17 835次阅读
    KiCad 中的<b class='flag-5'>自定义</b>规则(KiCon 演讲)

    HarmonyOS实战自定义时间选择器

    前言 最近在日常鸿蒙开发过程中,经常会使用些时间选择器,鸿蒙官方提供的时间选择器满足不了需求,所以自己动手自定义些经常会使用到的时间选择器,希望能帮到你,建议点赞收藏! 实现效果
    的头像 发表于 06-09 15:51 308次阅读
    <b class='flag-5'>HarmonyOS</b><b class='flag-5'>实战</b>:<b class='flag-5'>自定义</b>时间选择器

    HarmonyOS实战:高德地图自定义定位图标展示

    的问题,建议点赞收藏! 实现效果 需求分析 首先需要实现自定义的图标替代系统默认的箭头。 获取定位权限与位置信息。 获取定位结果并展示当
    的头像 发表于 06-09 14:59 299次阅读
    <b class='flag-5'>HarmonyOS</b><b class='flag-5'>实战</b>:高德地图<b class='flag-5'>自定义</b>定位图标展示

    HarmonyOS应用自定义键盘解决方案

    自定义键盘是种替换系统默认键盘的解决方案,可实现键盘个性化交互。允许用户结合业务需求与操作习惯,对按键布局进行可视化重构、设置多功能组合键位,使输入更加便捷和舒适。在安全防护层面,自定义
    的头像 发表于 06-05 14:19 938次阅读

    LabVIEW运动控制(三):EtherCAT运动控制器的高效加工指令自定义封装

    LabVIEW高效加工指令自定义封装
    的头像 发表于 04-08 13:49 2836次阅读
    LabVIEW运动控制(三):EtherCAT运动控制器的高效加工指令<b class='flag-5'>自定义</b>封装

    如何添加自定义单板

    在开发过程中,用户有时需要创建自定义板配置。本节将通过实例讲解用户如何创建属于自己的machine,下面以g2l-test.conf为例进行说明。
    的头像 发表于 03-12 14:43 712次阅读

    如何快速创建用户自定义Board和App工程

    概述自HPM_SDKv1.7.0发布开始,在HPM_ENV中新增了user_template文件夹,以方便用户快速创建自定义的Board和App工程。user_template是用户模板工程,用户
    的头像 发表于 02-08 13:38 651次阅读
    如何快速创建用户<b class='flag-5'>自定义</b>Board和App工程

    CAN总线十万为什么 | CAN自定义波特率有什么用?

    导读CAN总线通信中,波特率致并不总能保证通信顺畅。本文将揭秘自定义波特率的原理和应用,探讨如何通过优化采样点和提高容忍度解决通信问题,助力工程师提升通信稳定性。通常情况下,CAN总线通信只需确保
    的头像 发表于 02-07 11:36 827次阅读
    CAN总线十万<b class='flag-5'>个</b>为什么 | CAN<b class='flag-5'>自定义</b>波特率有什么用?

    Altium Designer 15.0自定义元件设计

    电子发烧友网站提供《Altium Designer 15.0自定义元件设计.pdf》资料免费下载
    发表于 01-21 15:04 0次下载
    Altium Designer 15.0<b class='flag-5'>自定义</b>元件设计

    think-cell:自定义think-cell(四)

    定义这些设置。 在 PowerPoint 幻灯片母版视图中,创建新的自定义版式。您将复制与 think-cell 议程幻灯片的所需外观最匹配的现有自定义布局之。 将新的
    的头像 发表于 01-13 10:37 589次阅读
    think-cell:<b class='flag-5'>自定义</b>think-cell(四)

    think-cell;自定义think-cell()

    本章介绍如何自定义 think-cell,即如何更改默认颜色和其他默认属性;这是通过 think-cell 的样式文件完成的,这些文件将在前四部分中进行讨论。 第五部分 C.5 设置默认议程幻灯片
    的头像 发表于 01-08 11:31 924次阅读
    think-cell;<b class='flag-5'>自定义</b>think-cell(<b class='flag-5'>一</b>)

    创建自定义的基于闪存的引导加载程序(BSL)

    电子发烧友网站提供《创建自定义的基于闪存的引导加载程序(BSL).pdf》资料免费下载
    发表于 09-19 10:50 0次下载
    创建<b class='flag-5'>自定义</b>的基于闪存的引导加载程序(BSL)

    如何创建TestStand自定义步骤

    在之前的课程中简单地介绍过TestStand自带的些步骤类型,如测试、消息弹窗、赋值、标签等等,这些简单的步骤从TestStand的插入选版中就可以添加到序列中。那么在使用中如果碰到需要实现更加灵活、复杂的功能,使用自带的
    的头像 发表于 09-11 14:46 2831次阅读
    如何创建TestStand<b class='flag-5'>自定义</b>步骤