当前仓库属于关闭状态，部分功能使用受限，详情请查阅仓库状态说明

开源项目 > OpenHarmony > OpenHarmony 教程指南 &&

加入 Gitee

与超过 1200万开发者一起发现、参与优秀开源项目，私有仓库也完全免费：）

文件

克隆/下载

ts-basic-components-menuitem.md 4.16 KB

# MenuItem

用来展示菜单Menu中具体的item菜单项。

> **说明：**
>
> 该组件从API Version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

## 子组件

无

## 接口

MenuItem(value?: MenuItemOptions| CustomBuilder)

**参数：**

| 参数  | 类型                                                                                                                          | 必填 | 参数描述                     |
| ----- | ----------------------------------------------------------------------------------------------------------------------------- | ---- | ---------------------------- |
| value | [MenuItemOptions](ts-basic-components-menuitem.md#menuitemoptions类型说明)&nbsp;\|&nbsp;[CustomBuilder](ts-types.md#custombuilder8) | 否   | 包含设置MenuItem的各项信息。 |

## MenuItemOptions类型说明

| 名称      | 类型                                        | 必填 | 描述                                   |
| --------- | ------------------------------------------- | ---- | -------------------------------------- |
| startIcon | [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) | 否   | 用于构建二级菜单。                     |

## 属性

除支持[通用属性](ts-universal-attributes-size.md)外，还支持以下属性:

| 名称                           | 参数类型                                                     | 描述                                                         |
| ------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| selected                       | boolean                                                      | 设置菜单项是否选中。<br />默认值：false<br />从API version 10开始，该参数支持[$$](../../quick-start/arkts-two-way-sync.md)双向绑定变量。 |
| 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)                   | 设置菜单项中标签信息的字体颜色。                             |

## 事件

| 名称     | 参数类型                    | 描述                                                                                                                                                            |
| -------- | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| onChange | (selected: boolean) => void | 当选中状态发生变化时，触发该回调。只有手动触发且MenuItem状态改变时才会触发onChange回调。<br />- value为true时，表示已选中。<br />- value为false时，表示未选中。 |

## 示例

详见[Menu组件示例](ts-basic-components-menu.md#示例)。

一键复制原始数据按行查看历史

提交于 2年前 . 带状态组件支持45739能力 DOCS

MenuItem

MenuItem

用来展示菜单Menu中具体的item菜单项。

说明：

该组件从API Version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

子组件

无

接口

MenuItem(value?: MenuItemOptions| CustomBuilder)

参数：

参数	类型	必填	参数描述
value	MenuItemOptions \| CustomBuilder	否	包含设置MenuItem的各项信息。

MenuItemOptions类型说明

名称	类型	必填	描述
startIcon	ResourceStr	否	item中显示在左侧的图标信息路径。
content	ResourceStr	否	item的内容信息。
endIcon	ResourceStr	否	item中显示在右侧的图标信息路径。
labelInfo	ResourceStr	否	定义结束标签信息，如快捷方式Ctrl+C等。
builder	CustomBuilder	否	用于构建二级菜单。

属性

除支持通用属性外，还支持以下属性:

名称	参数类型	描述
selected	boolean	设置菜单项是否选中。默认值：false 从API version 10开始，该参数支持$$双向绑定变量。
selectIcon	boolean \| ResourceStr¹⁰⁺	当菜单项被选中时，是否显示被选中的图标。默认值：false true: 菜单项被选中时，显示默认的对勾图标 false: 即使菜单项被选中也不显示图标 ResourceStr: 菜单项被选中时，显示指定的图标
contentFont¹⁰⁺	Font	设置菜单项中内容信息的字体样式。
contentFontColor¹⁰⁺	ResourceColor	设置菜单项中内容信息的字体颜色。
labelFont¹⁰⁺	Font	设置菜单项中标签信息的字体样式。
labelFontColor¹⁰⁺	ResourceColor	设置菜单项中标签信息的字体颜色。

事件

名称	参数类型	描述
onChange	(selected: boolean) => void	当选中状态发生变化时，触发该回调。只有手动触发且MenuItem状态改变时才会触发onChange回调。 - value为true时，表示已选中。 - value为false时，表示未选中。

示例

详见Menu组件示例。

Loading...

马建仓 AI 助手

尝试更多

代码解读

代码找茬

代码优化

其他

1

https://gitee.com/openharmony/docs.git

git@gitee.com:openharmony/docs.git

openharmony

docs

docs

OpenHarmony-4.1-Beta1