Marquee

跑馬燈組件，用于滾動展示一段單行文本。僅當(dāng)文本內(nèi)容寬度超過跑馬燈組件寬度時滾動，不超過時不滾動。

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

子組件

無

接口

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

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

參數(shù)：

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

屬性

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

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

事件

名稱	功能描述
onStart(event: () => void)	開始滾動時觸發(fā)回調(diào)。從API version 9開始，該接口支持在ArkTS卡片中使用。
onBounce(event: () => void)	完成一次滾動時觸發(fā)，若循環(huán)次數(shù)不為1，則該事件會多次觸發(fā)。從API version 9開始，該接口支持在ArkTS卡片中使用。
onFinish(event: () => void)	滾動全部循環(huán)次數(shù)完成時觸發(fā)回調(diào)。從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%')
  }
}

marquee

審核編輯黃宇

聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請聯(lián)系本站處理。舉報投訴