HarmonyOS7 综合富文本排版页:用 Span 把富文本组合做得更顺手

发布时间:2026/9/12 20:12:03

HarmonyOS7 综合富文本排版页:用 Span 把富文本组合做得更顺手 文章目录前言学习目标一步步理解实现过程关键代码为什么这样写完整代码真实业务里的取舍可以怎么改前言这篇继续聊 HarmonyOS7 里的Text 富文本综合。如果你刚开始学 ArkUI不建议一上来就背属性名那样很容易看完就忘。更好的方式是先搞清楚这个页面想解决什么问题用户做了什么操作代码又是怎么把这个操作反映到界面上的。这个案例的核心是Span它对应的使用场景是富文本组合。我会把它当成一个真实业务里的小模块来拆而不是只贴一段代码结束。读完之后你至少应该能知道这几件事问题答案学什么Span在富文本组合场景里的用法看哪里状态字段、核心组件、事件回调重点综合排版适合谁刚接触 HarmonyOS7 声明式 UI 的同学学习目标先把页面目标说清楚。这个案例不是为了炫技而是展示一个常见交互片段页面上有内容展示有样式区分也有用户操作后的反馈。小白读这类代码时最容易犯的错误是从第一行样式属性开始抠细节结果看了半天不知道页面到底在干什么。我更建议按这个顺序看找到State确认页面有哪些会变化的数据。找到核心组件比如Span看看它接收了哪些参数。找到onChange、onClick或类似回调理解用户操作之后状态怎么变。最后再看颜色、圆角、间距这些样式属性。这样读下来哪怕代码比较长也不会迷路。一步步理解实现过程ArkUI 的声明式 UI 有个特点界面是状态的结果。你不用手动去找某个控件再改它的文本而是改状态框架会根据状态重新刷新相关 UI。在这个案例里布局一般由Column、Row、Scroll、Grid这些容器搭起来。它们负责“东西放在哪里”Span负责“这个功能怎么表现”事件回调负责“用户操作后发生什么”。三者配合起来页面才是完整的。下面这段关键代码可以先看一遍它保留了入口组件和核心逻辑EntryComponentstruct RichTextCompositionPage{StateisShow:booleantruebuild(){Column(){if(this.isShow){Scroll(){Column({space:16}){Text(综合富文本段落).fontSize(14).fontColor(THEME_COLOR).fontWeight(700)Text(){Span(【).fontSize(16).fontColor(#FF6B6B).fontWeight(700)Span(公告).fontSize(18).fontColor(#FF6B6B).fontWeight(900).decoration({type:TextDecorationType.Underline,color:#FF6B6B})Span(】).fontSize(16).fontColor(#FF6B6B).fontWeight(700)Span( HarmonyOS ).fontSize(20).fontColor(THEME_COLOR).fontWeight(700)关键代码为什么这样写把上面的代码拆开看会更容易理解State是页面的记忆点输入、点击、选择这类变化都会先落到这里。这里有一个很实用的判断方法如果你删掉某个状态字段页面还是否能表达当前交互如果不能说明这个状态就是业务状态如果删掉只是少了颜色或间距那它更多是视觉层面的东西。对新手来说先区分“业务状态”和“样式配置”很重要。很多页面写乱都是因为把这两类东西混在一起了。完整代码下面是完整代码。文章里的组件名已经换成更贴近业务的英文命名可以直接复制到独立页面里阅读。建议你先跑原样再尝试改一个状态字段或一个样式属性看界面怎么变化。import{LengthMetrics}fromkit.ArkUIconstPAGE_BG_COLOR:string#F5F6FAconstCARD_BG_COLOR:string#FFFFFFconstTHEME_COLOR:string#4D96FFconstSUBTEXT_COLOR:string#8A8A8AEntryComponentstruct RichTextCompositionPage{StateisShow:booleantruebuild(){Column(){if(this.isShow){Scroll(){Column({space:16}){Text(综合富文本段落).fontSize(14).fontColor(THEME_COLOR).fontWeight(700)Text(){Span(【).fontSize(16).fontColor(#FF6B6B).fontWeight(700)Span(公告).fontSize(18).fontColor(#FF6B6B).fontWeight(900).decoration({type:TextDecorationType.Underline,color:#FF6B6B})Span(】).fontSize(16).fontColor(#FF6B6B).fontWeight(700)Span( HarmonyOS ).fontSize(20).fontColor(THEME_COLOR).fontWeight(700).shadow({radius:2,color:rgba(0,125,255,0.3),offsetX:1,offsetY:1})Span(6.0 版本).fontSize(16).fontColor(#333333)Span(Beta).fontSize(11).baselineOffset(LengthMetrics.vp(-10)).fontColor(#FFD93D).fontWeight(700)Span( 已正式发布采用 ).fontSize(16).fontColor(#555555)Span(全新).fontSize(18).fontStyle(FontStyle.Italic).fontColor(#9B59B6).fontWeight(700)Span( ArkUI V).fontSize(16).fontColor(#555555)Span(3).fontSize(12).baselineOffset(LengthMetrics.vp(-8)).fontColor(THEME_COLOR).fontWeight(700)Span( 框架性能提升 ).fontSize(16).fontColor(#555555)Span(30%).fontSize(22).fontWeight(900).fontColor(#FF6B6B)Span( 请开发者及时升级。).fontSize(16).fontColor(#555555)}.lineHeight(28).backgroundColor(#FAFAFA).padding(14).borderRadius(10)Text(){Span(关键特性).fontSize(14).fontWeight(700).fontColor(#333333).letterSpacing(2)Span(多设备协同 ).fontSize(14).fontColor(#FFA500).fontWeight(600)Span(| 分布式软总线 ).fontSize(14).fontColor(#4ECDC4).fontWeight(600)Span(| ).fontSize(14)Span(原子化服务).fontSize(14).fontColor(THEME_COLOR).fontWeight(600).decoration({type:TextDecorationType.Underline,color:THEME_COLOR})Span( | 统一开发体验).fontSize(14).fontColor(#6BCB77).fontWeight(600)}.lineHeight(24).backgroundColor(#F8F8F8).padding(12).borderRadius(8)Text(){Span(开发框架).fontSize(12).fontColor(SUBTEXT_COLOR)Span( ).fontSize(12)Span(ArkTS).fontSize(16).fontWeight(700).fontColor(#4D96FF)Span( ).fontSize(14).fontColor(#CCCCCC)Span(ArkUI).fontSize(16).fontWeight(700).fontColor(#9B59B6)Span( ).fontSize(14).fontColor(#CCCCCC)Span(ArkCompiler).fontSize(16).fontWeight(700).fontColor(#FF6B9D)}.backgroundColor(#FCFCFC).padding(12).borderRadius(8)}.width(100%).padding(16).backgroundColor(CARD_BG_COLOR).borderRadius(12)}}Text(综合富文本排版页Text 综合文本全部文本特性融合展示).fontSize(12).fontColor(SUBTEXT_COLOR).margin({top:12})}.width(100%).height(100%).backgroundColor(PAGE_BG_COLOR).padding(16)}}真实业务里的取舍如果把这个案例放进真实项目我会额外注意这些点命名要清楚状态字段最好能直接看出用途不要都叫value或flag。边界要处理空内容、超长内容、禁用状态、加载状态都要提前考虑。样式要克制颜色和阴影不是越多越好能表达层级就够了。交互要有反馈用户点了、输入了、选择了页面要给出明确变化。这些不是语法问题但会直接影响页面质量。可以怎么改这个案例可以继续往两个方向练。一个方向是改数据把静态内容换成数组或接口返回另一个方向是改交互比如增加清空、重置、禁用、加载中等状态。学 HarmonyOS7 组件时不要只满足于“代码能跑”。能说清楚为什么这么写才算真正理解了这个案例。
延伸阅读

更多相关文章

2026/9/11 7:54:36

TDA7468与PIC18F87J50构建高性能音频处理系统

1. 音频处理系统的核心组件解析在构建高性能音频处理系统时,TDA7468音频处理器与PIC18F87J50微控制器的组合堪称黄金搭档。这套方案特别适合需要多路音频输入选择、实时音效处理和智能控制的场景,比如家庭Hi-Fi系统、专业录音设备或车载音响系统。TDA746…

2026/9/10 12:02:53

YOLOv8工地运输车识别检测系统:从环境配置到部署优化

1. 先搞清楚这个项目到底能解决什么实际问题这个YOLOv8工地运输车识别检测系统,核心解决的是施工现场车辆管理的自动化识别问题。很多工地需要统计运输车进出次数、监控作业区域车辆活动、或者区分不同类型的运输车辆(比如渣土车、混凝土搅拌车、材料运输…

2026/9/8 11:15:20

HarmonyOS7 基线偏移公式排版:用 baselineOffset 把公式排版做得更顺手

文章目录前言使用场景先讲清楚代码阅读顺序重点实现细节完整代码容易踩坑的地方收个尾前言 这篇继续聊 HarmonyOS7 里的 baselineOffset 基线偏移。如果你刚开始学 ArkUI,不建议一上来就背属性名,那样很容易看完就忘。更好的方式是先搞清楚:…

2026/9/12 20:11:01

MySQL-存储过程与函数

1.存储过程概述1.1理解含义:存储过程的英文是Stored Procedure.他的思想很简单,就是一组经过预先编译的SQL语句的封装.执行过程:存储过程预先存储在MySQL服务器上,需要执行的时候,客户端只需要向服务器端发出调用存储过程的命令,服务器端就可以把预先存储好的这一系列SQL语句全…

2026/9/12 20:11:01

高校食堂外卖系统开发:SSM框架实践与高并发处理

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/12 20:11:01

Claude智能体开发:效率提升10倍的技术解析

1. Claude Managed Agents技术解析:智能体开发的新范式Claude Managed Agents的发布标志着智能体开发进入了一个全新阶段。这个由Anthropic推出的托管式智能体平台,从根本上重构了开发者和AI协作的工作流程。与传统的智能体开发框架相比,其核…

2026/9/12 20:06:01

Python入门怎么学?新手3步写出第一段代码

好多人有着学习的意愿, 然而却老是被困在那样一种阶段, 即看过了数目众多的教程, 可依旧没办法写出代码来。实际上呢, 对于新手初步接触编程来说, 并不用在刚开始的时候就去谋求复杂的项目, 只需要先把第一段代码书写出来, 这才是构建信心的关键所在。要学会运用最短的路径去顺…

2026/9/12 2:05:33

超人会飞不算本事:系统稳定依赖清晰规则与边界设计

开头先不绕弯子。“#斯坦李吐槽dc 所以超人是无缘无故会飞的嘛哈哈哈哈哈哈哈锤哥真是技术人才啊!#雷神 #复联”这类调侃式短标题,第一波冲击力在于它把两个宇宙的角色塞进同一个吐槽箱里,但细想一下就能发现,它真正碰到的根本不是…

2026/9/12 3:55:12

超人VS蜘蛛侠:拆解超级IP的影响力与传播方法论

把“蜘蛛侠 vs 超人”放在 CSDN 上聊,可能很多人第一反应是走错片场了。但如果把这两个角色看成“两个持续运营了 80 多年的文化产品”,你会发现,这场比较本质上是两个不同 IP 策略的长期结果对比:超人赢在定义了整个超级英雄题材…

2026/9/12 10:09:03

基于CNN的调制信号识别:MATLAB实现时频图分类实战

简介:本资源是一套面向通信工程与信号处理方向学习者、研究者的深度学习实践方案,聚焦调制信号自动检测与识别这一典型无线通信任务,解决传统方法依赖人工特征、低信噪比下性能下降等痛点。压缩包共12个文件(10.73MB)&…

2026/9/12 0:04:17

MATLAB仿生优化框架:长鼻浣熊算法多策略融合实现

简介:本资源是一份面向智能优化算法研究者与MATLAB初学者的仿生智能算法实践代码包,聚焦于长鼻浣熊优化算法(COA)的多策略改进与性能验证。针对传统COA易陷局部最优、收敛精度不足等问题,作者融合Circle映射初始化提升…

2026/9/12 0:04:17

【JAVA毕设源码分享】基于 JavaWeb 的校园一卡通管理系统的设计与实现 基于 JavaWeb 的校园卡业务管理系统(程序+文档+代码讲解+一条龙定制)

博主介绍:✌️码农一枚 ,专注于大学生项目实战开发、讲解和毕业🚢文撰写修改等。全栈领域优质创作者,博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战 ✌️技术范围:&am…

2026/9/12 0:04:17

【JAVA毕设源码分享】基于 Java 的图书馆借阅管理平台的搭建与实现 基于 Java 的图书馆综合管理系统(程序+文档+代码讲解+一条龙定制)

博主介绍:✌️码农一枚 ,专注于大学生项目实战开发、讲解和毕业🚢文撰写修改等。全栈领域优质创作者,博客之星、掘金/华为云/阿里云/InfoQ等平台优质作者、专注于Java、小程序技术领域和毕业项目实战 ✌️技术范围:&am…

2026/9/12 6:29:36

USB Type-C PCB布局分区设计:电源、高速信号与PD协议全攻略

做硬件这行,Type-C接口算是典型的“看着简单,做起来全坑”的东西。光引脚就24个,高低速信号、电源、控制线全部塞在一个小小的连接器里,如果PCB布局不做规划,打样回来基本就是“插上没反应”、“高速掉线”、“静电一打…

2026/9/12 14:32:17

系统编程学习原型如何补齐稳定性边界

系统编程学习原型如何补齐稳定性边界预算有限时&#xff0c;我先优化明显多余的复制&#xff0c;而不是猜测性地换容器。用借用传递只读数据通常就能减少分配&#xff1a; fn parse(line: &str) -> Result<Item, Error> { /* ... */ }用基准确认热点确实在分配&am…

2026/9/12 6:37:43

雨花区哪家财务公司代理记账比较好?

在雨花区&#xff0c;企业处理财税事务常常面临诸多挑战&#xff0c;选择一家靠谱的财务公司至关重要。湖南巨勤财务管理咨询有限公司就是本地正规实体财税服务机构&#xff0c;深耕本地工商财税行业多年&#xff0c;熟悉当地工商局、税务局最新政策与申报流程。主营公司注册、…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
咨询二维码