鸿蒙HarmonyOS NEXT开发：RichText（基础组件）

RichText

富文本组件，解析并显示HTML格式文本。

• 适用场景：

  RichText组件适用于加载与显示一段HTML字符串，且不需要对显示效果进行较多自定义的应用场景。RichText组件仅支持有限的通用属性和事件。具体见属性与事件小节。

  RichText组件底层复用了Web组件来提供基础能力，包括但不限于HTML页面的解析、渲染等。因此使用RichText组件需要遵循Web约束条件。常见典型约束如下：

  移动设备的视口默认值大小为980px，默认值可以确保大部分网页在移动设备下可以正常浏览。如果RichText组件宽度低于这个值，content内部的HTML则可能会产生一个可以滑动的页面被RichText组件包裹。如果想替换默认值，可以在content中添加以下标签：

  <span style="background-color:#f6f8fa"><span style="color:#000000"><code><img data-cke-saved-src="https://docs.openharmony.cn/copy.png" src="https://docs.openharmony.cn/copy.png" alt="" width="20" height="20" class="copy-img" /><span style="color:#000000"><<span style="color:olive">meta</span> name=<span style="color:green">"viewport"</span> content=<span style="color:green">"width=device-width"</span>></span>
  <strong>html</strong></code></span></span>

• 不适用场景：

  RichText组件不适用于对HTML字符串的显示效果进行较多自定义的应用场景。例如RichText组件不支持通过设置属性与事件，来修改背景颜色、字体颜色、字体大小、动态改变内容等。在这种情况下，推荐使用Web组件。

  RichText组件比较消耗内存资源，而且有一些重复使用RichText组件的场景下，比如在List下循环重复使用RichText时，会出现卡顿、滑动响应慢等现象。在这种情况下，推荐使用RichEditor组件。

说明：

• 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
• 该组件无法根据内容自适应设置宽高属性，需要开发者设置显示布局。

子组件

不包含子组件。

接口

RichText(content:string)

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

参数:

参数名	参数类型	必填	参数描述
content	string	是	表示HTML格式的字符串。

事件

onStart

onStart(callback: () => void)

加载网页时触发。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

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

onComplete

onComplete(callback: () => void)

网页加载结束时触发。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

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

属性

只支持通用属性中width，height，size，layoutWeight四个属性。由于padding，margin，constraintSize属性使用时与通用属性描述不符，暂不支持。

支持标签

名称	描述	示例
<h1>–<h6>	被用来定义HTML，<h1>定义重要等级最高的标题，<h6>定义重要等级最低的标题。	<h1>这是一个标题</h1><h2>这是h2标题</h2>
<p></p>	定义段落。	<p>这是一个段落</p>
<br/>	插入一个简单的换行符。	<p>这是一个段落<br/>这是换行段落</p>
<font/>	规定文本的字体、字体尺寸、字体颜色。在标签中font size能够设置的值只有1到7的数字，默认值是3，由于标签在HTML 4.01中不建议使用，在XHTML1.0 Strict DTD中不支持，所以不建议使用此标签，请使用CSS代替。CSS语法：<p style=“font-size: 35px; font-family: verdana; color: rgb(24,78,228)”>	<font size=“3” face=“arial” color=“red”>这是一段红色字体。</font>
<hr/>	定义HTML页面中的主题变化（比如话题的转移），并显示为一条水平线。	<p>这个一个段落</p><hr/><p>这是一个段落</p>
<image></image>	用来定义图片。	<image src=“resource://rawfile/icon.png”></image>
<div></div>	常用于组合块级元素，以便通过CSS来对这些元素进行格式化。	<div style=‘color:#0000FF’><h3>这是一个在div元素中的标题。</h3></div>
<i></i>	定义与文本中其余部分不同的部分，并把这部分文本呈现为斜体文本。	<i>这是一个斜体</i>
<u></u>	定义与常规文本风格不同的文本，像拼写错误的单词或者汉语中的专有名词，应尽量避免使用<u>为文本加下划线，用户会把它混淆为一个超链接。	<p><u>这是带有下划线的段落</u></p>
<style></style>	定义HTML文档的样式信息。	<style>h1{color:red;}p{color:blue;}</style>
style	属性规定元素的行内样式，写在标签内部，在使用的时候需用引号来进行区分，并以; 间隔样式，style=‘width: 500px;height: 500px;border: 1px soild;margin: 0 auto;’。	<h1 style=‘color:blue;text-align:center’>这是一个标题</h1><p style=‘color:green’>这是一个段落。</p>
<script></script>	用于定义客户端脚本，比如JavaScript。	<script>document.write(“Hello World!”)</script>

示例

示例效果请以真机运行为准，当前IDE预览器不支持。

<span style="background-color:#f6f8fa"><span style="color:#000000"><code><img data-cke-saved-src="https://docs.openharmony.cn/copy.png" src="https://docs.openharmony.cn/copy.png" alt="" width="20" height="20" class="copy-img" /><span style="color:green">// xxx.ets</span>
<span style="color:green">@Entry</span>
<span style="color:green">@Component</span>
struct <span style="color:#0055af">RichTextExample</span> {
  <span style="color:green">@State</span> data: <span style="color:green">string</span> = <span style="color:green">'<h1 style="text-align: center;">h1标题</h1>'</span> +
  <span style="color:green">'<h1 style="text-align: center;"><i>h1斜体</i></h1>'</span> +
  <span style="color:green">'<h1 style="text-align: center;"><u>h1下划线</u></h1>'</span> +
  <span style="color:green">'<h2 style="text-align: center;">h2标题</h2>'</span> +
  <span style="color:green">'<h3 style="text-align: center;">h3标题</h3>'</span> +
  <span style="color:green">'<p style="text-align: center;">p常规</p><hr/>'</span> +
  <span style="color:green">'<div style="width: 500px;height: 500px;border: 1px solid;margin: 0 auto;">'</span> +
  <span style="color:green">'<p style="font-size: 35px;text-align: center;font-weight: bold; color: rgb(24,78,228)">字体大小35px,行高45px</p>'</span> +
  <span style="color:green">'<p style="background-color: #e5e5e5;line-height: 45px;font-size: 35px;text-indent: 2em;">'</span> +
  <span style="color:green">'<p>这是一段文字这是一段文字这是一段文字这是一段文字这是一段文字这是一段文字这是一段文字这是一段文字这是一段文字</p>'</span>;

  <span style="color:#000000">build</span>() {
    <span style="color:#0055af">Flex</span>({ direction: <span style="color:#0055af">FlexDirection</span>.Column, alignItems: <span style="color:#0055af">ItemAlign</span>.Center,
      justifyContent: <span style="color:#0055af">FlexAlign</span>.Center }) {
      <span style="color:#0055af">RichText</span>(<span style="color:#0055af">this</span>.data)
        .<span style="color:#000000">onStart</span>(<span style="color:olive">() =></span> {
          <span style="color:#0055af">console</span>.<span style="color:#000000">info</span>(<span style="color:green">'RichText onStart'</span>);
        })
        .<span style="color:#000000">onComplete</span>(<span style="color:olive">() =></span> {
          <span style="color:#0055af">console</span>.<span style="color:#000000">info</span>(<span style="color:green">'RichText onComplete'</span>);
        })
        .<span style="color:#000000">width</span>(<span style="color:navy">500</span>)
        .<span style="color:#000000">height</span>(<span style="color:navy">500</span>)
        .<span style="color:#000000">backgroundColor</span>(<span style="color:navy">0XBDDB69</span>)
      <span style="color:#0055af">RichText</span>(<span style="color:green">'layoutWeight(1)'</span>)
        .<span style="color:#000000">onStart</span>(<span style="color:olive">() =></span> {
          <span style="color:#0055af">console</span>.<span style="color:#000000">info</span>(<span style="color:green">'RichText onStart'</span>);
        })
        .<span style="color:#000000">onComplete</span>(<span style="color:olive">() =></span> {
          <span style="color:#0055af">console</span>.<span style="color:#000000">info</span>(<span style="color:green">'RichText onComplete'</span>);
        })
        .<span style="color:#000000">size</span>({ width: <span style="color:green">'100%'</span>, height: <span style="color:navy">110</span> })
        .<span style="color:#000000">backgroundColor</span>(<span style="color:navy">0X92D6CC</span>)
        .<span style="color:#000000">layoutWeight</span>(<span style="color:navy">1</span>)
      <span style="color:#0055af">RichText</span>(<span style="color:green">'layoutWeight(2)'</span>)
        .<span style="color:#000000">onStart</span>(<span style="color:olive">() =></span> {
          <span style="color:#0055af">console</span>.<span style="color:#000000">info</span>(<span style="color:green">'RichText onStart'</span>);
        })
        .<span style="color:#000000">onComplete</span>(<span style="color:olive">() =></span> {
          <span style="color:#0055af">console</span>.<span style="color:#000000">info</span>(<span style="color:green">'RichText onComplete'</span>);
        })
        .<span style="color:#000000">size</span>({ width: <span style="color:green">'100%'</span>, height: <span style="color:navy">110</span> })
        .<span style="color:#000000">backgroundColor</span>(<span style="color:navy">0X92C48D</span>)
        .<span style="color:#000000">layoutWeight</span>(<span style="color:navy">2</span>)
    }
  }
}
<strong>ts</strong></code></span></span>

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、OpenHarmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS NEXT学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

 

•  HarmonOS基础技能

• HarmonOS就业必备技能 
•  HarmonOS多媒体技术

• 鸿蒙NaPi组件进阶

• HarmonOS高级技能

• 初识HarmonOS内核 
• 实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS NEXT学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

 《鸿蒙开发基础》

• ArkTS语言
• 安装DevEco Studio
• 运用你的第一个ArkTS应用
• ArkUI声明式UI开发
• .……

 《鸿蒙开发进阶》

• Stage模型入门
• 网络管理
• 数据管理
• 电话服务
• 分布式应用开发
• 通知与窗口管理
• 多媒体技术
• 安全技能
• 任务管理
• WebGL
• 国际化开发
• 应用测试
• DFX面向未来设计
• 鸿蒙系统移植和裁剪定制
• ……

《鸿蒙进阶实战》

• ArkTS实践
• UIAbility应用
• 网络案例
• ……

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS NEXT学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。