HarmonyOS 多设备短视频开发 : 12 — 基础组件 Text、Image、Button 实战
12 — 基础组件 Text、Image、Button 实战一、引言Text、Image、Button 是 ArkUI 中使用频率最高的三个基础组件Text 承载文字、Image 承载图片、Button 承载交互。在短视频应用里大到视频标题、作者昵称小到点赞图标、发送按钮全部由它们组合而成。本文结合multi-short-video项目的评论区与视频页代码讲解这三个组件的关键属性与工程化组合方式。二、Text 文本组件自适应字号与富文本Text 的属性覆盖字体、字号、字重、颜色、行高、对齐、截断等方方面面。项目中字号并没有写死而是采用系统字体资源$r(sys.float.xxx)随设备与系统设置自适应。评论区昵称的写法如下features/multishortvideocomment/src/main/ets/view/Comment.etsText(item.item.name) .fontSize(deviceInfo.deviceType tv ? 22 : $r(sys.float.Body_M)) .fontColor(new WidthBreakpointTypeResourceColor($r(sys.color.font_primary), $r(sys.color.font_primary), $r(sys.color.font_on_primary), $r(sys.color.font_on_primary)).getValue(this.windowInfo.widthBp)) .fontWeight($r(sys.float.font_weight_medium))这里的字号在智慧屏上放大到 22大屏远距离观看需要更大字重其余设备使用Body_M系统字号颜色则按断点取浅色/深色两套资源保证在亮色与暗色场景下都清晰可读。当一段文本需要混排多种样式时使用Span子组件。评论区中时间 · 地点的呈现Text() { Span(item.item.date).fontSize($r(sys.float.Caption_L)).fontColor(...) Span(CommonConstants.MIDDLE_DOT_SYMBOL).fontSize($r(sys.float.Caption_L)).fontColor(...) Span(item.item.location).fontSize($r(sys.float.Caption_L)).fontColor(...) }视频页正文的截断处理则展示了maxLines与textOverflow的组合Text($r(app.string.body_text)) .maxLines(new WidthBreakpointTypenumber(2, 2, 2, 2, 1).getValue(this.windowInfo.widthBp)) .textOverflow({ overflow: TextOverflow.Ellipsis })三、Image 图片组件资源加载与裁剪模式Image 支持网络图、本地$r(app.media.xxx)资源、PixelMap 等多种来源并可通过objectFit控制裁剪策略。公共组件common/multishortvideobase/src/main/ets/components/MSVTextIcon.ets中的图标实现Image(this.src) .width(this.iconSize) .aspectRatio(1) .objectFit(ImageFit.Contain)图标通常为正方形资源aspectRatio(1)保证宽高比为 1:1ImageFit.Contain让图标完整显示不裁剪。而作品封面则相反需要填满且裁掉多余部分features/multishortvideoindividual/src/main/ets/view/Works.ets中Stack({ alignContent: Alignment.BottomStart }) { Image(item.item.pic) .width(100%) .height(100%) .objectFit(ImageFit.Cover) // 等比放大填满超出部分裁剪 ... }模式行为典型场景Contain完整显示可能留白图标、头像Cover填满容器裁剪溢出视频封面、背景图Fill拉伸填满可能变形特殊占位Auto默认等比缩放一般图文四、按钮的工程实现MSVTextIcon TapGesture短视频场景的按钮点赞、评论、分享与传统 Button 形态差异很大它们常是图标计数组合、半透明悬浮于视频之上、随点赞状态切换图标。项目没有直接使用 Button 组件而是用MSVTextIcon组合 gesture(TapGesture)实现AdaptiveVideo.ets中的点赞与评论入口MSVTextIcon({ src: $r(app.media.ic_heart_fill), iconOnly: false, content: 1557, iconSize: new WidthBreakpointTypenumber(32, 32, 32, 32, 24).getValue(this.windowInfo.widthBp) }) MSVTextIcon({ src: $r(app.media.ic_message_fill), iconOnly: false, content: 566, iconSize: 32 }) .gesture( TapGesture() .onAction(() { if (this.showSideComment || this.windowInfo.widthBp WidthBreakpoint.WIDTH_XS) { return; } if (this.windowInfo.widthBp WidthBreakpoint.WIDTH_SM) { this.showSideComment true; this.pathStack.pushPathByName(SplitComment, null); } else { this.showComment true; // 小屏走半模态弹窗 } }))相比 Button这种方案的优势一是图标与文字间距、颜色完全可控二是手势可叠加TapGesture以外的手势如长按三是组件本身可复用同一MSVTextIcon同时出现在评论区、个人页与视频页。若项目需要标准按钮可在MSVTextIcon外再包一层Button或使用onClick本质都是组件组合 事件绑定。五、组件间组合头像与点赞按钮的完整实现评论区中头像 昵称 作者标识与点赞数 点赞图标分别组成左右两组再经justifyContent(FlexAlign.SpaceBetween)分布到整行Row() { Row({ space: 12 }) { MSVTextIcon({ src: item.item.pic, iconSize: deviceInfo.deviceType tv ? 44 : 32 }) Row({ space: 4 }) { Text(item.item.name).fontSize(...) if (item.item.id 0) { // 仅作者显示作者徽标 Row() { Text($r(app.string.author))... } .border({ width: 1, color: ... }).borderRadius(4) } } } Row({ space: 4 }) { Text(item.item.likes).fontSize($r(sys.float.Caption_L))... MSVTextIcon({ src: ...ic_heart..., iconSize: 16 }) } } .width(CommonConstants.FULL_PERCENT) .justifyContent(FlexAlign.SpaceBetween) .alignItems(VerticalAlign.Center)这套组合充分体现了基础组件的复用价值头像与点赞图标复用了MSVTextIcon昵称与点赞数复用了带链式属性的 Text作者徽标通过if条件渲染按需出现——小而精的基础组件通过组合就能支撑起完整的业务界面。六、总结与最佳实践字号交给系统资源优先$r(sys.float.xxx)而非写死数值并针对智慧屏等大屏用deviceInfo.deviceType单独放大。Image 选对裁剪模式图标用Contain封面/背景用Cover并用aspectRatio稳定宽高比。不要迷信 Button交互按钮的本质是组件手势MSVTextIcon TapGesture更契合短视频场景的定制化需求。组合优于继承把高频基础组合抽成MSVTextIcon这样的公共组件评论区、视频页、个人页统一复用。深色模式同步图标与文字颜色通过断点取浅/深两套资源如ic_heart与ic_heart_light避免深色下图标不可见。

相关新闻

HarmonyOS 多设备短视频开发 : 11 — ArkUI 声明式开发范式

HarmonyOS 多设备短视频开发 : 11 — ArkUI 声明式开发范式

11 — ArkUI 声明式开发范式 一、引言HarmonyOS ArkUI 采用声明式开发范式,开发者只需要描述"界面长什么样、数据如何驱动界面",而无需关心"如何一步步把控件添加到屏幕上"。相比传统的命令式开发(如安卓 View 体系的 fi…

2026/11/19 22:01:09 阅读更多 →
Jetpack Compose ConstraintLayout:从约束关系理解到工程实践

Jetpack Compose ConstraintLayout:从约束关系理解到工程实践

Jetpack Compose 的 ConstraintLayout,是我见过最多安卓开发者上手时都会卡一下的组件。说它卡,不是 API 多难,而是很多人带着 XML 时代的使用惯性来理解它,结果发现在 Compose 里,ConstraintLayout 既不是默认布局&am…

2026/11/19 22:01:09 阅读更多 →
AI作业批改系统架构设计:从OCR识别到大模型评分的完整实现

AI作业批改系统架构设计:从OCR识别到大模型评分的完整实现

开学第三周,一位初中数学老师向我抱怨:一个班 45 人,每人 8 道大题,批改加写评语花了两个半小时。批完之后,她只知道哪些题错误率高,却说不清每个学生的薄弱知识点到底在哪个环节。这不是个例,而…

2026/11/18 20:48:35 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/19 21:38:27 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/19 21:38:49 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/19 21:39:09 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/19 21:36:50 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/19 21:37:45 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/19 21:36:20 阅读更多 →

日新闻

周新闻

月新闻