鴻蒙ArkTS聲明式組件：Marquee

Marquee

跑馬燈組件，用于滾動展示一段單行文本。僅當文本內容寬度超過跑馬燈組件寬度時滾動，不超過時不滾動。

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
該組件從API Version 8開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。

子組件

無

接口

Marquee(value: { start: boolean, step?: number, loop?: number, fromStart?: boolean, src: string })

從API version 9開始，該接口支持在ArkTS卡片中使用。

參數：

參數名	參數類型	必填	參數描述
start	boolean	是	控制跑馬燈是否進入播放狀態。說明：有限的滾動次數播放完畢后，不可以通過改變start重置滾動次數重新開始播放。
step	number	否	滾動動畫文本滾動步長。默認值：6，單位vp
loop	number	否	設置重復滾動的次數，小于等于零時無限循環。默認值：-1說明：ArkTS卡片上該參數設置任意值都僅在可見時滾動一次。
fromStart	boolean	否	設置文本從頭開始滾動或反向滾動。默認值：true
src	string	是	需要滾動的文本。

屬性

除支持文本通用屬性：fontColor、fontSize、fontWeight、fontFamily外，還支持以下屬性：

名稱	參數類型	描述
allowScale	boolean	是否允許文本縮放。暫不支持該接口。默認值：false

事件

名稱	功能描述
onStart(event: () => void)	開始滾動時觸發回調。從API version 9開始，該接口支持在ArkTS卡片中使用。
onBounce(event: () => void)	完成一次滾動時觸發，若循環次數不為1，則該事件會多次觸發。從API version 9開始，該接口支持在ArkTS卡片中使用。
onFinish(event: () => void)	滾動全部循環次數完成時觸發回調。從API version 9開始，該接口支持在ArkTS卡片中使用。`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

搜狗高速瀏覽器截圖20240326151450.png

示例

// xxx.ets
@Entry
@Component
struct MarqueeExample {
  @State start: boolean = false
  private fromStart: boolean = true
  private step: number = 50
  private loop: number = Number.POSITIVE_INFINITY
  private src: string = "Running Marquee starts rolling"

  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Marquee({
        start: this.start,
        step: this.step,
        loop: this.loop,
        fromStart: this.fromStart,
        src: this.src
      })
        .width(360)
        .height(80)
        .fontColor('#FFFFFF')
        .fontSize(48)
        .fontWeight(700)
        .backgroundColor('#182431')
        .margin({ bottom: 40 })
        .onStart(() = > {
          console.info('Marquee animation complete onStart')
        })
        .onBounce(() = > {
          console.info('Marquee animation complete onBounce')
        })
        .onFinish(() = > {
          console.info('Marquee animation complete onFinish')
        })
      Button('Start')
        .onClick(() = > {
          this.start = true
        })
        .width(120)
        .height(40)
        .fontSize(16)
        .fontWeight(500)
        .backgroundColor('#007DFF')
    }
    .width('100%')
    .height('100%')
  }
}