Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
dac2bff1
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
dac2bff1
编写于
3月 15, 2023
作者:
L
lijuan
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
增加measureTextSize文档
Signed-off-by:
N
lijuan
<
lijuan124@huawei.com
>
上级
8c9cc540
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
54 addition
and
1 deletion
+54
-1
zh-cn/application-dev/reference/apis/js-apis-measure.md
zh-cn/application-dev/reference/apis/js-apis-measure.md
+54
-1
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-measure.md
浏览文件 @
dac2bff1
...
...
@@ -58,6 +58,52 @@ struct Index {
}
```
## measure.measureTextSize<sup>10+</sup>
measureTextSize(options: MeasureOptions): SizeOptions
计算指定文本单行布局下的宽度。
**系统能力:**
SystemCapability.ArkUI.ArkUI.Full
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------------------------------- | ---- | --------- |
| options |
[
MeasureOptions
](
#measureoptions
)
| 是 | 被计算文本描述信息。 |
**返回值:**
| 类型 | 说明 |
| ------------ | --------- |
| SizeOptions | 返回文本所占布局宽度和高度。
<br/>
**说明:**
文本宽度以及高度返回值单位均为px。 |
**示例:**
```
ts
import
measure
from
'
@ohos.measure
'
@
Entry
@
Component
struct
Index
{
@
State
message
:
string
=
'
Hello World
'
textSize
:
SizeOptions
=
measure
.
measureTextSize
({
textContent
:
"
Hello word
"
,
fontSize
:
'
50px
'
})
build
()
{
Row
()
{
Column
()
{
Text
(
"
The width of 'Hello World':
"
+
this
.
textSize
.
width
)
Text
(
"
The height of 'Hello World':
"
+
this
.
textSize
.
height
)
}
.
width
(
'
100%
'
)
}
.
height
(
'
100%
'
)
}
}
```
## MeasureOptions
被计算文本属性。
...
...
@@ -67,9 +113,16 @@ struct Index {
| 名称 | 类型 | 必填 | 说明 |
| -------------- | -------------------------------------------------------------------------------------------------- | ---- | ----------------------------------------------- |
| textContent | string | 是 | 设置被计算文本内容。 |
| fontSize | number
\|
string
\|
[
Resource
](
../arkui-ts/ts-types.md#resource
)
| 否 | 设置被计算文本字体大小,fontSize为number类型时,使用fp单位。
<br/>
默认值:16fp。
<br/>
**说明:**
不支持设置百分比字符串。 |
| constraintWidth
<sup>
10+
</sup>
| number
\|
string
\|
[
Resource
](
../arkui-ts/ts-types.md#resource
)
| 否 | 设置被计算文本布局宽度。
<br/>
**说明:**
默认单位为vp |
| fontSize | number
\|
string
\|
[
Resource
](
../arkui-ts/ts-types.md#resource
)
| 否 | 设置被计算文本字体大小,fontSize为number类型时,使用fp单位。
<br/>
默认值:16fp。
<br/>
**说明:**
不支持设置百分比字符串。 |
| fontStyle | number
\|
[
FontStyle
](
../arkui-ts/ts-appendix-enums.md#fontstyle
)
| 否 | 设置被计算文本字体样式。
<br>
默认值:FontStyle.Normal |
| fontWeight | number
\|
string
\|
[
FontWeight
](
../arkui-ts/ts-appendix-enums.md#fontweight
)
| 否 | 设置被计算文本的字体粗细,number类型取值[100,
900],取值间隔为100,默认为400,取值越大,字体越粗。string类型仅支持number类型取值的字符串形式,例如"400",以及"bold"、"bolder"、"lighter"、"regular"、"medium",分别对应FontWeight中相应的枚举值。
<br/>
默认值:FontWeight.Normal|
| fontFamily | string
\|
[
Resource
](
../arkui-ts/ts-types.md#resource
)
| 否 | 设置被计算文本字体列表。默认字体'HarmonyOS Sans',且当前只支持这种字体。|
| letterSpacing | number
\|
string | 否 | 设置被计算文本字符间距。|
| textAlign
<sup>
10+
</sup>
| number
\|
[
TextAlign
](
../arkui-ts/ts-appendix-enums.md#textalign
)
| 否 | 设置被计算文本水平方向的对齐方式。
<br/>
默认值:TextAlign.Start|
| overflow
<sup>
10+
</sup>
| number
\|
[
TextOverflow
](
../arkui-ts/ts-appendix-enums.md#textoverflow
)
| 否 | 设置被计算文本超长时的截断方式。|
| maxLines
<sup>
10+
</sup>
| number | 否 | 设置被计算文本最大行数。|
| lineHeight
<sup>
10+
</sup>
| number
\|
string
\|
[
Resource
](
../arkui-ts/ts-types.md#resource
)
| 否 | 设置被计算文本行高。|
| baselineOffset
<sup>
10+
</sup>
| number
\|
string | 否 | 设置被计算文本基线的偏移量。
<br
/>
默认值:0 |
| textCase
<sup>
10+
</sup>
| number
\|
[
TextCase
](
../arkui-ts/ts-appendix-enums.md#textcase
)
| 否 | 设置被计算文本大小写。
<br
/>
默认值:TextCase.Normal |
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录