鸿蒙（HarmonyOS）项目方舟框架（ArkUI）之Swiper容器组件_鸿蒙 swiper

 鸿蒙（HarmonyOS）项目方舟框架（ArkUI）之Swiper容器组件

一、操作环境

操作系统:  Windows 10 专业版、IDE:DevEco Studio 3.1、SDK:HarmonyOS 3.1

二、Swiper容器组件

滑块视图容器，提供子组件滑动轮播显示的能力。

子组件

可以包含子组件。

接口

Swiper(controller?: SwiperController)

参数

属性

除支持通用属性外，还支持以下属性：

SwiperDisplayMode枚举说明

SwiperController

Swiper容器组件的控制器，可以将此对象绑定至Swiper组件，然后通过它控制翻页。

showNext

showNext(): void

翻至下一页。翻页带动效切换过程，时长通过duration指定。

showPrevious

showPrevious(): void

翻至上一页。翻页带动效切换过程，时长通过duration指定。

finishAnimation

finishAnimation(callback?: () => void): void

停止播放动画。

参数：

事件

除支持通用事件外，还支持以下事件：

onChange

onChange(event: (index: number) => void)

当前显示的子组件索引变化时触发该事件,返回值为当前显示的子组件的索引值。

说明：Swiper组件结合LazyForEach使用时，不能在onChange事件里触发子页面UI的刷新。

返回值：

三、示例

代码

// xxx.ets
class MyDataSource implements IDataSource {
  private list: number[] = []
  private listener: DataChangeListener
 
  constructor(list: number[]) {
    this.list = list
  }
 
  totalCount(): number {
    return this.list.length
  }
 
  getData(index: number): any {
    return this.list[index]
  }
 
  registerDataChangeListener(listener: DataChangeListener): void {
    this.listener = listener
  }
 
  unregisterDataChangeListener() {
  }
}
 
@Entry
@Component
struct SwiperExample {
  private swiperController: SwiperController = new SwiperController()
  private data: MyDataSource = new MyDataSource([])
 
  aboutToAppear(): void {
    let list = []
    for (var i = 1; i <= 10; i++) {
      list.push(i.toString());
    }
    this.data = new MyDataSource(list)
  }
 
  build() {
    Column({ space: 5 }) {
      Swiper(this.swiperController) {
        LazyForEach(this.data, (item: string) => {
          Text(item).width('90%').height(160).backgroundColor(0xAFEEEE).textAlign(TextAlign.Center).fontSize(30)
        }, item => item)
      }
      .cachedCount(2)
      .index(1)
      .autoPlay(true)
      .interval(4000)
      .indicator(true)
      .loop(true)
      .duration(1000)
      .itemSpace(0)
      .curve(Curve.Linear)
      .onChange((index: number) => {
        console.info(index.toString())
      })
 
      Row({ space: 12 }) {
        Button('showNext')
          .onClick(() => {
            this.swiperController.showNext()
          })
        Button('showPrevious')
          .onClick(() => {
            this.swiperController.showPrevious()
          })
      }.margin(5)
    }.width('100%')
    .margin({ top: 5 })
  }
}

图例

你有时间常去我家看看我在这里谢谢你啦...

我家地址:亚丁号

最后送大家一首诗:

山高路远坑深,
大军纵横驰奔,

谁敢横刀立马？
惟有点赞加关注大军。