From 12aad46526fa85450d72a102ab22677dd650b1ca Mon Sep 17 00:00:00 2001 From: chenjiafeng10 Date: Fri, 20 Jun 2025 19:44:07 +0800 Subject: [PATCH] =?UTF-8?q?Description:=20[API=2020][Text]=E6=9B=B4?= =?UTF-8?q?=E6=96=B0editMenu=E3=80=81=E8=BF=9E=E5=AD=97=E7=AC=A6=E3=80=81?= =?UTF-8?q?=E6=96=AD=E8=A1=8C=E8=AF=B4=E6=98=8E=20IssueNo:=20https://gitee?= =?UTF-8?q?.com/openharmony/docs/issues/ICGOQ1=20Feature=20or=20Bugfix:=20?= =?UTF-8?q?Bugfix=20Binary=20Source:No=20Signed-off-by:=20chenjiafeng=20?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../apis-arkui/arkui-ts/ts-appendix-enums.md | 5 ++-- .../arkui-ts/ts-basic-components-search.md | 14 ++++++++++ .../arkui-ts/ts-basic-components-span.md | 6 ++++- .../arkui-ts/ts-basic-components-text.md | 26 ++++++++++++++++++- .../arkui-ts/ts-basic-components-textarea.md | 16 +++++++++++- .../arkui-ts/ts-basic-components-textinput.md | 17 +++++++++++- .../ts-universal-attributes-text-style.md | 2 +- .../arkui-ts/ts-universal-styled-string.md | 2 +- 8 files changed, 80 insertions(+), 8 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-appendix-enums.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-appendix-enums.md index 7e567cea814..570445d3d62 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-appendix-enums.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-appendix-enums.md @@ -619,7 +619,7 @@ | ------- | ----- | ----------- | | Lighter | 100 | 字体较细。 | | Normal | 400 | 字体粗细正常。 | -| Regular | 400 | 字体粗细正常。 | +| Regular | 400 | 字体粗细正常。与Normal效果相同。 | | Medium | 500 | 字体粗细适中。 | | Bold | 700 | 字体较粗。 | | Bolder | 900 | 字体非常粗。 | @@ -881,7 +881,8 @@ type Nullable\ = T | undefined | NORMAL | 0 | CJK(中文、日文、韩文)文本可以在任意2个字符间断行，而Non-CJK文本（如英文等）只能在空白符处断行。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | BREAK_ALL | 1 | 对于Non-CJK的文本，可在任意2个字符间断行。对于CJK与NORMAL效果一致。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | | BREAK_WORD | 2 | 与BREAK_ALL相同，对于Non-CJK的文本可在任意2个字符间断行，一行文本中有断行破发点（如空白符）时，优先按破发点换行，保障单词优先完整显示。若整一行文本均无断行破发点时，则在任意2个字符间断行。对于CJK与NORMAL效果一致。
**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | -| HYPHENATION18+ | 3 | 对于Non-CJK的文本，可以按照音节断行。对于CJK的文本，换行效果与NORMAL效果保持一致。
**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 | +| HYPHENATION18+ | 3 | 每行末尾单词尝试通过连字符“-”进行断行，若无法添加连字符“-”，则跟BREAK_WORD保持一致。
**原子化服务API：** 从API version 18开始，该接口支持在原子化服务中使用。 | + ## LineBreakStrategy12+ diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-search.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-search.md index 822948980f4..636874e0d4e 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-search.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-search.md @@ -352,6 +352,10 @@ lineHeight(value: number | string | Resource) | ------ | ------------------------------------------------------------ | ---- | ---------------- | | value | number \| string \| [Resource](ts-types.md#resource) | 是 | 文本的文本行高。 | +> **说明：** +> +> 特殊字符字体高度远超出同行的其他字符高度时，文本框出现截断、遮挡、内容相对位置发生变化等不符合预期的显示异常，需要开发者调整组件高度、行高等属性，修改对应的页面布局。 + ### decoration12+ decoration(value: TextDecorationOptions) @@ -376,6 +380,8 @@ letterSpacing(value: number | string | Resource) 当取值为负值时，文字会发生压缩，负值过小时会将组件内容区大小压缩为0，导致无内容显示。 +对每个字符生效，包括行尾字符。 + **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full @@ -587,6 +593,10 @@ enablePreviewText(enable: boolean) | ------ | ------- | ---- | ---------------------------------- | | enable | boolean | 是 | 是否开启输入预上屏。
true表示开启输入预上屏，false表示不开启输入预上屏。
默认值：true | +> **说明：** +> +> “预上屏”描述的是一种文字暂存状态。需要在输入法中开启预上屏功能，在输入文本过程中，未确认输入候选词时，文本框中显示标记文本。例如，通过拼音输入中文时，未确定候选词之前，在输入框中显示拼音字母，该状态称为文字预上屏。 + ### enableHapticFeedback13+ enableHapticFeedback(isEnabled: boolean) @@ -977,6 +987,10 @@ onDidDelete(callback: Callback\) | ------ | ------------------------------------------------------------ | ---- | ------------------ | | callback | Callback\<[DeleteValue](ts-text-common.md#deletevalue12对象说明)> | 是 | 在删除完成时调用的回调。
仅支持系统输入法输入的场景。 | +> **说明：** +> +> 点击清除按钮不触发onDidDelete回调。 + ### onWillChange15+ onWillChange(callback: Callback\) diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-span.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-span.md index 833ff0c097f..6642ea199c2 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-span.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-span.md @@ -7,6 +7,10 @@ > 该组件从API version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 > > 该组件从API version 10开始支持继承父组件Text的属性，即如果子组件未设置属性且父组件设置属性，则继承父组件设置的属性。支持继承的属性仅包括：fontColor、fontSize、fontStyle、fontWeight、decoration、letterSpacing、textCase、fontFamily、textShadow。 +> +> 不支持[通用属性](ts-component-general-attributes.md)。若需设置通用属性，应使用[Text](ts-basic-components-text.md)进行设置，或改用[属性字符串](ts-universal-styled-string.md)中的[CustomSpan](ts-universal-styled-string.md#customspan)自行绘制。 +> +> [通用事件](ts-component-general-events.md)只支持点击事件[onClick](ts-universal-events-click.md#onclick)和悬浮事件[onHover](ts-universal-events-hover.md#onhover)。 ## 子组件 @@ -177,7 +181,7 @@ fontFamily(value: string | Resource) | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------------------------------------------------- | ---- | ------------------------------------------------------------ | -| value | string \| [Resource](ts-types.md#resource) | 是 | 字体列表。默认字体'HarmonyOS Sans'。
应用当前支持'HarmonyOS Sans'字体和[注册自定义字体](../js-apis-font.md)。
卡片当前仅支持'HarmonyOS Sans'字体。 | +| value | string \| [Resource](ts-types.md#resource) | 是 | 字体列表。
默认字体'HarmonyOS Sans'。
使用多个字体时，请用逗号','分隔，字体的优先级按顺序生效。例如：'Arial, HarmonyOS Sans'。
应用当前支持'HarmonyOS Sans'字体和[注册自定义字体](../js-apis-font.md)。
卡片当前仅支持'HarmonyOS Sans'字体。 | ### lineHeight10+ diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-text.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-text.md index cebd8c8a6e0..af3ec3ace03 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-text.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-text.md @@ -152,6 +152,10 @@ lineHeight(value: number | string | Resource) | ------ | ------------------------------------------------------------ | ---- | ---------------- | | value | number \| string \| [Resource](ts-types.md#resource) | 是 | 文本的文本行高。 | +> **说明：** +> +> 特殊字符字体高度远超出同行的其他字符高度时，文本框出现截断、遮挡、内容相对位置发生变化等不符合预期的显示异常，需要开发者调整组件高度、行高等属性，修改对应的页面布局。 + ### decoration decoration(value: DecorationStyleInterface) @@ -170,6 +174,10 @@ decoration(value: DecorationStyleInterface) | ------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | | value | [DecorationStyleInterface12+](ts-universal-styled-string.md#decorationstyleinterface) | 是 | 文本装饰线样式对象。
默认值：
{
 type: TextDecorationType.None,
 color: Color.Black,
 style: TextDecorationStyle.SOLID 
}
**说明：**
style参数不支持卡片能力。 | +> **说明：** +> +> 当文字的下边缘轮廓与装饰线位置相交时，会触发下划线避让规则，下划线将在这些字符处避让文字。常见“gjyqp”等英文字符。 + ### baselineOffset baselineOffset(value: number | ResourceStr) @@ -202,6 +210,8 @@ letterSpacing(value: number | ResourceStr) 当取值为负值时，文字会被压缩。负值过小时会将组件内容区大小压缩为0，导致内容无法显示。 +对每个字符生效，包括行尾字符。 + **卡片能力：** 从API version 9开始，该接口支持在ArkTS卡片中使用。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 @@ -376,7 +386,7 @@ fontFamily(value: string | Resource) | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------------------------------------------------- | ---- | ------------------------------------------------------------ | -| value | string \| [Resource](ts-types.md#resource) | 是 | 字体列表。默认字体'HarmonyOS Sans'。
应用当前支持'HarmonyOS Sans'字体和[注册自定义字体](../js-apis-font.md)。
卡片当前仅支持'HarmonyOS Sans'字体。 | +| value | string \| [Resource](ts-types.md#resource) | 是 | 字体列表。默认字体'HarmonyOS Sans'。
使用多个字体时，请用逗号','分隔，字体的优先级按顺序生效。例如：'Arial, HarmonyOS Sans'。
应用当前支持'HarmonyOS Sans'字体和[注册自定义字体](../js-apis-font.md)。
卡片当前仅支持'HarmonyOS Sans'字体。 | ### copyOption9+ @@ -654,6 +664,12 @@ bindSelectionMenu的长按响应时长为600ms，bindContextMenu的长按响应 | responseType | [TextResponseType](#textresponsetype11枚举说明) | 是 | 选择菜单的响应类型。
默认值：TextResponseType.LONG_PRESS | | options | [SelectionMenuOptions](ts-basic-components-richeditor.md#selectionmenuoptions10) | 否 | 选择菜单的选项。 | +> **说明：** +> +> 通过[editMenuOptions](#editmenuoptions12)设置文本选择菜单时，保留系统默认的风格，触发菜单弹出的条件不变。 +> +> 通过[bindSelectionMenu](#bindselectionmenu11)设置文本选择菜单时，风格由开发者定义，触发菜单弹出的条件由开发者定义。 + ### fontFeature12+ fontFeature(value: string) @@ -693,6 +709,8 @@ fontFeature属性列表： > 字体排版引擎会对开发者传入的宽度[width](ts-universal-attributes-size.md#width)进行向下取整，保证是整型像素后进行排版。如果向上取整，可能会出现文字右侧被截断。 > > 当多个Text组件在[Row](ts-container-row.md)容器内布局且没有设置具体的布局分配信息时，Text会以Row的最大尺寸进行布局。如果需要子组件主轴累加的尺寸不超过Row容器主轴的尺寸，可以设置[layoutWeight](ts-universal-attributes-size.md#layoutweight)或者是以[Flex](ts-universal-attributes-flex-layout.md)布局来约束子组件的主轴尺寸。 +> +> 系统默认字体支持的liga连字：Th fb ff fb ffb ffh ffi ffk ffl fh fi fk。常导致Span、属性字符串的效果不符合预期，关闭liga连字特性可以规避。 ### lineSpacing12+ @@ -793,6 +811,12 @@ editMenuOptions(editMenu: EditMenuOptions) | ------ | --------------------------------------------- | ---- | --------------------------------------------- | | editMenu | [EditMenuOptions](ts-text-common.md#editmenuoptions) | 是 | 扩展菜单选项。 | +> **说明：** +> +> 通过[editMenuOptions](#editmenuoptions12)设置文本选择菜单时，保留系统默认的风格，触发菜单弹出的条件不变。 +> +> 通过[bindSelectionMenu](#bindselectionmenu11)设置文本选择菜单时，风格由开发者定义，触发菜单弹出的条件由开发者定义。 + ### minFontScale12+ minFontScale(scale: number | Resource) diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-textarea.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-textarea.md index cf5d518c979..ae142156e5c 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-textarea.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-textarea.md @@ -204,7 +204,7 @@ fontFamily(value: ResourceStr) | 参数名 | 类型 | 必填 | 说明 | | ------ | -------------------------------------- | ---- | ------------------------------------------------------------ | -| value | [ResourceStr](ts-types.md#resourcestr) | 是 | 字体列表。默认字体'HarmonyOS Sans'。
应用当前支持'HarmonyOS Sans'字体和[注册自定义字体](../js-apis-font.md)。
卡片当前仅支持'HarmonyOS Sans'字体。 | +| value | [ResourceStr](ts-types.md#resourcestr) | 是 | 字体列表。默认字体'HarmonyOS Sans'。
使用多个字体时，请用逗号','分隔，字体的优先级按顺序生效。例如：'Arial, HarmonyOS Sans'。
应用当前支持'HarmonyOS Sans'字体和[注册自定义字体](../js-apis-font.md)。
卡片当前仅支持'HarmonyOS Sans'字体。 | ### inputFilter8+ @@ -504,6 +504,10 @@ lineHeight(value: number | string | Resource) | ------ | ------------------------------------------------------------ | ---- | ---------------- | | value | number \| string \| [Resource](ts-types.md#resource) | 是 | 文本的文本行高。 | +> **说明：** +> +> 特殊字符字体高度远超出同行的其他字符高度时，文本框出现截断、遮挡、内容相对位置发生变化等不符合预期的显示异常，需要开发者调整组件高度、行高等属性，修改对应的页面布局。 + ### decoration12+ decoration(value: TextDecorationOptions) @@ -528,6 +532,8 @@ letterSpacing(value: number | string | Resource) 当取值为负值时，文字会发生压缩，负值过小时会将组件内容区大小压缩为0，导致无内容显示。 +对每个字符生效，包括行尾字符。 + **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full @@ -806,6 +812,10 @@ enablePreviewText(enable: boolean) | ------ | ------- | ---- | ---------------------------------- | | enable | boolean | 是 | 是否开启输入预上屏。
true表示开启，false表示不开启。
默认值：true | +> **说明：** +> +> “预上屏”描述的是一种文字暂存状态。需要在输入法中开启预上屏功能，在输入文本过程中，未确认输入候选词时，文本框中显示标记文本。例如，通过拼音输入中文时，未确定候选词之前，在输入框中显示拼音字母，该状态称为文字预上屏。 + ### enableHapticFeedback13+ enableHapticFeedback(isEnabled: boolean) @@ -1196,6 +1206,10 @@ onDidDelete(callback: Callback\) | ------ | ------------------------------------------------------------ | ---- | ------------------ | | callback | Callback\<[DeleteValue](ts-text-common.md#deletevalue12对象说明)> | 是 | 在删除完成时调用的回调。
仅支持系统输入法输入的场景。 | +> **说明：** +> +> 点击清除按钮不触发onDidDelete回调。 + ### onWillChange15+ onWillChange(callback: Callback\) diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-textinput.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-textinput.md index 5a25bd6f392..47698fef7cd 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-textinput.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-basic-components-textinput.md @@ -237,7 +237,7 @@ fontFamily(value: ResourceStr) | 参数名 | 类型 | 必填 | 说明 | | ------ | -------------------------------------- | ---- | ------------------------------------------------------------ | -| value | [ResourceStr](ts-types.md#resourcestr) | 是 | 字体列表。默认字体'HarmonyOS Sans'。
应用当前支持'HarmonyOS Sans'字体和[注册自定义字体](../js-apis-font.md)。
卡片当前仅支持'HarmonyOS Sans'字体。 | +| value | [ResourceStr](ts-types.md#resourcestr) | 是 | 字体列表。默认字体'HarmonyOS Sans'。
使用多个字体时，请用逗号','分隔，字体的优先级按顺序生效。例如：'Arial, HarmonyOS Sans'。
应用当前支持'HarmonyOS Sans'字体和[注册自定义字体](../js-apis-font.md)。
卡片当前仅支持'HarmonyOS Sans'字体。 | ### inputFilter8+ @@ -678,6 +678,9 @@ lineHeight(value: number | string | Resource) | ------ | ------------------------------------------------------------ | ---- | ---------------- | | value | number \| string \| [Resource](ts-types.md#resource) | 是 | 文本的文本行高。 | +> **说明：** +> +> 特殊字符字体高度远超出同行的其他字符高度时，文本框出现截断、遮挡、内容相对位置发生变化等不符合预期的显示异常，需要开发者调整组件高度、行高等属性，修改对应的页面布局。 ### decoration12+ decoration(value: TextDecorationOptions) @@ -702,6 +705,8 @@ letterSpacing(value: number | string | Resource) 当取值为负值时，文字会发生压缩，负值过小时会将组件内容区大小压缩为0，导致无内容显示。 +对每个字符生效，包括行尾字符。 + **原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 **系统能力：** SystemCapability.ArkUI.ArkUI.Full @@ -785,6 +790,8 @@ textOverflow(value: TextOverflow) > **说明：** > TextInput组件不支持设置TextOverflow.MARQUEE模式，当设置为TextOverflow.MARQUEE模式时，内联模式非编辑态下显示为TextOverflow.Ellipsis，内联模式编辑态下以及非内联模式下显示为TextOverflow.Clip。 +> +> 未设置内联模式时，按照默认风格显示。若此时设置textOverflow，则不生效。 ### textIndent12+ @@ -940,6 +947,10 @@ enablePreviewText(enable: boolean) | ------ | ------- | ---- | ---------------------------------- | | enable | boolean | 是 | 是否开启输入预上屏。
true表示开启输入预上屏，false表示不开启输入预上屏。
默认值：true | +> **说明：** +> +> “预上屏”描述的是一种文字暂存状态。需要在输入法中开启预上屏功能，在输入文本过程中，未确认输入候选词时，文本框中显示标记文本。例如，通过拼音输入中文时，未确定候选词之前，在输入框中显示拼音字母，该状态称为文字预上屏。 + ### enableHapticFeedback13+ enableHapticFeedback(isEnabled: boolean) @@ -1472,6 +1483,10 @@ onDidDelete(callback: Callback\) | ------ | ------------------------------------------------------------ | ---- | ------------------ | | callback | Callback\<[DeleteValue](ts-text-common.md#deletevalue12对象说明)> | 是 | 在删除完成时调用的回调。
仅支持系统输入法输入的场景。 | +> **说明：** +> +> 点击清除按钮不触发onDidDelete回调。 + ### onWillChange15+ onWillChange(callback: Callback\) diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-text-style.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-text-style.md index b418ee939ac..f9b242b2281 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-text-style.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-attributes-text-style.md @@ -94,7 +94,7 @@ fontFamily(value: string | Resource) | 参数名 | 类型 | 必填 | 说明 | | ------ | ---------------------------------------------------- | ---- | ------------------------------------------------------------ | -| value | [Resource](ts-types.md#resource) \| string | 是 | 字体列表。默认字体'HarmonyOS Sans'。
应用当前支持'HarmonyOS Sans'字体和[注册自定义字体](../js-apis-font.md)。
卡片当前仅支持'HarmonyOS Sans'字体。 | +| value | [Resource](ts-types.md#resource) \| string | 是 | 字体列表。
默认字体'HarmonyOS Sans'。
使用多个字体时，请用逗号','分隔，字体的优先级按顺序生效。例如：'Arial, HarmonyOS Sans'。
应用当前支持'HarmonyOS Sans'字体和[注册自定义字体](../js-apis-font.md)。
卡片当前仅支持'HarmonyOS Sans'字体。 | ## lineHeight diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-styled-string.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-styled-string.md index 484adc74e8f..cfcc58a488d 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-styled-string.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ts-universal-styled-string.md @@ -33,7 +33,7 @@ constructor(value: string | ImageAttachment | CustomSpan , styles?: Array\