【HarmonyOS 5.0.0 或以上】构建图片轮播组件 Carousel:支持自动轮播 / 指示点 / 手势滑动

🎯 目标

实现一个图片轮播组件 CommonCarousel,适用于首页 Banner、广告图、图文展示等场景,支持:

  • 自动轮播(定时切换)

  • 手势滑动切换

  • 底部圆点指示器(可自定义)

  • 支持无限循环滚动

  • 可设置轮播间隔时间、动画时长、宽高比等


🧱 样式交互示意

[ 🖼 图片1 ]   ← 滑动切换
[ ○ ● ○ ○ ]   ← 当前第2张

🧰 组件实现:CommonCarousel.ets

@Component
export struct CommonCarousel {
  @Prop images: Array<string> = []
  @Prop interval: number = 3000  // 自动轮播间隔(ms)
  @Prop height: number = 180
  @Prop radius: number = 8
  @Prop autoPlay: boolean = true
  @Prop showIndicator: boolean = true

  @State current: number = 0
  private timer: number | null = null

  aboutToAppear() {
    if (this.autoPlay) this.startTimer()
  }

  aboutToDisappear() {
    if (this.timer) clearInterval(this.timer)
  }

  build() {
    Column() {
      Swiper({
        index: this.current,
        autoPlay: this.autoPlay,
        inter
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值