文本计算

2024-01-23 13:12 更新

本模块提供文本宽度、高度等相关计算。

说明

本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

  1. import measure from '@ohos.measure'

measure.measureText

measureText(options: MeasureOptions): number

计算指定文本单行布局下的宽度。

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

参数:

参数名

类型

必填

说明

options

MeasureOptions

被计算文本描述信息。

返回值:

类型

说明

number

文本宽度。

说明: 单位px。

示例:

  1. import measure from '@ohos.measure'
  2. @Entry
  3. @Component
  4. struct Index {
  5. @State message: string = 'Hello World'
  6. @State textWidth : number = measure.measureText({
  7. textContent: "Hello word",
  8. fontSize: '50px'
  9. })
  10. build() {
  11. Row() {
  12. Column() {
  13. Text("The width of 'Hello World': " + this.textWidth)
  14. }
  15. .width('100%')
  16. }
  17. .height('100%')
  18. }
  19. }

MeasureOptions

被计算文本属性。

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

名称

类型

必填

说明

textContent

string

设置被计算文本内容。

fontSize

number | string | Resource

设置被计算文本字体大小,fontSize为number类型时,使用fp单位。

默认值:16fp。

**说明:**不支持设置百分比字符串。

fontStyle

number | FontStyle

设置被计算文本字体样式。

默认值:FontStyle.Normal

fontWeight

number | string | FontWeight

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

默认值:FontWeight.Normal

fontFamily

string | Resource

设置被计算文本字体列表。默认字体'HarmonyOS Sans',且当前只支持这种字体。

letterSpacing

number | string

设置被计算文本字符间距。

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

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号