HarmonyOS NEXT练习:跑马灯

Marquee跑马灯组件,用于滚动展示一段单行文本。仅当文本内容宽度超过跑马灯组件宽度时滚动,不超过时不滚动。

接口

typescript 复制代码
Marquee(value: { start: boolean, step?: number, loop?: number, fromStart?: boolean, src: string })

value:配置跑马灯组件的参数。

  • start:控制跑马灯是否进入播放状态。
  • step:滚动动画文本滚动步长,当step大于Marquee的文本宽度时,取默认值。默认值:6,单位vp
  • loop:设置重复滚动的次数,小于等于零时无限循环。默认值:-1
  • fromStart:设置文本从头开始滚动或反向滚动。默认值:true
  • src:需要滚动的文本。

组件属性:

typescript 复制代码
.fontColor(value: ResourceColor) //设置字体颜色。
.fontSize(value: Length) //设置字体大小。
.fontWeight(value: number | FontWeight | string) //设置文本的字体粗细,设置过大可能会在不同字体下有截断。默认值:FontWeight.Normal
.fontFamily(value: string | Resource) //设置字体列表。默认字体'HarmonyOS Sans'。
.allowScale(value: boolean) //设置是否允许文本缩放。默认值:false
.marqueeUpdateStrategy(value: MarqueeUpdateStrategy) //跑马灯组件属性更新后,跑马灯的滚动策略。(当跑马灯为播放状态,且文本内容宽度超过跑马灯组件宽度时,该属性生效)。默认值: MarqueeUpdateStrategy.DEFAULT

组件事件:

typescript 复制代码
.onStart(event: () => void) //当滚动的文本内容变化或者开始滚动时触发回调。
.onBounce(event: () => void) //完成一次滚动时触发,若循环次数不为1,则该事件会多次触发。
.onFinish(event: () => void) //滚动全部循环次数完成时触发回调。

跑马灯练习Demo:

typescript 复制代码
@Entry
@Component
struct MarqueePage {
  @State start: boolean = true;
  @State marqueeText: string = '跑马灯练习:当文字超出一屏幕宽时,通过跑马灯滚动展示文字...';
  private fromStart: boolean = true;
  private step: number = 10;
  private loop: number = Number.POSITIVE_INFINITY;

  build() {
    Column({ space: 20 }) {
      Text('跑马灯练习')
      Marquee({
        start: this.start,
        step: this.step,
        loop: this.loop,
        fromStart: this.fromStart,
        src: this.marqueeText
      })
        .marqueeUpdateStrategy(MarqueeUpdateStrategy.PRESERVE_POSITION)
        .width('100%')
        .height('80')
        .fontColor('#FFFFFF')
        .fontSize('48fp')
        .fontWeight(700)
        .backgroundColor('#182431')
        .margin({ bottom: '40vp' })
        .onStart(() => {
          console.info('Succeeded in completing the onStart callback of marquee animation');
        })
        .onBounce(() => {
          console.info('Succeeded in completing the onBounce callback of marquee animation');
        })
        .onFinish(() => {
          console.info('Succeeded in completing the onFinish callback of marquee animation');
        })
    }
    .width('100%')
    .height('100%')
  }
}
相关推荐
码间留白7 小时前
AI 给的两个方案都被我否了:把 startIcon 与启动遮罩做成同一张图,鸿蒙 APP 冷启动零白屏
性能优化·uni-app·ai编程·harmonyos
二流小码农7 小时前
鸿蒙开发:证书只能创建3个,第4个应用怎么办
android·ios·harmonyos
威哥爱编程11 小时前
模拟面试智能体开发实战 12:每篇都能跑不等于接起来能跑,端到端联调收官把十一块拼图合成一个能用的智能体
python·agent·harmonyos
威哥爱编程11 小时前
模拟面试智能体开发实战 11:报告只躺在后端怎么复盘,把总评搬上手机还要适配大小屏
python·agent·harmonyos
我闪了个去13 小时前
一个 Scroll 撑起整个首页:HarmonyOS 7 懒加载布局把网格、瀑布流、吸顶分组装进一次滚动
harmonyos·arkts
二流小码农1 天前
鸿蒙开发:router组件升级,彻底告别手动配置
android·ios·harmonyos
威哥爱编程2 天前
模拟面试智能体开发实战 09:把面试官装进手机,鸿蒙端聊天界面用 SSE 流式输出让回复逐字滚出来
python·agent·harmonyos
威哥爱编程2 天前
模拟面试智能体开发实战 10:配置写死在代码里还怎么换服务端,把设置和简历做成界面可配、可存
python·agent·harmonyos
Sirius_Ji2 天前
# 一份鸿蒙原生支持硬解的 ffmpeg 开发基座
harmonyos
贾伟康2 天前
HarmonyOS API 26 Navigation路由栈上限:stackSizeLimit、过载保护与容量观测
harmonyos·arkts·navigation·navpathstack·api26