文本样式设置

2024-01-22 16:16 更新

针对包含文本元素的组件,设置文本样式。

说明

从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

属性

名称

参数类型

描述

fontColor

ResourceColor

设置字体颜色。

从API version 9开始,该接口支持在ArkTS卡片中使用。

fontSize

Length

设置字体大小,Length为number类型时,使用fp单位。字体默认大小16。不支持设置百分比字符串。

从API version 9开始,该接口支持在ArkTS卡片中使用。

fontStyle

FontStyle

设置字体样式。

默认值:FontStyle.Normal

从API version 9开始,该接口支持在ArkTS卡片中使用。

fontWeight

number | FontWeight | string

设置文本的字体粗细,number类型取值[100, 900],取值间隔为100,默认为400,取值越大,字体越粗。string类型仅支持number类型取值的字符串形式,例如"400",以及"bold"、"bolder"、"lighter"、"regular"、"medium",分别对应FontWeight中相应的枚举值。

默认值:FontWeight.Normal

从API version 9开始,该接口支持在ArkTS卡片中使用。

fontFamily

string | Resource

设置字体列表。默认字体'HarmonyOS Sans',当前支持'HarmonyOS Sans'字体和注册自定义字体

从API version 9开始,该接口支持在ArkTS卡片中使用。

lineHeight

string | number | Resource

设置文本的文本行高,设置值不大于0时,不限制文本行高,自适应字体大小,Length为number类型时单位为fp。

从API version 9开始,该接口支持在ArkTS卡片中使用。

decoration

{

type: TextDecorationType,

color?: ResourceColor

}

设置文本装饰线样式及其颜色。

默认值:{

type: TextDecorationType.None,

color:Color.Black

}

从API version 9开始,该接口支持在ArkTS卡片中使用。

示例

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct TextStyleExample {
  5. build() {
  6. Column({ space: 5 }) {
  7. Text('default text')
  8. Text('text font color red').fontColor(Color.Red)
  9. Text('text font default')
  10. Text('text font size 10').fontSize(10)
  11. Text('text font size 10fp').fontSize('10fp')
  12. Text('text font size 20').fontSize(20)
  13. Text('text font style Italic').fontStyle(FontStyle.Italic)
  14. Text('text fontWeight bold').fontWeight(700)
  15. Text('text fontWeight lighter').fontWeight(FontWeight.Lighter)
  16. Text('red 20 Italic bold text')
  17. .fontColor(Color.Red)
  18. .fontSize(20)
  19. .fontStyle(FontStyle.Italic)
  20. .fontWeight(FontWeight.Bold)
  21. Text('Orange 18 Normal text')
  22. .fontColor(Color.Orange)
  23. .fontSize(18)
  24. .fontStyle(FontStyle.Normal)
  25. }.width('100%')
  26. }
  27. }

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号