• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# MenuItem
2
3用来展示菜单Menu中具体的item菜单项。
4
5> **说明:**
6>
7> 该组件从API Version 9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
8
9## 子组件
10
1112
13## 接口
14
15MenuItem(value?: MenuItemOptions| CustomBuilder)
16
17**参数:**
18
19| 参数  | 类型                                                                                                                          | 必填 | 参数描述                     |
20| ----- | ----------------------------------------------------------------------------------------------------------------------------- | ---- | ---------------------------- |
21| value | [MenuItemOptions](ts-basic-components-menuitem.md#menuitemoptions类型说明) \| [CustomBuilder](ts-types.md#custombuilder8) | 否   | 包含设置MenuItem的各项信息。 |
22
23## MenuItemOptions类型说明
24
25| 名称      | 类型                                        | 必填 | 描述                                   |
26| --------- | ------------------------------------------- | ---- | -------------------------------------- |
27| startIcon | [ResourceStr](ts-types.md#resourcestr)      | 否   | item中显示在左侧的图标信息路径。       |
28| content   | [ResourceStr](ts-types.md#resourcestr)      | 否   | item的内容信息。                       |
29| endIcon   | [ResourceStr](ts-types.md#resourcestr)      | 否   | item中显示在右侧的图标信息路径。       |
30| labelInfo | [ResourceStr](ts-types.md#resourcestr)      | 否   | 定义结束标签信息,如快捷方式Ctrl+C等。 |
31| builder   | [CustomBuilder](ts-types.md#custombuilder8) | 否   | 用于构建二级菜单。                     |
32
33## 属性
34
35除支持[通用属性](ts-universal-attributes-size.md)外,还支持以下属性:
36
37| 名称                           | 参数类型                                                     | 描述                                                         |
38| ------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
39| selected                       | boolean                                                      | 设置菜单项是否选中。<br />默认值:false<br />从API version 10开始,该参数支持[$$](../../quick-start/arkts-two-way-sync.md)双向绑定变量。 |
40| selectIcon                     | boolean \| [ResourceStr](ts-types.md#resourcestr)<sup>10+</sup> | 当菜单项被选中时,是否显示被选中的图标。<br/>默认值:false<br/>true: 菜单项被选中时,显示默认的对勾图标<br/>false: 即使菜单项被选中也不显示图标<br/>ResourceStr: 菜单项被选中时,显示指定的图标 |
41| contentFont<sup>10+</sup>      | [Font](ts-types.md#font)                                     | 设置菜单项中内容信息的字体样式。                             |
42| contentFontColor<sup>10+</sup> | [ResourceColor](ts-types.md#resourcecolor)                   | 设置菜单项中内容信息的字体颜色。                             |
43| labelFont<sup>10+</sup>        | [Font](ts-types.md#font)                                     | 设置菜单项中标签信息的字体样式。                             |
44| labelFontColor<sup>10+</sup>   | [ResourceColor](ts-types.md#resourcecolor)                   | 设置菜单项中标签信息的字体颜色。                             |
45
46## 事件
47
48| 名称     | 参数类型                    | 描述                                                                                                                                                            |
49| -------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
50| onChange | (selected: boolean) => void | 当选中状态发生变化时,触发该回调。只有手动触发且MenuItem状态改变时才会触发onChange回调。<br />- value为true时,表示已选中。<br />- value为false时,表示未选中。 |
51
52## 示例
53
54详见[Menu组件示例](ts-basic-components-menu.md#示例)。
55