!15530 Menu组件UX规格与特征动效整改-Reference文档

Merge pull request !15530 from chensi10/menuts

!15530 Menu组件UX规格与特征动效整改-Reference文档
Merge pull request !15530 from chensi10/menuts
7ccfae69 · openharmony_ci · Gitee · e586543a · 084cb6e6 · 7ccfae69
3 changed file
--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-menu.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-menu.md
@@ -22,7 +22,9 @@ Menu()

 | 名称     | 参数类型                  | 描述                                                             |
 | -------- | ------------------------- | ---------------------------------------------------------------- |
-| fontSize | [Length](ts-types.md#length) | 统一设置Menu中所有文本的尺寸，Length为number类型时，使用fp单位。 |
+| fontSize<sup>deprecated</sup> | [Length](ts-types.md#length) | 统一设置Menu中所有文本的尺寸，Length为number类型时，使用fp单位。<br/>从API Version 10开始废弃，建议使用font代替。 |
+| font<sup>10+</sup> | [Font](ts-types.md#font) | 统一设置Menu中所有文本的字体样式。 |
+| fontColor<sup>10+</sup> | [ResourceColor](ts-types.md#resourcecolor) | 统一设置Menu中所有文本的颜色。 |

 ## 示例


--- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-menuitem.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-menuitem.md
@@ -23,9 +23,9 @@ MenuItem(value?: MenuItemOptions| CustomBuilder)
 ## MenuItemOptions类型说明

 | 名称      | 类型                                        | 必填 | 描述                                   |
-| --------- | ---------------------------------------- | ---- | -------------------------------------- |
+| --------- | ------------------------------------------- | ---- | -------------------------------------- |
 | startIcon | [ResourceStr](ts-types.md#resourcestr)      | 否   | item中显示在左侧的图标信息路径。       |
-| content   | [ResourceStr](ts-types.md#resourcestr)      | 是   | item的内容信息。                       |
+| content   | [ResourceStr](ts-types.md#resourcestr)      | 否   | item的内容信息。                       |
 | endIcon   | [ResourceStr](ts-types.md#resourcestr)      | 否   | item中显示在右侧的图标信息路径。       |
 | labelInfo | [ResourceStr](ts-types.md#resourcestr)      | 否   | 定义结束标签信息，如快捷方式Ctrl+C等。 |
 | builder   | [CustomBuilder](ts-types.md#custombuilder8) | 否   | 用于构建二级菜单。                     |
@@ -35,9 +35,13 @@ MenuItem(value?: MenuItemOptions| CustomBuilder)
 除支持[通用属性](ts-universal-attributes-size.md)外，还支持以下属性:

 | 名称                           | 参数类型                                                     | 描述                                                         |
-| ---------- | -------- | ---------------------------------------- |
+| ------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
 | selected                       | boolean                                                      | 设置菜单项是否选中。<br />默认值：false                      |
-| selectIcon | boolean  | 当菜单项被选中时，是否显示被选中的图标。 |
+| selectIcon                     | boolean \| [ResourceStr](ts-types.md#resourcestr)<sup>10+</sup> | 当菜单项被选中时，是否显示被选中的图标。<br/>默认值：false<br/>true: 菜单项被选中时，显示默认的对勾图标<br/>false: 即使菜单项被选中也不显示图标<br/>ResourceStr: 菜单项被选中时，显示指定的图标 |
+| contentFont<sup>10+</sup>      | [Font](ts-types.md#font)                                     | 设置菜单项中内容信息的字体样式。                             |
+| contentFontColor<sup>10+</sup> | [ResourceColor](ts-types.md#resourcecolor)                   | 设置菜单项中内容信息的字体颜色。                             |
+| labelFont<sup>10+</sup>        | [Font](ts-types.md#font)                                     | 设置菜单项中标签信息的字体样式。                             |
+| labelFontColor<sup>10+</sup>   | [ResourceColor](ts-types.md#resourcecolor)                   | 设置菜单项中标签信息的字体颜色。                             |

 ## 事件


--- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-menu.md
+++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-menu.md
@@ -12,16 +12,23 @@

 | 名称                         | 参数类型                                                     | 描述                                                         |
 | ---------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
-| bindMenu                     | Array<[MenuItem](#menuitem)&gt;&nbsp;\|&nbsp;[CustomBuilder](ts-types.md#custombuilder8) | 给组件绑定菜单，点击后弹出菜单。弹出菜单项支持文本和自定义两种功能。 |
+| bindMenu                     | content: Array<[MenuItem](#menuitem)&gt;&nbsp;\|&nbsp;[CustomBuilder](ts-types.md#custombuilder8),<br>options<sup>10+</sup>: [MenuOptions](#menuoptions10)<sup>10+</sup> | 给组件绑定菜单，点击后弹出菜单。弹出菜单项支持图标+文本排列和自定义两种功能。<br/>content: 必填，配置菜单项图标和文本的数组，或者自定义组件<br/>options: 非必填，配置弹出菜单的参数 |
 | bindContextMenu<sup>8+</sup> | content:&nbsp;[CustomBuilder](ts-types.md#custombuilder8),<br>responseType:&nbsp;[ResponseType](ts-appendix-enums.md#responsetype8) | 给组件绑定菜单，触发方式为长按或者右键点击，弹出菜单项需要自定义。 |

 ## MenuItem

-| 名称     | 类型                      | 描述          |
-| ------ | ----------------------- | ----------- |
-| value  | string                  | 菜单项文本。      |
-| action | ()&nbsp;=&gt;&nbsp;void | 点击菜单项的事件回调。 |
+| 名称               | 类型                                   | 必填 | 描述                   |
+| ------------------ | -------------------------------------- | ---- | ---------------------- |
+| value              | string                                 | 是   | 菜单项文本。           |
+| icon<sup>10+</sup> | [ResourceStr](ts-types.md#resourcestr) | 否   | 菜单项图标。           |
+| action             | ()&nbsp;=&gt;&nbsp;void                | 是   | 点击菜单项的事件回调。 |

+## MenuOptions<sup>10+</sup>
+
+| 名称   | 类型                             | 必填 | 描述                                                   |
+| ------ | -------------------------------- | ---- | ------------------------------------------------------ |
+| title  | string                           | 否   | 菜单标题。                                             |
+| offset | [Position](ts-types.md#position8) | 否   | 菜单弹出位置的偏移量，不会导致菜单显示超出屏幕范围。 |

 ## 示例