文本計(jì)算

2024-01-23 13:12 更新

本模塊提供文本寬度、高度等相關(guān)計(jì)算。

說明

本模塊首批接口從API version 9開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

導(dǎo)入模塊

  1. import measure from '@ohos.measure'

measure.measureText

measureText(options: MeasureOptions): number

計(jì)算指定文本單行布局下的寬度。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

參數(shù)：

參數(shù)名

類型

必填

說明

options

MeasureOptions

是

被計(jì)算文本描述信息。

返回值：

類型

說明

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

被計(jì)算文本屬性。

系統(tǒng)能力： SystemCapability.ArkUI.ArkUI.Full

名稱

類型

必填

說明

textContent

string

是

設(shè)置被計(jì)算文本內(nèi)容。

fontSize

number | string | Resource

否

設(shè)置被計(jì)算文本字體大小，fontSize為number類型時(shí)，使用fp單位。

默認(rèn)值：16fp。

**說明:**不支持設(shè)置百分比字符串。

fontStyle

number | FontStyle

否

設(shè)置被計(jì)算文本字體樣式。

默認(rèn)值：FontStyle.Normal

fontWeight

number | string | FontWeight

否

設(shè)置被計(jì)算文本的字體粗細(xì)，number類型取值[100, 900]，取值間隔為100，默認(rèn)為400，取值越大，字體越粗。string類型僅支持number類型取值的字符串形式，例如"400"，以及"bold"、"bolder"、"lighter"、"regular"、"medium"，分別對應(yīng)FontWeight中相應(yīng)的枚舉值。

默認(rèn)值：FontWeight.Normal

fontFamily

string | Resource

否

設(shè)置被計(jì)算文本字體列表。默認(rèn)字體'HarmonyOS Sans'，且當(dāng)前只支持這種字體。

letterSpacing

number | string

否

設(shè)置被計(jì)算文本字符間距。

以上內(nèi)容是否對您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號