鸿蒙5.0开发进阶:UI框架-ArkTS组件(Marquee)

鸿蒙HarmonyOS NEXT开发:Marquee(基础组件) 跑马灯组件,用于滚动展示一段单行文本。 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


Marquee

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

说明

该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

为了不影响滚动帧率,建议在滚动类组件中Marquee的个数不超过4个,或者使用Text组件的TextOverflow.MARQUEE替代。

子组件

无

接口

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

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
value{ start: boolean, step?: number, loop?: number, fromStart?: boolean, src: string }是

配置跑马灯组件的参数。

- start:控制跑马灯是否进入播放状态。

说明:

有限的滚动次数播放完毕后,不可以通过改变start重置滚动次数重新开始播放。

- step:滚动动画文本滚动步长,当step大于Marquee的文本宽度时,取默认值。

默认值:6,单位vp

- loop:设置重复滚动的次数,小于等于零时无限循环。

默认值:-1

说明:

ArkTS卡片上该参数设置任意值都仅在可见时滚动一次。

- fromStart:设置文本从头开始滚动或反向滚动。

默认值:true

- src:需要滚动的文本。

属性

除支持通用属性外,还支持以下属性:

fontColor

fontColor(value: ResourceColor)

设置字体颜色。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valueResourceColor是字体颜色。

fontSize

fontSize(value: number | string | Resource)

设置字体大小。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valueResource | number | string是字体大小。fontSize为number类型时,使用fp单位。字体默认大小16fp。不支持设置百分比字符串。

fontWeight

fontWeight(value: number | FontWeight | string)

设置文本的字体粗细,设置过大可能会在不同字体下有截断。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valueFontWeight | number | string是

文本的字体粗细,number类型取值[100, 900],取值间隔为100,默认为400,取值越大,字体越粗。string类型仅支持number类型取值的字符串形式,例如"400",以及"bold"、"bolder"、"lighter"、"regular"、"medium",分别对应FontWeight中相应的枚举值。

默认值:FontWeight.Normal

fontFamily

fontFamily(value: string | Resource)

设置字体列表。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valueResource | string是

字体列表。默认字体'HarmonyOS Sans'。

应用当前支持'HarmonyOS Sans'字体和注册自定义字体。

卡片当前仅支持'HarmonyOS Sans'字体。

allowScale

allowScale(value: boolean)

设置是否允许文本缩放。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valueboolean是

是否允许文本缩放。

默认值:false

说明:

仅当fontSize为fp单位时生效。

marqueeUpdateStrategy12+

marqueeUpdateStrategy(value: MarqueeUpdateStrategy)

跑马灯组件属性更新后,跑马灯的滚动策略。(当跑马灯为播放状态,且文本内容宽度超过跑马灯组件宽度时,该属性生效。)

元服务API: 从API version 12开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
valueMarqueeUpdateStrategy是

跑马灯组件属性更新后,跑马灯的滚动策略。

默认值: MarqueeUpdateStrategy.DEFAULT

事件

onStart

onStart(event: () => void)

当滚动的文本内容变化或者开始滚动时触发回调。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

onBounce

onBounce(event: () => void)

完成一次滚动时触发,若循环次数不为1,则该事件会多次触发。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

onFinish

onFinish(event: () => void)

滚动全部循环次数完成时触发回调。

卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

示例

该示例通过设置start、step、loop、fromStart、src、marqueeUpdateStrategy展示了跑马灯内容动态更新时运行的效果。

// xxx.ets
@Entry
@Component
struct MarqueeExample {
  @State start: boolean = false
  @State src: string = ''
  @State marqueeText: string = 'Running Marquee'
  private fromStart: boolean = true
  private step: number = 10
  private loop: number = Number.POSITIVE_INFINITY
  controller: TextClockController = new TextClockController()
  convert2time(value: number): string{
    let date = new Date(Number(value+'000'));
    let hours = date.getHours().toString().padStart(2, '0');
    let minutes = date.getMinutes().toString().padStart(2, '0');
    let seconds = date.getSeconds().toString().padStart(2, '0');
    return hours+ ":" + minutes + ":" + seconds;
  }

  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.marqueeText + this.src
      })
        .marqueeUpdateStrategy(MarqueeUpdateStrategy.PRESERVE_POSITION)
        .width('300vp')
        .height('80vp')
        .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')
        })
      Button('Start')
        .onClick(() => {
          this.start = true
          // 启动文本时钟
          this.controller.start()
        })
        .width('120vp')
        .height('40vp')
        .fontSize('16fp')
        .fontWeight(500)
        .backgroundColor('#007DFF')
      TextClock({ timeZoneOffset: -8, controller: this.controller })
        .format('hms')
        .onDateChange((value: number) => {
          this.src = this.convert2time(value);
        })
        .margin('20vp')
        .fontSize('30fp')
    }
    .width('100%')
    .height('100%')
  }
}

HarmonyOS Next开发学习手册——旋转屏动画增强 在原旋转屏动画基础上,可配置渐隐和渐现的转场效果。完整的代码示例和效果如下。需要在EntryAbility.ets文件的onWindowStageCreate方法中添加处理逻辑以获取屏幕的显示方向需要在项目的 module.json5 文件中的 abilities 列表里添加 “orientation”,指定为 “auto_rotation” 阅读详情

相关推荐

HarmonyOS鸿蒙开发指南:基础组件 marquee开发指导

跑马灯的次数设置为1,在结束的时候触发finish事件使跑马灯的次数加1,字体颜色变为随机颜色,调用start方法使跑马灯再次开始滚动。通过scrollamount、loop和direction属性实现跑马灯滚动时移动的最大长度、滚动次数和文字滚动方向。Marquee通过color和font-weight属性设置跑马灯中文本的颜色、字体粗细和边框样式。当loop的值小于等于零时,跑马灯marquee将连续滚动。如果loop未指定,则默认为-1。本场景可以控制跑马灯文字的滚动和暂停。

斌擎科技 1147

【鸿蒙软件开发】ArkTS基础组件之Marquee(文字跑马灯)、QRCode(二维码生成)

Marquee组件:跑马灯组件,用于滚动展示一段单行文本,仅当文本内容宽度超过跑马灯组件宽度时滚动。QRCode组件:用于显示单个二维码的组件。Marquee组件:跑马灯组件,用于滚动展示一段单行文本,仅当文本内容宽度超过跑马灯组件宽度时滚动。QRCode组件:用于显示单个二维码的组件。

m0_62599305的博客 2545

PMOS缓启动电路设计实战:用LTspice优化上电时序,把60A冲击降到15A

本文通过一个实战案例,深入解析了PMOS缓启动电路如何有效抑制上电冲击电流。文章指出,低ESR电容是导致冲击电流飙升的元凶,并详细阐述了利用LTspice仿真工具,通过优化栅极电阻和栅源电容等参数,将高达60A的冲击电流成功降至15A的设计与优化过程,为电源开关电路设计提供了可复用的方法论。

onion的博客 902

鸿蒙开发组件之跑马灯Marquee

鸿蒙封装了跑马灯组件Marquee,使用起来确实很简单。需要注意的是想要让跑马灯效果动起来,需要设置。

Lu_Ca的博客 1000

从零到一:如何用YOLOv8和PyQt5打造你的第一个花卉识别桌面应用

本文详细介绍了如何使用YOLOv8和PyQt5从零开始构建一个花卉识别桌面应用。涵盖环境搭建、数据准备、模型训练、界面设计、模型集成与性能优化等全流程,帮助开发者快速掌握深度学习目标识别技术的实际应用。

weixin_29048775的博客 456

无感无刷电机控制进阶:反电动势过零检测的5种实现方案对比

本文深入探讨无感无刷电机控制中反电动势过零检测的5种实现方案,包括电阻分压虚拟中性点法、专用BEMF检测IC方案、基于ADC采样的数字锁相环、无传感器观测器技术及混合方案创新实践。通过对比分析各方案的优劣及适用场景,为电机控制工程师提供实用的技术选型指南,助力提升系统性能与成本效益。

weixin_28691741的博客 852

鸿蒙应用开发学习:用Marquee组件做个跑马灯

鸿蒙应用的学习持续进行中,这两天阅读官方的API参考文档,发现一个有趣的组件——Marquee,用它做了个跑马灯,做个学习记录。

bahamutj的博客 1743

Protege新手必看:从安装到建模的完整指南(附推理功能详解)

本文为Protege新手提供从安装、配置到核心建模的完整实战指南。详细讲解了Java环境准备、本体项目创建、类与属性定义、个体填充等关键步骤,并重点解析了推理功能的配置与使用,帮助读者快速构建可逻辑推理的知识图谱,避开常见陷阱。

numpy6sculptor的博客 799

鸿蒙5.0开发进阶:UI框架-ArkTS组件(Text)

显示一段文本的组件。

Androidbye的博客 1052

紫光同创国产FPGA学习之Fabric Debugger

文章从紫光同创参考书拷贝过来的。因为我用的时候,看了一下就会用了(纯粹只是会用了,默认和xilinx的一样),没有看教程。先更新点文本,后面在写程序。 一、      软件简介 Fabric Debugger是一款界面化的FPGA芯片调试工具,能够针对公司目前以及未来的FPGA芯片进行在线调试。本软件直接与JtagHub、DebugCore交互,能够实时的配置目标FPGA、设置触发条件并且观测结...

my_share的专栏 6397

YOLO小目标检测优化:9种实用方案,准确率直接提升15%

小目标检测是个系统工程,没有银弹,但有明确的优化路径。优先搞数据。Copy-Paste + 提升分辨率,这俩加起来成本最低、收益最大,能解决80%的小目标问题。别一上来就改模型结构。调参走在改结构前面。锚框聚类、损失加权、增强优化,这些都是零成本的,先做满了再说改模型的事。P2层是大杀器,但不要轻易用。加了P2层,TensorRT部署、后处理、速度都要跟着调,工程化工作量翻倍。数据和训练做到位还不够,再加也不迟。滑动窗口是兜底的。能从训练端解决的问题,就不要拖到推理端。

专注于Python爬虫开发,分享爬虫技巧、项目实战与反爬经验,使用Scrapy、BeautifulSoup等工具,解决数据抓取难题。 196

鸿蒙5.0版开发:UI框架JS组件-基础组件(marquee)

跑马灯组件,用于展示一段单行滚动的文字。

m0_69424697的博客 788

SAP_ABAP_MM_BAPI清单案例教程——采购发票校验/预制_BAPI_INCOMINGINVOICE_PARK_MIRO

SAP ABAP BAPI_INCOMINGINVOICE_PARK BAPI 采购发票预制 采购发票校验 代码模版

java_zhong1990的专栏 1966

【鸿蒙next开发】ArkUI框架:ArkTS组件-Text

本文详细介绍了鸿蒙5.0开发中的Text组件及其相关功能。

m0_73088370的博客 1296

道威棱镜的设计参考

道威棱镜的设计参考

weixin_72050316的博客 383

复分析 阿尔福斯(Ahlfors) 第三版答案 英文

答案分为十章,有部分习题没有答案,全英文复分析阿尔福斯(Ahlfors) 第三版答案

鸿蒙5.0进阶开发:UI开发-容器组件(marquee开发)

marquee为跑马灯组件,用于展示一段单行滚动的文字。

AyomQAQ的博客 445

Camera2Demo

在Camera2 的基础上进行封装,使得Camera2一堆初始化逻辑与Activity分离,降低耦合度,完成预览拍照并保存的操作

HarmonyOS 6.1 API23 Marquee组件开发实操文档

本文档总结了HarmonyOS 6.1(API23)中Marquee组件的开发经验,重点解决了电商长标题等场景下的滚动展示问题。核心改进包括:新增spacing参数(纯数字,单位vp)控制内容间距,scrollAmount参数调节滚动速度,以及原生onClick实现点击暂停/恢复功能。文档提供完整ArkTS实现代码,对比新旧版本差异,并给出常见问题排查方案(如单位类型错误、状态更新失效等)。针对开发环境异常情况,推荐使用远程模拟器或CSS模拟方案快速验证效果。该方案显著提升了Marquee的视觉流畅度和交互

listening777的博客 209

LinePhone3.2.7(android端最新版本) sip客户端

SIP客户端For android:LinePhone3.2.7(最新版本),官网地址:http://www.linphone.org/

IEM模型,地表粗糙度模拟

利用微波反演土壤水分时候,利用IEM模型可以实现对随机地表的模拟

鸿蒙开发之ArkUI实现文本首尾循环滚动效果

本文介绍了在鸿蒙应用开发中实现文本首尾相接循环滚动的解决方案。通过Scroll组件与Text组件的结合使用,当文本宽度超出可视区域时,系统会自动计算组件宽度并添加辅助文本,利用animateTo动画实现平滑偏移效果。文章详细讲解了实现思路,包括宽度判断、动画控制和停滞间隔设置,并提供了高性能实现建议(LazyForLoad懒加载和animateTo动画)。该方案克服了传统Marquee组件的局限,可应用于检票口等需要动态展示信息的场景,附完整工程结构和示例代码。

mn_xiaona666的博客 756

【共创季稿事节】HarmonyOS 6.1 API23新特性实战:Marquee跑马灯组件进阶用法

本文基于HarmonyOS 6.1(API23)环境实测Marquee组件三大增强特性:支持spacing参数设置首尾间距(单位vp),解决文本衔接生硬问题;新增scrollAmount直接控制滚动速度(vp/秒);原生支持onClick绑定状态变量实现点击暂停/恢复功能。文章提供可直接复用的电商长标题场景代码示例,并指出三个典型踩坑点:spacing参数需传number而非字符串、Color枚举需显式导包、Preview缓存刷新问题。实测表明,API23的Marquee改进精准解决了旧版痛点,仅需少量代码

listening777的博客 224

HarmonyOS7 公告跑马灯页实战:Marquee 不只是会用,还要用得顺手

这个例子不复杂,但很适合反复看。很多 ArkUI 页面写不顺,其实不是组件不会用,而是状态、结构和反馈没有放在一起设计。

2301_78784268的博客 255

HarmonyOS ArkTS 实战:实现一个校园三好学生优秀干部评选应用

评选通知查看在线申请材料上传评选进度同学投票结果公示获奖证书我的申请评选标准历年获奖id: number;id: number;实现了评选通知、在线申请、材料提交、投票、结果公示、证书等功能。掌握了申请流程、投票逻辑、状态流转、荣誉展示等。后续可加入导师推荐、综测加分计算、答辩安排、异议申诉、奖学金发放等功能。

qq_57869879的博客 159

ArkTs日常开发

日常代码

shiyibushiwei的博客 513

HarmonyOS Marquee组件深度解析:构建高性能滚动视觉效果

在移动应用开发中,滚动文本展示(俗称跑马灯)是一种常见的UI交互模式,广泛应用于新闻标题、股票行情、公告通知等场景。HarmonyOS作为华为推出的分布式操作系统,其Marquee组件提供了强大而灵活的文本滚动能力。本文将深入探讨HarmonyOS Marquee组件的核心原理、高级用法和性能优化策略,帮助开发者构建更加出色的滚动视觉效果。HarmonyOS的Marquee组件基于ArkUI框架构建,其核心架构如下: 基础属性详解 高级滚动效果实现 多段变速滚动效果 在实际应用中,单一的滚动速度往往无法满

不懂先生的博客 453

Text 组件完全指南的 ArkUI 实践:把页面结构、状态与反馈做扎实

回过头看,Text并不复杂,但它的能力是分层的:最底层是"显示字符串",往上是"好看"(字号字重颜色间距),再往上是"有结构"(Span 富文本),然后是"有反应"(状态与事件),最后是"排得下"(布局约束与截断)。标题、标签 → 基础用法 + 样式;价格、热度、说明 → Span 富文本;计数、状态提示 → 交互与状态;卡片标题、列表项 → 布局与截断。把这几层吃透,你在 ArkUI 里写文字类 UI 基本不会再卡壳。可编辑富文本:研究RichEditor,它是Text。

autumn2005的博客 430

鸿蒙OpenHarmony【Marquee】信息展示

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

asfn123123的博客 1185

鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之Marquee组件

鸿蒙(HarmonyOS)项目方舟框架(ArkUI)之Marquee组件。

zy0412326的专栏 1033
上一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(LoadingProgress)
下一篇: 鸿蒙5.0开发进阶:UI框架-ArkTS组件(PatternLock)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值