复杂文本绘制与显示（ArkTS）
================

在进行文本绘制时，可以通过选择合适的字体、大小和颜色完成简单文本的绘制与显示；此外，还支持通过设置其他丰富的样式、语言、段落等进行复杂文本的绘制。

复杂文本绘制主要包含以下几个场景：

*   多语言文本绘制与显示
    
*   多行文本绘制与显示
    
*   多样式文本绘制与显示
    

#### 多语言文本绘制与显示

多语言支持是全球化应用的基础。多语言文本绘制需要支持不同语言的字符集及其独特的显示需求，例如右到左语言（如阿拉伯语）或竖排文本（如中文）。开发者需要理解不同语言的渲染特性，确保文本的正确显示。

在多语言文本使用的场景下，主要通过指定[TextStyle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-graphics-text#textstyle)文本样式中的**locale**字段来实现，可直接通过locale字段的值优先匹配对应字体，跳过遍历列表匹配字体的过程，从而降低匹配时间和内存使用。

#### \[h2\]开发步骤

1.  通过context获取到Canvas画布对象。
    
    // 绘制代码逻辑写在这里
    let canvas = context.canvas;
    
2.  初始化文本样式。
    
    let myTextStyle: text.TextStyle = {
      color: {
        alpha: 255,
        red: 255,
        green: 0,
        blue: 0
      },
      fontSize: 50,
      // 设置语言偏好为简体中文
      locale: 'zh-Hans'
    };
    
3.  初始化段落样式。
    
    let myParagraphStyle: text.ParagraphStyle = {
      textStyle: myTextStyle,
    };
    
4.  初始化段落对象，并添加文本。
    
    let fontCollection = text.FontCollection.getGlobalInstance();
    let paragraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);
    // 更新文本样式
    paragraphBuilder.pushStyle(myTextStyle);
    // 添加文本
    paragraphBuilder.addText('你好，世界');
    
5.  排版段落并进行文本绘制。
    
    // 生成段落
    let paragraph = paragraphBuilder.build();
    // 布局
    paragraph.layoutSync(1250);
    // 绘制文本
    paragraph.paint(canvas, 10, 0);
    

#### \[h2\]效果展示

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/bb/v3/6ZOEaUvAQzi8SiW_hQ9Lgw/zh-cn_image_0000002633849500.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=35491540B5200BB352094BD7B528E3651290894BDFF2F06A711702138FE0E04C)

#### 多行文本绘制与显示

多行文本相对于单行文本比较复杂，一般针对多行文本，需要进行文本排版、断词策略设置、文本对齐方式、最大行数限制等，主要通过设置段落样式实现。

#### \[h2\]实现说明

**段落样式**（[ParagraphStyle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-graphics-text#paragraphstyle)）是对多行文本中每段内容的样式设置，包括断词策略、文本对齐方式、最大行数限制等。开发者可以通过对不同段落进行样式化，以提高文本的可读性和美观性。

#### \[h2\]开发步骤

1.  通过context获取到Canvas画布对象。
    
    // 绘制代码逻辑写在这里
    let canvas = context.canvas;
    
2.  初始化文本样式。
    
    let myTextStyle: text.TextStyle = {
      color: {
        alpha: 255,
        red: 255,
        green: 0,
        blue: 0
      },
      fontSize: 50,
      // 当wordBreak为text.WordBreak.BREAK\_HYPHEN时，需要为段落设置语言偏好，段落会在不同语言偏好下呈现不同的文本断词效果
      locale: 'en-gb'
    };
    
3.  初始化段落样式。
    
    let myParagraphStyle: text.ParagraphStyle = {
      textStyle: myTextStyle,
      // 文本对齐方式
      align: text.TextAlign.LEFT,
      // 最大行数
      maxLines: 3,
      // 断词策略
      wordBreak: text.WordBreak.BREAK\_WORD
    };
    
4.  初始化段落对象，并添加文本。
    
    let fontCollection = text.FontCollection.getGlobalInstance();
    let paragraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);
    // 更新文本样式
    paragraphBuilder.pushStyle(myTextStyle);
    // 添加文本
    paragraphBuilder.addText('Hello World Hello World Hello World Hello World Hello World Hello World ' +
      'Hello World Hello World Hello World Hello World Hello World Hello World Hello World Hello World ' +
      'Hello World Hello World Hello World Hello World Hello World ');
    
5.  排版段落并进行文本绘制。
    
    // 生成段落
    let paragraph = paragraphBuilder.build();
    // 布局
    paragraph.layoutSync(1250);
    // 绘制文本
    paragraph.paint(canvas, 10, 0);
    

#### \[h2\]效果展示

| 段落样式设置（断词策略、文本对齐方式、最大行数限制） | 效果示意 |
| :-- | :-- |
| 文本对齐方式为text.TextAlign.LEFT，最大行数为3，断词策略为text.WordBreak.BREAK\_WORD。 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/94/v3/2mImtZsoRSyrcJfjgmE9mA/zh-cn_image_0000002634009404.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=D3C30844AEDC96CC8E119FACFF489F7CD5700CC85B80ED8AFAE6EFEEB5C30A54) |
| 文本对齐方式为text.TextAlign.RIGHT，最大行数为3，断词策略为text.WordBreak.BREAK\_WORD。 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8f/v3/Vp3yQGm9RqG9eIX6rvufBg/zh-cn_image_0000002664208553.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=612402190FD7B333D4EB527BE424C9C84E8454434991817B725418EAEC464D4F) |
| 文本对齐方式为text.TextAlign.JUSTIFY，最大行数为10，断词策略为text.WordBreak.BREAK\_WORD。 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7a/v3/RVtu2hMPTa-Ti_8NhZLu6w/zh-cn_image_0000002664328613.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=4E90721F8381E44D4420B1AD9C71FFE2A7E2BB804C88E0CAC8F26B59D5470013) |
| 文本对齐方式为text.TextAlign.LEFT，最大行数为3，断词策略为text.WordBreak.BREAK\_ALL。 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b8/v3/N6Wx_jEvRBq8qT1FeTyybw/zh-cn_image_0000002633849502.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=2987710B537E1423E7D3CDBCE5024DC472FE716291F1B1DEE12C63C0F176B636) |
| 文本对齐方式为text.TextAlign.LEFT，最大行数为10，断词策略为text.WordBreak.BREAK\_ALL。 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/20/v3/ZXz7LpP9Tha-zLqEEoQl4A/zh-cn_image_0000002634009406.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=06B5018EEC23AF0E131BCA0EDEDFC377BA580BE96DE8A234B7515896C24F5AF4) |
| 
文本对齐方式为text.TextAlign.LEFT，最大行数为10，断词策略为text.WordBreak.BREAK\_HYPHEN，

不设置语言偏好。段落无连字符“-”断词效果。

 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2d/v3/j0JtVdmjT-OkavaXRwaPDA/zh-cn_image_0000002664208555.jpg?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=BEC115D583E57D017A61CDE6E10F3C31DA65AC93472A75258D0B5A48C65FB2DE) |
| 

文本对齐方式为text.TextAlign.LEFT，最大行数为10，断词策略为text.WordBreak.BREAK\_HYPHEN，

语言偏好为en-gb（英式英语）。段落产生连字符“-”断词效果，并根据语言偏好呈现英式语言环境断词效果。

 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/58/v3/nr75q604SuaoyGK4cmMmuQ/zh-cn_image_0000002664328615.jpg?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=33AB0AD69FA4768B1C0EA502DEEA460A9F3F4134D1DFD6D77EE824D3F6A18093) |
| 

文本对齐方式为text.TextAlign.LEFT，最大行数为10，断词策略为text.WordBreak.BREAK\_HYPHEN，

语言偏好为en-us（美式英语）。段落产生连字符“-”断词效果，并根据语言偏好呈现美式语言环境断词效果。

 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cf/v3/exav8nqLS3u_ZcyGf-JYbA/zh-cn_image_0000002633849504.jpg?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=C5DF640296015D464323323F7FBFC88207C68057DDDD96A91EDA517E5E5C98CD) |

#### 多样式文本绘制与显示

除基本文字、排版属性之外，针对应用中不同文本的设计，开发者可能需要设置使用不同的绘制样式或能力，以凸显对应文本的独特表现或风格，此时可以结合使用多种绘制样式进行文本的渲染。

当前支持的多样式绘制及各绘制样式侧重效果如下：

*   **装饰线样式绘制：** 主要通过不同的线条样式对文本进行装饰，可以使文本更加突出，富有表现力。
    
*   **字体特性绘制：** 主要通过字体的变化，包括粗细、斜体等特性来改变文本的外观，增强文本的可读性和美观性。
    
*   **可变字体绘制：** 对应提供文本在不同的显示环境和设备上灵活调整的能力，可满足更为精细的视觉效果。
    
*   **文本阴影绘制：** 主要通过在文本周围添加阴影效果，以提升文本的层次感和立体感，从而使文本更具吸引力。
    
*   **占位符绘制：** 可以在不确定文本内容时保持文本布局的稳定性，使得文本显示更为流畅和自然。
    
*   **自动间距绘制：** 可以在一些字符混排切换的地方自动添加额外间距，提升阅读体验。
    
*   **垂直对齐：** 调整文本在垂直方向排版位置，提升排版质量。
    
*   **上下标：** 可以将任意字符处理成上标或下标，更精准表达文本含义。
    
*   **高对比度文字绘制：** 主要通过将深色文字变黑、浅色文字变白，增强文本的对比效果。
    
*   **行高调整：** 调整行高可改变文本行的垂直间距，使行间距更松散或更紧凑，显著改善文本垂直截断问题，提高可读性。
    
*   **行间距调整：** 通过调整行间距的方式可以实现行高调整一样的效果，优化阅读体验。
    
*   **省略号样式设置：** 在文本内容超出显示区域时，可以使用省略号截断文本，支持头部、中部、尾部以及多行省略模式。
    
*   **文字换行方式设置：** 文本排版时支持不同的断行策略，可根据场景选择合适的换行方式。
    
*   **行首标点压缩：** 在排版中，通过开启行首标点压缩功能，将行首标点符号进行挤压处理，避免标点占用行首空间，提升排版紧凑度。
    

#### \[h2\]装饰线

装饰线（[Decoration](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-graphics-text#decoration)）是指在文本上方、下方或中间添加的装饰性线条，当前支持上划线、下划线、删除线。

可以通过添加文本装饰线，提升文本的视觉效果和可读性。

使用装饰线需要初始化装饰线样式对象，并添加到文本样式中，从而在文本绘制时生效。

具体使用效果可参见下文[示例一](#示例一装饰线字体特征)。

#### \[h2\]字体特征

**字体特征**（[FontFeature](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-graphics-text#fontfeature)）绘制专注于在文本渲染过程中对字体特性（如粗体、斜体、字体变种等）的处理，允许字体在不同的排版场景下表现出不同的效果，可用于增强文本的表现力，使其更符合设计和阅读需求。

常见的**FontFeature**包含有liga、frac、case等，需要对应的ttf文件支持才能正常使能。

具体使用效果可参见下文[示例一](#示例一装饰线字体特征)。

#### \[h2\]可变字体

**可变字体**（[FontVariation](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-graphics-text#fontvariation)）是一种在一个字体文件中包含多个字形变体的字体格式，允许在一个字体文件内灵活地调整字体的各种属性（如字重、字宽、斜体等）。

与传统字体文件（每种变体需要一个独立的文件）不同，可变字体在一个字体文件中包含多个变体轴，可通过使用可变字体实现文本渲染绘制时的平滑过渡。

具体使用效果可参见下文[示例二](#示例二可变字体文本阴影占位符)。

#### \[h2\]文本阴影

**文本阴影**（[TextShadow](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-graphics-text#textshadow)）为文本提供了深度感，使得文本在背景上更具立体感。通常用于提升文本的视觉吸引力或增强可读性，尤其是在色彩对比度较低的场景下。

其中，TextShadow有三个属性，分别为阴影颜色color、阴影基于当前文本的偏移位置point、阴影半径blurRadius。

使用阴影效果需要在文本样式中设置对应的阴影效果数组，从而在文本绘制时生效。

具体使用效果可参见下文[示例二](#示例二可变字体文本阴影占位符)。

#### \[h2\]占位符

占位符绘制用于处理文本中占位符符号的渲染。

占位符也是用来实现图文混排的关键，是指在实际图像或内容注册之前，用来预先提供或替代某个位置的视觉元素。

具体使用效果可参见下文[示例二](#示例二可变字体文本阴影占位符)。

#### \[h2\]自动间距

使能自动间距，则会在文本排版时自动调整CJK（中文字符、日文字符、韩文字符）与西文（拉丁字母、西里尔字母、希腊字母）、CJK与数字、CJK与版权符号、版权符号与数字、版权符号与西文之间的间距。例如，在中英文混排场景中，使能自动间距即可在中英文切换的地方自动添加额外间距，提升阅读体验。

关键示例如下：

let myParagraphStyle: text.ParagraphStyle = {
  autoSpace: true
};

#### \[h2\]垂直对齐

垂直对齐用于调整文本在一行中垂直方向的排版位置。开启行高缩放或行内存在不同字号文本混排时使能垂直对齐，可以让文本实现顶部对齐、居中对齐、底部对齐或基线对齐（默认）。关键代码如下：

let myParagraphStyle: text.ParagraphStyle = {
  verticalAlign: text.TextVerticalAlign.CENTER
};

具体使用效果可参见下文[示例三](#示例三垂直对齐)。

#### \[h2\]上下标

使能上下标，能将文本作为上标或下标参与排版。一般用于数学公式、化学式等场景。关键代码如下：

let superScriptStyle: text.TextStyle = {
    badgeType: text.TextBadgeType.TEXT\_SUPERSCRIPT
};

具体使用效果可参见下文[示例四](#示例四上下标文本)。

#### \[h2\]高对比度

高对比度可将深色文字变黑、浅色文字变白。开发者可选择开启或关闭应用的高对比度文字渲染，或遵循系统设置中的高对比度文字配置。

高对比度模式有3种，具体参考[TextHighContrast](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-graphics-text#texthighcontrast20)。

具体使用效果可参见下文[示例五](#示例五高对比度)。

#### \[h2\]行高调整

当前行高调整方式包括两种：设置行高上限/下限和使用行高缩放系数。

**行高调整（方式一）**

从API version 21开始，支持通过设置行高上限和下限调整行高，关键代码如下：

let myTextStyle: text.TextStyle = {
    // 设置行高上限
    lineHeightMaximum: 65,
    // 设置行高下限
    lineHeightMinimum: 65
};

使用效果参考下文[示例六](#示例六行高调整方式一)。

**行高调整（方式二）**

通过设置行高缩放系数调整行高，关键代码如下：

let myTextStyle: text.TextStyle = {
    // 开启行高缩放开关
    heightOnly: true,
    // 设置行高缩放系数
    heightScale: 1.5,
    // 设置行高缩放风格
    lineHeightStyle: text.LineHeightStyle.FONT\_HEIGHT
};

使用效果参考下文[示例七](#示例七行高调整方式二)。

#### \[h2\]行间距调整

从API version 21开始，支持设置行间距改善文本行之间的距离，提高阅读体验，关键代码如下：

let myParagraphStyle: text.ParagraphStyle = {
  // 设置行间距
  lineSpacing: 100,
  // 关闭段落上升部和下降部
  textHeightBehavior: text.TextHeightBehavior.DISABLE\_ALL,
};

具体使用效果可参见下文[示例八](#示例八行间距调整)。

#### \[h2\]省略号样式设置

从API version 22开始，支持设置省略号样式，在文本内容超出显示区域时截断文本。从API version 24开始，支持多行省略模式。

通过[ParagraphStyle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-graphics-text#paragraphstyle)中的textStyle属性设置省略号模式，可选的省略号模式可见[EllipsisMode](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-graphics-text#ellipsismode)。

需要注意，省略号相关属性需要在ParagraphStyle的textStyle中设置才生效，通过pushStyle设置的省略号属性不会生效。

具体使用效果可参见下文[示例九](#示例九省略号样式)。

#### \[h2\]文字换行方式设置

从API version 22开始，支持在文本排版时设置断行策略，断行策略决定了文本如何在行尾进行换行处理。

通过设置[ParagraphStyle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-graphics-text#paragraphstyle)中的breakStrategy属性可以控制断行策略，可选的断行策略可见[BreakStrategy](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-graphics-text#breakstrategy)。

具体使用效果可参见下文[示例十](#示例十文字换行方式)。

#### \[h2\]行首标点压缩

从API version 23开始，在文本排版中支持行首标点压缩功能。通过启用行首标点压缩功能，可以将行首标点符号进行挤压处理，提升排版紧凑度。

通过设置[ParagraphStyle](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-graphics-text#paragraphstyle)中的compressHeadPunctuation属性设置是否启用行首标点压缩。

具体使用效果可参见下文[示例十一](#示例十一行首标点压缩)。

#### \[h2\]示例一（装饰线、字体特征）

import { NodeController, FrameNode, RenderNode, DrawContext } from '@kit.ArkUI'
import { UIContext } from '@kit.ArkUI'
import { text } from '@kit.ArkGraphics2D'

// 创建一个MyRenderNode类，并绘制文本。
class MyRenderNode extends RenderNode {
  async draw(context: DrawContext) {
    let canvas = context.canvas;

    // 初始化装饰线对象
    let decorations: text.Decoration =
      {
        // 装饰线类型，支持上划线、下划线、删除线
        textDecoration: text.TextDecorationType.UNDERLINE,
        // 装饰线颜色
        color: {
          alpha: 255,
          red: 255,
          green: 0,
          blue: 0
        },
        // 装饰线样式，支持波浪，虚线，直线等
        decorationStyle:text.TextDecorationStyle.SOLID,
        // 装饰线的高度
        decorationThicknessScale: 1
      };

    let myTextStyle: text.TextStyle = {
      color: {
        alpha: 255,
        red: 255,
        green: 0,
        blue: 0
      },
      fontSize: 200,
      // 设置装饰线
      decoration: decorations,
      // 开启字体特征
      fontFeatures: \[{name: 'frac', value: 1}\]
    };

    let myParagraphStyle: text.ParagraphStyle = {
      textStyle: myTextStyle,
    };

    let fontCollection = text.FontCollection.getGlobalInstance();
    let paragraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);

    // 更新文本样式
    paragraphBuilder.pushStyle(myTextStyle);
    // 添加文本
    paragraphBuilder.addText('1/2 1/3 1/4 ');

    // 生成段落
    let paragraph = paragraphBuilder.build();
    // 布局
    paragraph.layoutSync(1250);
    // 绘制文本
    paragraph.paint(canvas, 0, 0);
  }
}

// 创建一个MyRenderNode对象
const textNode = new MyRenderNode();
// 定义newNode的像素格式
textNode.frame = {
  x: 0,
  y: 0,
  width: 400,
  height: 600
};
textNode.pivot = { x: 0.2, y: 0.8 };
textNode.scale = { x: 1, y: 1 };

class MyNodeController extends NodeController {
  private rootNode: FrameNode | null = null;

  makeNode(uiContext: UIContext): FrameNode {
    this.rootNode = new FrameNode(uiContext);
    if (this.rootNode == null) {
      return this.rootNode;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.frame = {
        x: 0,
        y: 0,
        width: 10,
        height: 500
      }
    }
    return this.rootNode;
  }

  addNode(node: RenderNode): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.appendChild(node);
    }
  }

  clearNodes(): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.clearChildren();
    }
  }
}

let myNodeController: MyNodeController = new MyNodeController();

async function performTask() {
  myNodeController.clearNodes();
  myNodeController.addNode(textNode);
}

@Entry
@Component
struct Font08 {
  @State src: Resource = $r('app.media.startIcon');
  build() {
    Column() {
      Row() {
        NodeContainer(myNodeController)
          .height('100%')
          .width('100%')
        Image(this.src)
          .width('0%').height('0%')
          .onComplete(
            () => {
              performTask();
            })
      }
      .width('100%')
    }
  }
}

具体示意效果如下所示：

| 样式设置（装饰线样式、字体特征） | 示意效果 |
| :-- | :-- |
| 不开启装饰线和字体特征 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5b/v3/rBXuOiCvScyyt4MQ43YOYQ/zh-cn_image_0000002634009408.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=1FA0342FC6CDEB58A667ACF320D32F27DEDF39128746627FB94DC38F10A15770) |
| 开启装饰线和字体特征 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4d/v3/pU7s83QASbmXtnQkF4YE8Q/zh-cn_image_0000002664208557.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=49616A73F6BF2472DBC2E45FC4504B8C63769E1A9CE9E8BF5E244DF0B1E51824) |

#### \[h2\]示例二（可变字体、文本阴影、占位符）

这里以可变字体、文本阴影、占位符三个特性为例，呈现多样式文本的绘制与显示。

import { NodeController, FrameNode, RenderNode, DrawContext } from '@kit.ArkUI'
import { UIContext } from '@kit.ArkUI'
import { drawing } from '@kit.ArkGraphics2D'
import { text } from '@kit.ArkGraphics2D'
import { common2D } from '@kit.ArkGraphics2D'

// 创建一个MyRenderNode类，并绘制文本。
class MyRenderNode extends RenderNode {
  async draw(context: DrawContext) {
    let canvas = context.canvas;

    let myTextStyle: text.TextStyle = {
      color: {
        alpha: 255,
        red: 255,
        green: 0,
        blue: 0
      },
      fontSize: 120,
      // 可变字体
      fontVariations: \[{axis: 'wght', value: 555}\],
      // 文本阴影
      textShadows: \[{color: { alpha: 0xFF, red: 0xFF, green: 0x00, blue: 0x00 }, point: {x:10,y:10}, blurRadius: 10}\],
    };

    let myParagraphStyle: text.ParagraphStyle = {
      textStyle: myTextStyle,
    };

    let fontCollection = text.FontCollection.getGlobalInstance();
    let paragraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);

    // 初始化占位符对象
    let myPlaceholderSpan: text.PlaceholderSpan = {
      // 宽度
      width: 300,
      // 高度
      height: 300,
      // 基线对齐策略
      align: text.PlaceholderAlignment.BOTTOM\_OF\_ROW\_BOX,
      // 使用的文本基线类型
      baseline: text.TextBaseline.ALPHABETIC,
      // 相比基线的偏移量。只有对齐策略是OFFSET\_AT\_BASELINE时生效
      baselineOffset: 100
    };
    // 添加占位符
    paragraphBuilder.addPlaceholder(myPlaceholderSpan);

    // 更新文本样式
    paragraphBuilder.pushStyle(myTextStyle);
    // 添加文本
    paragraphBuilder.addText('Hello Test');

    // 生成段落
    let paragraph = paragraphBuilder.build();
    // 布局
    paragraph.layoutSync(1250);
    // 绘制文本
    paragraph.paint(canvas, 0, 0);

    // 获取全部占位符的数组
    let placeholderRects = paragraph.getRectsForPlaceholders();
    // 获取第一个占位符的左边界
    let left = placeholderRects\[0\].rect.left;
    // 获取第一个占位符的上边界
    let top = placeholderRects\[0\].rect.top;
    // 获取第一个占位符的右边界
    let right = placeholderRects\[0\].rect.right;
    // 获取第一个占位符的下边界
    let bottom = placeholderRects\[0\].rect.bottom;
    let pen: drawing.Pen =  new drawing.Pen();
    let penColor : common2D.Color = { alpha: 0xFF, red: 0xFF, green: 0x00, blue: 0x00 };
    pen.setColor(penColor);
    canvas.attachPen(pen);
    // 使用draw方法绘制占位符矩形框
    canvas.drawRect(left,top,right,bottom);
  }
}

// 创建一个MyRenderNode对象
const textNode = new MyRenderNode();
// 定义newNode的像素格式
textNode.frame = {
  x: 0,
  y: 0,
  width: 400,
  height: 600,
};
textNode.pivot = { x: 0.2, y: 0.8 };
textNode.scale = { x: 1, y: 1 };

class MyNodeController extends NodeController {
  private rootNode: FrameNode | null = null;

  makeNode(uiContext: UIContext): FrameNode {
    this.rootNode = new FrameNode(uiContext);
    if (this.rootNode == null) {
      return this.rootNode;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.frame = {
        x: 0,
        y: 0,
        width: 10,
        height: 500
      };
    }
    return this.rootNode;
  }

  addNode(node: RenderNode): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.appendChild(node);
    }
  }

  clearNodes(): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.clearChildren();
    }
  }
}

let myNodeController: MyNodeController = new MyNodeController();

async function performTask() {
  myNodeController.clearNodes();
  myNodeController.addNode(textNode);
}

@Entry
@Component
struct Font08 {
  @State src: Resource = $r('app.media.startIcon');
  build() {
    Column() {
      Row() {
        NodeContainer(myNodeController)
          .height('100%')
          .width('100%')
        Image(this.src)
          .width('0%').height('0%')
          .onComplete(
            () => {
              performTask();
            })
      }
      .width('100%')
    }
  }
}

具体示意效果如下所示：

| 样式设置（可变字体、文本阴影、占位符） | 示意效果 |
| :-- | :-- |
| 不开启可变字体和文本阴影，不使用占位符 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/42/v3/Up4HovwSQuu3da6YgDnhjA/zh-cn_image_0000002664328617.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=926FED37037AE88F14FACED3B4AA5F19723ED4F32160047BA7A63FE92B9EA8C2) |
| 开启可变字体和文本阴影，使用占位符 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2a/v3/1MCSL_YUSfSgvQvTzvy2WQ/zh-cn_image_0000002633849506.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=BE48FC192CA43ACD6EADE799116E0C974F0F3214AF302D85C22036DE0F4519AC) |

#### \[h2\]示例三（垂直对齐）

这里以垂直对齐-居中对齐特性为例，呈现文本垂直方向排版的特性。

import { NodeController, FrameNode, RenderNode, DrawContext, UIContext } from '@kit.ArkUI'
import { text } from '@kit.ArkGraphics2D'

// 创建一个MyRenderNode类，并绘制文本。
class MyRenderNode extends RenderNode {
  async draw(context: DrawContext) {
    let canvas = context.canvas;

    let myTextStyle: text.TextStyle = {
      color: {
        alpha: 255,
        red: 255,
        green: 0,
        blue: 0
      },
      fontSize: 30,
      // 开启行高缩放
      heightOnly: true,
      // 行高缩放系数为字号的2倍
      heightScale: 2
    };

    let myParagraphStyle: text.ParagraphStyle = {
      textStyle: myTextStyle,
      // 设置垂直对齐-居中对齐模式
      verticalAlign: text.TextVerticalAlign.CENTER,
    };

    let fontCollection = text.FontCollection.getGlobalInstance();
    let paragraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);

    // 设置待排版文本要应用的样式
    paragraphBuilder.pushStyle(myTextStyle);
    // 添加文本
    paragraphBuilder.addText('VerticalAlignment-center');

    // 生成段落
    let paragraph = paragraphBuilder.build();
    // 布局
    paragraph.layoutSync(1000);
    // 绘制文本
    paragraph.paint(canvas, 0, 0);
  }
}

// 创建一个MyRenderNode对象
const textNode = new MyRenderNode();
// 定义newNode的像素格式
textNode.frame = {
  x: 0,
  y: 0,
  width: 400,
  height: 600
};
textNode.pivot = { x: 0.2, y: 0.8 };
textNode.scale = { x: 1, y: 1 };

class MyNodeController extends NodeController {
  private rootNode: FrameNode | null = null;

  makeNode(uiContext: UIContext): FrameNode {
    this.rootNode = new FrameNode(uiContext);
    if (this.rootNode == null) {
      return this.rootNode;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.frame = {
        x: 0,
        y: 0,
        width: 10,
        height: 500
      }
      renderNode.pivot = { x: 50, y: 50 };
    }
    return this.rootNode;
  }

  addNode(node: RenderNode): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.appendChild(node);
    }
  }

  clearNodes(): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.clearChildren();
    }
  }
}

let myNodeController: MyNodeController = new MyNodeController();

async function performTask() {
  myNodeController.clearNodes();
  myNodeController.addNode(textNode);
}

@Entry
@Component
struct Font08 {
  @State src: Resource = $r('app.media.startIcon');
  build() {
    Column() {
      Row() {
        NodeContainer(myNodeController)
          .height('100%')
          .width('100%')
        Text('Test for vertical alignment')
          .onAppear(() => {
            performTask();
          })
      }
      .width('100%')
    }
  }
}

具体示意效果如下所示：

| 样式设置（垂直对齐） | 示意效果（黑框仅为展示文本绘制区域，实际不绘制） |
| :-- | :-- |
| 基线对齐（默认） | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e3/v3/kQBRNgLMRl6cAoXwPXtdpw/zh-cn_image_0000002634009410.jpg?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=3A8DD7F6BD2F9ADAF00BF8B99AAB12CF0ECA8F6509A5AA84A83207B1EABB2D75) |
| 顶部对齐 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/55/v3/2mZ5JYA8RCe0yRa27aIgvA/zh-cn_image_0000002664208559.jpg?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=8F596A3EF67EAE189BB8B149C71C9E9C20A5C3AF74467D48B2DB71ED7078A60E) |
| 居中对齐 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/2b/v3/vbD0AnyBT9WcYSMU7sjnwA/zh-cn_image_0000002664328619.jpg?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=B737CBF3B9DF73677ADD10D2F43191ED72BA02530DA8AD2EFCB78EFAF7BF26A2) |
| 底部对齐 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a1/v3/lZgx0VbKT62FtxLYt0hJ9g/zh-cn_image_0000002633849508.jpg?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=85DD8A679B0CFF49BCD731DB66AE7F249E0DA49D002D90FF517749617E766E12) |

#### \[h2\]示例四（上下标文本）

这里以下标样式为例，呈现上下标文本排版特性。

import { NodeController, FrameNode, RenderNode, DrawContext, UIContext } from '@kit.ArkUI'
import { text } from '@kit.ArkGraphics2D'

// 创建一个MyRenderNode类，并绘制文本。
class MyRenderNode extends RenderNode {
  async draw(context: DrawContext) {
    let canvas = context.canvas;

    let myTextStyle: text.TextStyle = {
      color: {
        alpha: 255,
        red: 255,
        green: 0,
        blue: 0
      },
      fontSize: 30,
    };

    let subScriptStyle: text.TextStyle = {
      color: {
        alpha: 255,
        red: 255,
        green: 0,
        blue: 0
      },
      fontSize: 30,
      // 设置下标样式
      badgeType: text.TextBadgeType.TEXT\_SUBSCRIPT
    };

    let myParagraphStyle: text.ParagraphStyle = {
      textStyle: myTextStyle,
    };

    let fontCollection = text.FontCollection.getGlobalInstance();
    let paragraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);

    // 设置待排版文本要应用的样式
    paragraphBuilder.pushStyle(myTextStyle);
    // 添加文本
    paragraphBuilder.addText('The chemical formula for water: H');
    paragraphBuilder.pushStyle(subScriptStyle);
    paragraphBuilder.addText('2');
    paragraphBuilder.pushStyle(myTextStyle);
    paragraphBuilder.addText('o');

    // 生成段落
    let paragraph = paragraphBuilder.build();
    // 布局
    paragraph.layoutSync(1000);
    // 绘制文本
    paragraph.paint(canvas, 0, 0);
  }
}

// 创建一个MyRenderNode对象
const textNode = new MyRenderNode();
// 定义newNode的像素格式
textNode.frame = {
  x: 0,
  y: 0,
  width: 400,
  height: 600
};
textNode.pivot = { x: 0.2, y: 0.8 };
textNode.scale = { x: 1, y: 1 };

class MyNodeController extends NodeController {
  private rootNode: FrameNode | null = null;

  makeNode(uiContext: UIContext): FrameNode {
    this.rootNode = new FrameNode(uiContext);
    if (this.rootNode == null) {
      return this.rootNode;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.frame = {
        x: 0,
        y: 0,
        width: 10,
        height: 500
      }
      renderNode.pivot = { x: 50, y: 50 };
    }
    return this.rootNode;
  }

  addNode(node: RenderNode): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.appendChild(node);
    }
  }

  clearNodes(): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.clearChildren();
    }
  }
}

let myNodeController: MyNodeController = new MyNodeController();

async function performTask() {
  myNodeController.clearNodes();
  myNodeController.addNode(textNode);
}

@Entry
@Component
struct Font08 {
  @State src: Resource = $r('app.media.startIcon');
  build() {
    Column() {
      Row() {
        NodeContainer(myNodeController)
          .height('100%')
          .width('100%')
        Text('Test for superscript and subscript')
          .onAppear(() => {
            performTask();
          })
      }
    }
    .width('100%')
  }
}

具体示意效果如下所示：

| 样式设置（上下标） | 示意效果 |
| :-- | :-- |
| 上标文本 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3c/v3/MziEU0xVTCOLq4nNRHSBAg/zh-cn_image_0000002634009412.jpg?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=8028C41CADA12E1C0345F6DE346287064C08273554EA8B604388E7F518DED918) |
| 下标文本 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/92/v3/RuL5b3h2Qk6QwPDepFoE1A/zh-cn_image_0000002664208561.jpg?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=5B26DED1101CBD5497185FECF302D1CC7F3D6FC28DCD2D90963F54CC63E2699F) |

#### \[h2\]示例五（高对比度）

这里以高对比度为例，呈现高对比度文字的绘制与显示。

import { NodeController, FrameNode, RenderNode, DrawContext, UIContext} from '@kit.ArkUI'
import { text } from '@kit.ArkGraphics2D'

// 创建一个MyRenderNode类，并绘制文本。
class MyRenderNode extends RenderNode {
  async draw(context: DrawContext) {
    let canvas = context.canvas;

    // 开启APP的文字渲染高对比度配置
    text.setTextHighContrast(text.TextHighContrast.TEXT\_APP\_ENABLE\_HIGH\_CONTRAST);

    let myTextStyle: text.TextStyle = {
      color: {
        alpha: 255,
        red: 111,
        green: 255,
        blue: 255
      },
      fontSize: 100,
    };

    let myParagraphStyle: text.ParagraphStyle = {
      textStyle: myTextStyle,
    };

    let fontCollection = text.FontCollection.getGlobalInstance();
    let paragraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);

    // 更新文本样式
    paragraphBuilder.pushStyle(myTextStyle);
    // 添加文本
    paragraphBuilder.addText('Hello World');

    // 生成段落
    let paragraph = paragraphBuilder.build();
    // 布局
    paragraph.layoutSync(1250);
    // 绘制文本
    paragraph.paint(canvas, 10, 800);
  }
}

// 创建一个MyRenderNode对象
const textNode = new MyRenderNode();
// 定义newNode的像素格式
textNode.frame = {
  x: 0,
  y: 0,
  width: 400,
  height: 600
};
textNode.pivot = { x: 0.2, y: 0.8 };
textNode.scale = { x: 1, y: 1 };

class MyNodeController extends NodeController {
  private rootNode: FrameNode | null = null;

  makeNode(uiContext: UIContext): FrameNode {
    this.rootNode = new FrameNode(uiContext);
    if (this.rootNode == null) {
      return this.rootNode;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.frame = {
        x: 0,
        y: 0,
        width: 10,
        height: 500
      };
      renderNode.pivot = { x: 0.2, y: 0.8 };
    }
    return this.rootNode;
  }

  addNode(node: RenderNode): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.appendChild(node);
    }
  }

  clearNodes(): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.clearChildren();
    }
  }
}

let myNodeController: MyNodeController = new MyNodeController();

async function performTask() {
  myNodeController.clearNodes();
  myNodeController.addNode(textNode);
}

@Entry
@Component
struct Font08 {
  build() {
    Column() {
      Row() {
        NodeContainer(myNodeController)
          .height('100%')
          .width('100%')
        Text('Test high contrast')
          .onAppear(() => {
            performTask();
          })
      }
      .width('100%')
    }
  }
}

具体示意效果如下所示：

| 高对比度设置 | 示意效果 |
| :-- | :-- |
| 不开启高对比度 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/45/v3/jGt2JaM5StyjPPN9DefrFg/zh-cn_image_0000002664328621.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=0BC32F2D51DACA9E9597B6EFBB79DD7A29BCBDBD864AC794559348AF02C43A93) |
| 开启高对比度 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/46/v3/ePVSh8eBSlmXrLtZEqa43A/zh-cn_image_0000002633849510.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=48C0B7D5DC263BA5ADF4190015653044E0A9C944E55E6B62CB10B0359AE5F1AC) |

#### \[h2\]示例六（行高调整方式一）

这里以行高上限与行高下限设置相同值为例，呈现固定行高时的绘制表现。

import { NodeController, FrameNode, RenderNode, DrawContext, UIContext } from '@kit.ArkUI'
import { text } from '@kit.ArkGraphics2D'

// 创建一个MyRenderNode类，并绘制文本。
class MyRenderNode extends RenderNode {
  async draw(context: DrawContext) {
    let canvas = context.canvas;

    let myTextStyle: text.TextStyle = {
      color: {
        alpha: 255,
        red: 255,
        green: 0,
        blue: 0
      },
      fontSize: 50,
      // 设置行高上限
      lineHeightMaximum: 65,
      // 设置行高下限
      lineHeightMinimum: 65,
    };

    let myParagraphStyle: text.ParagraphStyle = {
      textStyle: myTextStyle,
    };

    let fontCollection = text.FontCollection.getGlobalInstance();
    let paragraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);

    // 设置待排版文本要应用的样式
    paragraphBuilder.pushStyle(myTextStyle);
    // 添加文本
    paragraphBuilder.addText('Hello World!');

    // 生成段落
    let paragraph = paragraphBuilder.build();
    // 布局
    paragraph.layoutSync(1000);
    // 绘制文本
    paragraph.paint(canvas, 0, 0);
  }
}

// 创建一个MyRenderNode对象
const textNode = new MyRenderNode()
// 定义newNode的像素格式
textNode.frame = {
  x: 0,
  y: 0,
  width: 400,
  height: 600
}
textNode.pivot = { x: 0.2, y: 0.8 };
textNode.scale = { x: 1, y: 1 };

class MyNodeController extends NodeController {
  private rootNode: FrameNode | null = null;

  makeNode(uiContext: UIContext): FrameNode {
    this.rootNode = new FrameNode(uiContext)
    if (this.rootNode == null) {
      return this.rootNode;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.frame = {
        x: 0,
        y: 0,
        width: 10,
        height: 500
      }
      renderNode.pivot = { x: 50, y: 50 };
    }
    return this.rootNode;
  }

  addNode(node: RenderNode): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.appendChild(node);
    }
  }

  clearNodes(): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode()
    if (renderNode != null) {
      renderNode.clearChildren();
    }
  }
}

let myNodeController: MyNodeController = new MyNodeController();

async function performTask() {
  myNodeController.clearNodes();
  myNodeController.addNode(textNode);
}

@Entry
@Component
struct Font08 {
  @State src: Resource = $r('app.media.startIcon')
  build() {
    Column() {
      Row() {
        NodeContainer(myNodeController)
          .height('100%')
          .width('100%')
        Text('Test for line height limit')
          .onAppear(() => {
            performTask();
          })
      }
    }
    .width('100%')
  }
}

具体效果如下所示：

| 行高上限值 | 行高下限值 | 示意效果（黑框仅为展示文本绘制区域，实际不绘制） |
| :-- | :-- | :-- |
| 65 | 65 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/12/v3/wc-HLV6wQfmAWIs5Xnra9w/zh-cn_image_0000002634009414.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=34C50719734DB5F70D8171FF5DBF81FA90C5A7220BB8C2D7D7F29484B22BAD5B) |
| 200 | 200 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/22/v3/MudrNrphTVCjB9zD974yNQ/zh-cn_image_0000002664208563.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=05611523911B558BAC8593EA412C88362D14B1E1C1794D1B5B15FA66A73E9B07) |

#### \[h2\]示例七（行高调整方式二）

这里以行高缩放且行高缩放样式FontHeight为例，呈现行高调整后文字的绘制与显示。

import { NodeController, FrameNode, RenderNode, DrawContext, UIContext } from '@kit.ArkUI'
import { text } from '@kit.ArkGraphics2D'

// 创建一个MyRenderNode类，并绘制文本。
class MyRenderNode extends RenderNode {
  async draw(context: DrawContext) {
    let canvas = context.canvas;

    let myTextStyle: text.TextStyle = {
      color: {
        alpha: 255,
        red: 255,
        green: 0,
        blue: 0
      },
      fontSize: 50,
      // 开启行高缩放开关
      heightOnly: true,
      // 设置行高缩放系数
      heightScale: 1.5,
      // 设置行高缩放风格
      lineHeightStyle: text.LineHeightStyle.FONT\_HEIGHT,
    };

    let myParagraphStyle: text.ParagraphStyle = {
      textStyle: myTextStyle,
    };

    let fontCollection = text.FontCollection.getGlobalInstance();
    let paragraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);

    // 设置待排版文本要应用的样式
    paragraphBuilder.pushStyle(myTextStyle);
    // 添加文本
    paragraphBuilder.addText('Hello World!');

    // 生成段落
    let paragraph = paragraphBuilder.build();
    // 布局
    paragraph.layoutSync(1000);
    // 绘制文本
    paragraph.paint(canvas, 0, 0);
  }
}

// 创建一个MyRenderNode对象
const textNode = new MyRenderNode();
// 定义newNode的像素格式
textNode.frame = {
  x: 0,
  y: 0,
  width: 400,
  height: 600
}
textNode.pivot = { x: 0.2, y: 0.8 };
textNode.scale = { x: 1, y: 1 };

class MyNodeController extends NodeController {
  private rootNode: FrameNode | null = null;

  makeNode(uiContext: UIContext): FrameNode {
    this.rootNode = new FrameNode(uiContext)
    if (this.rootNode == null) {
      return this.rootNode;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.frame = {
        x: 0,
        y: 0,
        width: 10,
        height: 500
      };
      renderNode.pivot = { x: 50, y: 50 };
    }
    return this.rootNode;
  }

  addNode(node: RenderNode): void {
    if (this.rootNode == null) {
      return
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.appendChild(node);
    }
  }

  clearNodes(): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode()
    if (renderNode != null) {
      renderNode.clearChildren();
    }
  }
}

let myNodeController: MyNodeController = new MyNodeController();

async function performTask() {
  myNodeController.clearNodes();
  myNodeController.addNode(textNode);
}

@Entry
@Component
struct Font08 {
  @State src: Resource = $r('app.media.startIcon')
  build() {
    Column() {
      Row() {
        NodeContainer(myNodeController)
          .height('100%')
          .width('100%')
        Text('Test for line height limit')
          .onAppear(() => {
            performTask();
          })
      }
    }
    .width('100%')
  }
}

具体效果如下所示：

| 行高缩放样式 | 示意效果（黑框仅为展示文本绘制区域，实际不绘制） |
| :-- | :-- |
| FontSize | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/df/v3/rTzjtSHEQWitpg5zSG_q3Q/zh-cn_image_0000002664328623.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=15954774D7E751296A38CB3A150DF3245B1802045BFC9B86BAAF2893BD21227C) |
| FontHeight | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f1/v3/jlMhsc7XQeG6ZCaJNB6Lsw/zh-cn_image_0000002633849512.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=721EA53BAD32070FF77BF45848A13B01CCD8A8B54D35C72AA4EBFC3EC48B1584) |

#### \[h2\]示例八（行间距调整）

这里以关闭段落上升部下降部并设置行间距为例，呈现行间距增加后的文本绘制与显示。

import { NodeController, FrameNode, RenderNode, DrawContext, UIContext } from '@kit.ArkUI'
import { text } from '@kit.ArkGraphics2D'

// 创建一个MyRenderNode类，并绘制文本。
class MyRenderNode extends RenderNode {
  async draw(context: DrawContext) {
    let canvas = context.canvas;

    let myTextStyle: text.TextStyle = {
      color: {
        alpha: 255,
        red: 255,
        green: 0,
        blue: 0
      },
      fontSize: 50,
    };

    let myParagraphStyle: text.ParagraphStyle = {
      textStyle: myTextStyle,
      // 设置行间距
      lineSpacing: 100,
      // 关闭段落上升部和下降部
      textHeightBehavior: text.TextHeightBehavior.DISABLE\_ALL,
    };

    let fontCollection = text.FontCollection.getGlobalInstance();
    let paragraphBuilder = new text.ParagraphBuilder(myParagraphStyle, fontCollection);

    // 设置待排版文本要应用的样式
    paragraphBuilder.pushStyle(myTextStyle);
    // 添加文本
    paragraphBuilder.addText('Hello World!');

    // 生成段落
    let paragraph = paragraphBuilder.build();
    // 布局
    paragraph.layoutSync(200);
    // 绘制文本
    paragraph.paint(canvas, 0, 0);
  }
}

// 创建一个MyRenderNode对象
const textNode = new MyRenderNode();
// 定义newNode的像素格式
textNode.frame = {
  x: 0,
  y: 0,
  width: 400,
  height: 600
}
textNode.pivot = { x: 0.2, y: 0.8 };
textNode.scale = { x: 1, y: 1 };

class MyNodeController extends NodeController {
  private rootNode: FrameNode | null = null;

  makeNode(uiContext: UIContext): FrameNode {
    this.rootNode = new FrameNode(uiContext);
    if (this.rootNode == null) {
      return this.rootNode
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.frame = {
        x: 0,
        y: 0,
        width: 10,
        height: 500
      }
      renderNode.pivot = { x: 50, y: 50 };
    }
    return this.rootNode;
  }

  addNode(node: RenderNode): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.appendChild(node);
    }
  }

  clearNodes(): void {
    if (this.rootNode == null) {
      return;
    }
    const renderNode = this.rootNode.getRenderNode();
    if (renderNode != null) {
      renderNode.clearChildren();
    }
  }
}

let myNodeController: MyNodeController = new MyNodeController();

async function performTask() {
  myNodeController.clearNodes();
  myNodeController.addNode(textNode);
}

@Entry
@Component
struct Font08 {
  @State src: Resource = $r('app.media.startIcon')
  build() {
    Column() {
      Row() {
        NodeContainer(myNodeController)
          .height('100%')
          .width('100%')
        Text('Test for lineSpacing and height behavior')
          .onAppear(() => {
            performTask();
          })
      }
    }
    .width('100%')
  }
}

具体效果如下所示：

| 上升部下降部开关 | 示意效果（黑框仅为展示文本绘制区域，实际不绘制） |
| :-- | :-- |
| DISABLE\_ALL | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/50/v3/VwMQMI4cRSeSI6ihlUV38w/zh-cn_image_0000002634009416.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=F0608EA55EEA80934673C337E43CD1299A869548C44F76EFABCF2591C4A4E64F) |
| ALL | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/28/v3/6iSTGPf_SMuVb4oiCqP1uQ/zh-cn_image_0000002664208565.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=DAA145AB984CAB057E51A021451B3E30BBFC5DD5D2DD05CD7FEF7C1BC015FBE8) |

#### \[h2\]示例九（省略号样式）

以下示例展示了开启尾部省略号模式的文本截断效果。

// 设置文本样式，包含省略号字符串和省略号模式
let myTextStyle: text.TextStyle = {
  color: {
    alpha: 255,
    red: 0,
    green: 0,
    blue: 0
  },
  fontSize: 40,
  // 设置省略号字符串
  ellipsis: '...',
  // 设置省略号模式为尾部省略
  ellipsisMode: text.EllipsisMode.END
};
// 设置段落样式，包含最大行数
let myParagraphStyle: text.ParagraphStyle = {
  textStyle: myTextStyle,
  // 设置最大显示行数为2
  maxLines: 2
};

具体效果如下所示：

| 省略号模式 | 示意效果 |
| :-- | :-- |
| 不开启省略号 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3/v3/mSeGWlo9RcOOfFXctUe85A/zh-cn_image_0000002664328625.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=D58E001D0FABED986874BEDB4BD71ACBB4D7E0EB855F384D10A3D571AA10688C) |
| 开启头部省略号 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/bb/v3/ReMJ0jFJT_CygQ5gz4UbhQ/zh-cn_image_0000002633849514.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=BB017D3B6101957B96221BA377C564A4076A74FAD677221D650AD8485B3FC999) |
| 开启中部省略号 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/eb/v3/CwhiMwn9Sf6P1LY8RDEcMw/zh-cn_image_0000002634009418.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=CA920AFD0E634F274F1DAB29B3C316BC9F86EE6DD537C4648FDFF44353AB163C) |
| 开启尾部省略号 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e5/v3/s4YHZ5v_Rr6oNI23uM_6zg/zh-cn_image_0000002664208567.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=30B9CC2ABE52CAF0F3236112FC53A1931BA1516531B50BE65C70D68433E1628D) |
| 开启多行头部省略号 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b3/v3/UbU0C4qDQA6papENoJejLQ/zh-cn_image_0000002664328627.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=47A8B5612C858C712D2ECBB90A157F0C454A2BDE5925C6268C8649F66C911EF1) |
| 开启多行中部省略号 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/db/v3/mTVW4rPuTQqqQkxaducs8g/zh-cn_image_0000002633849516.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=26C247CF8B4EBD37FED8BBF7C67A1ED33108A814DAFE67277E2B25E3C6CC8DCF) |

#### \[h2\]示例十（文字换行方式）

以下示例展示了BALANCED断行策略对文本排版的影响。

// 设置断行策略为均衡策略（BALANCED）
let myParagraphStyle: text.ParagraphStyle = {
  textStyle: myTextStyle,
  // 设置断行策略为均衡策略，各行宽度尽量均衡
  breakStrategy: text.BreakStrategy.BALANCED
};

具体效果如下所示：

| 断行策略 | 示意效果 |
| :-- | :-- |
| GREEDY | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7c/v3/-y47vX8US4qmP53sVETY_w/zh-cn_image_0000002634009420.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=5CBD4FD6DC17ED309E1E79CA6541BCFA4B5E678C59AD41D4E1C15FC31A65B0B9) |
| BALANCED | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3e/v3/WBy291E7SLy-HpzddWvWtQ/zh-cn_image_0000002664208569.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=1F24B47F86BDDB6087CCF3D4AB10949D8515EBD438AB9FFD8797C57BDF8D95C6) |
| HIGH\_QUALITY | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/88/v3/OJZjHszqSbqWvhCfsRGpxA/zh-cn_image_0000002664328629.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=F99DCF82AF2EB16F2EAE334AE3C1ED5D45E38C122F7228F6E9DCADC402B1EE47) |

#### \[h2\]示例十一（行首标点压缩）

以下示例展示了开启行首标点压缩的排版对比效果。

// 开启行首标点压缩
let myParagraphStyle: text.ParagraphStyle = {
  textStyle: myTextStyle,
  compressHeadPunctuation: true
};

具体效果如下所示：

| 标点压缩设置 | 示意效果 |
| :-- | :-- |
| 未开启标点压缩 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/72/v3/H_iLFkrnRF6SNnOSKxjA3Q/zh-cn_image_0000002633849518.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=525D97907FEE0CD822A8C7DA4CD09F03AAB7566A8247A7442AA393313F3B727B) |
| 开启标点压缩 | ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e7/v3/pr1QKXVjS6K3bhQVibz5WQ/zh-cn_image_0000002634009422.png?HW-CC-KV=V1&HW-CC-Date=20260709T132547Z&HW-CC-Expire=86400&HW-CC-Sign=E99F4A459506C4203130F778902F9382D0502A0984D46625A73805305BD6D335) |