《鸿蒙HarmonyOS 5.0开发教程》基础篇05:文本组件

222 阅读1分钟

ArkUI 中提供了 Text 和 Span 两种常用的文本组件。

一、基础语法

Text 和 Span 都可以用来设置页面中的文本内容,区别在于:

  • Text():普通文本组件;
  • Span():只能作为Text()的子组件使用,不能单独使用;

示例代码:

build() {
  Column() {
    Text("文本内容1")
    Text("文本内容2")
    Text("文本内容3") {
      Span("文本内容4")
      Span("文本内容5")
    }
  }
}

注意事项:

  • 如果 Text 中包含了 Span,那么 Span 的文本内容会将 Text 的文本内容覆盖掉,也就是说上面代码中的“文本内容3”无效;
  • Text 和 Span 的内容取值都只能是字符串类型;

代码预览效果如下:

image-20250115152911008

二、文本样式

文本组件的样式设置,除了组件通用样式width()height() 等以外,还有文本组件特有的样式。常用的文本样式如下:

  • fontColor():文本颜色
  • fontSize():字体大小
  • fontWeight():字体粗细
  • fontStyle():字体风格(是否倾斜)
  • font():字体大小、字体粗细、字体风格等
  • textAlign():文本左右对齐(需要Text组件宽度大于文本内容宽度时才有效)
  • ...

更多完整的文本组件样式,可以查阅官方文档文本显示 (Text/Span)Text 组件 APISpan 组件 API

示例代码:

build() {
  Column() {
    Text("文本内容1")
      .fontColor('red')
      .fontSize(20)
      .fontWeight(600)
      .fontStyle(FontStyle.Italic)
      .textAlign(TextAlign.Center)
      .width(200)
      .backgroundColor('#eee')
    Text("文本内容3") {
      Span("文本内容4")
        .fontColor("blue")
      Span("文本内容5")
        .fontColor('green')
    }
    .font({ size: 20, weight: FontWeight.Medium })
  }
}

代码预览效果如下:

image-20250115154540939