HarmonyOS NEXT实战:Swiper轮播图

简介: 本教程介绍如何使用HarmonyOS的Swiper组件实现自动轮播图功能,支持4秒自动切换,指示器为长条横线样式。内容包括权限申请、图片轮播逻辑及自定义导航点样式,适用于应用首页推荐展示。

HarmonyOS Next实战##HarmonyOS应用开发##教育

目标:实现轮播图,每4秒自动循环切换,指示器为长条横线。

前提:需要申请权限ohos.permission.INTERNET。

实现思路:

  1. 通过Swiper实现轮播图。
  2. 通过autoPlay和interval实现自动轮播。
  3. 通过indicator设置指示器样式。

Swiper组件提供滑动轮播显示的能力。Swiper本身是一个容器组件,当设置了多个子组件后,可以对这些子组件进行轮播显示。通常,在一些应用首页显示推荐的内容时,需要用到轮播显示的能力。

循环播放
通过loop属性控制是否循环播放,该属性默认值为true。
当loop为true时,在显示第一页或最后一页时,可以继续往前切换到前一页或者往后切换到后一页。如果loop为false,则在第一页或最后一页时,无法继续向前或者向后切换页面。

自动轮播
Swiper通过设置autoPlay属性,控制是否自动轮播子组件。该属性默认值为false。
autoPlay为true时,会自动切换播放子组件,子组件与子组件之间的播放间隔通过interval属性设置。interval属性默认值为3000,单位毫秒。

导航点样式
Swiper提供了默认的导航点样式和导航点箭头样式,导航点默认显示在Swiper下方居中位置,开发者也可以通过indicator属性自定义导航点的位置和样式,导航点箭头默认不显示。
通过indicator属性,开发者可以设置导航点相对于Swiper组件上下左右四个方位的位置,同时也可以设置每个导航点的尺寸、颜色、蒙层和被选中导航点的颜色。

可选导航点指示器样式。

  • DotIndicator:圆点指示器样式。
  • DigitIndicator:数字指示器样式。
  • boolean:是否启用导航点指示器。设置为true启用,false不启用。
    默认值:true
    默认类型:DotIndicator

轮播方向
Swiper支持水平和垂直方向上进行轮播,主要通过vertical属性控制。
当vertical为true时,表示在垂直方向上进行轮播;为false时,表示在水平方向上进行轮播。vertical默认值为false。

实战

@Entry
@Component
struct SwiperDemoPage {
   
  imgs: ImageObj[] = [
    {
   
      src: 'https://c-ssl.dtstatic.com/uploads/blog/202311/27/0GSZv1oh0ePwpE.thumb.400_0.jpeg',
      title: '轮播图1',
    },
    {
   
      src: 'https://c-ssl.dtstatic.com/uploads/blog/202311/27/3BSm7JWFzV7Pqm.thumb.400_0.jpeg',
      title: '轮播图2',
    },
    {
   
      src: 'https://c-ssl.dtstatic.com/uploads/blog/202311/27/4ESaevWhoEyXqY.thumb.400_0.jpeg',
      title: '轮播图3',
    },
  ]
  private isLoop: boolean = false

  build() {
   
    Column({
    space: 10 }) {
   
      Text('Swiper轮播图实战')
      this.buildSwiper()
    }
    .height('100%')
    .width('100%')
  }

  /**
   * 轮播图UI
   */
  @Builder
  buildSwiper() {
   
    Column() {
   
      Swiper() {
   
        ForEach(this.imgs, (item: ImageObj) => {
   
          Stack({
    alignContent: Alignment.Bottom }) {
   
            Image(item.src)
              .width(Percent.P100)
              .height(Percent.P100)
            Row() {
   
              Text(item.title)
                .maxLines(2)
                .textOverflow({
    overflow: TextOverflow.Ellipsis })
                .wordBreak(WordBreak.BREAK_ALL)
                .margin({
    left: 8, right: 8, bottom: 26 })
                .fontColor(Color.White)
            }
            .width(Percent.P100)
          }
          .width(Percent.P100)
          .height(Percent.P100)
        })
      }
      .width(Percent.P100)
      .height(Percent.P100)
      .loop(this.isLoop)
      .effectMode(EdgeEffect.None) //设置边缘滑动效果
      .autoPlay(true)
      .interval(4000)
      .indicator(
        // 设置导航点样式
        new DotIndicator()
          .itemWidth(12)
          .itemHeight(2)
          .selectedItemWidth(24)
          .selectedItemHeight(2)
          .color(Color.Gray)
          .selectedColor(Color.White)
      )
    }
    .width(Percent.P100)
    .backgroundColor(Color.White)
    .aspectRatio(9 / 16)
    .borderRadius(6)
    .clip(true)
    .margin(10)
  }
}

interface ImageObj {
   
  src: string
  title: string
}

enum Percent {
   
  P100 = '100%'
}
目录
相关文章
|
4月前
|
容器
HarmonyOS NEXT仓颉开发语言实战案例:外卖App
仓颉语言实战分享,教你如何用仓颉开发外卖App界面。内容包括页面布局、导航栏自定义、搜索框实现、列表模块构建等,附完整代码示例。轻松掌握Scroll、List等组件使用技巧,提升HarmonyOS应用开发能力。
|
3月前
|
移动开发 前端开发 JavaScript
鸿蒙NEXT时代你所不知道的全平台跨端框架:CMP、Kuikly、Lynx、uni-app x等
本篇基于当前各大活跃的跨端框架的现状,对比当前它们的情况和未来的可能,帮助你在选择框架时更好理解它们的特点和差异。
312 0
|
4月前
|
安全 API 开发工具
【HarmonyOS NEXT】一键扫码功能
这些Kit为我们应用开发提升了极大地效率。很多简单的功能,如果不需要太深的定制化需求,直接调用kit提供的API就可以实现,在android或者ios上需要很多代码才能实现的功能效果。
119 0
HarmonyOS NEXT仓颉开发语言实战案例:电影App
周末好!本文分享使用仓颉语言重构ArkTS实现的电影App案例,对比两者在UI布局、组件写法及语法差异。内容包括页面结构、列表分组、分类切换与电影展示等。通过代码演示仓颉在HarmonyOS开发中的应用。##仓颉##ArkTS##HarmonyOS开发
|
4月前
|
容器
HarmonyOS NEXT仓颉开发语言实战案例:健身App
本期分享一个健身App首页的布局实现,顶部采用Stack容器实现重叠背景与偏移效果,列表部分使用List结合Scroll实现可滚动内容。代码结构清晰,适合学习HarmonyOS布局技巧。
HarmonyOS NEXT仓颉开发语言实战案例:小而美的旅行App
本文分享了一个旅行App首页的设计与实现,使用List容器搭配Row、Column布局完成个人信息、功能列表及推荐模块的排版,详细展示了HarmonyOS下的界面构建技巧。
|
18天前
|
存储 缓存 5G
鸿蒙 HarmonyOS NEXT端云一体化开发-云存储篇
本文介绍用户登录后获取昵称、头像的方法,包括通过云端API和AppStorage两种方式,并实现上传头像至云存储及更新用户信息。同时解决图片缓存问题,添加上传进度提示,支持自动登录判断,提升用户体验。
90 0
|
18天前
|
存储 负载均衡 数据库
鸿蒙 HarmonyOS NEXT端云一体化开发-云函数篇
本文介绍基于华为AGC的端云一体化开发流程,涵盖项目创建、云函数开通、应用配置及DevEco集成。重点讲解云函数的编写、部署、调用与传参,并涉及环境变量设置、负载均衡、重试机制与熔断策略等高阶特性,助力开发者高效构建稳定云端服务。
178 0
鸿蒙 HarmonyOS NEXT端云一体化开发-云函数篇
|
18天前
|
存储 JSON 数据建模
鸿蒙 HarmonyOS NEXT端云一体化开发-云数据库篇
云数据库采用存储区、对象类型、对象三级结构,支持灵活的数据建模与权限管理,可通过AGC平台或本地项目初始化,实现数据的增删改查及端侧高效调用。
50 0
|
18天前
|
存储 开发者 容器
鸿蒙 HarmonyOS NEXT星河版APP应用开发-ArkTS面向对象及组件化UI开发使用实例
本文介绍了ArkTS语言中的Class类、泛型、接口、模块化、自定义组件及状态管理等核心概念,并结合代码示例讲解了对象属性、构造方法、继承、静态成员、访问修饰符等内容,同时涵盖了路由管理、生命周期和Stage模型等应用开发关键知识点。
150 0
鸿蒙 HarmonyOS NEXT星河版APP应用开发-ArkTS面向对象及组件化UI开发使用实例

热门文章

最新文章