1# MenuItem 2 3用来展示菜单Menu中具体的item菜单项。 4 5> **说明：** 6> 7> 该组件从API Version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 8 9## 子组件 10 11无 12 13## 接口 14 15MenuItem(value?: MenuItemOptions| CustomBuilder) 16 17**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 18 19**系统能力：** SystemCapability.ArkUI.ArkUI.Full 20 21**参数：** 22 23| 参数名 | 类型 | 必填 | 说明 | 24| ------ | ------------------------------------------------------------ | ---- | ---------------------------- | 25| value | [MenuItemOptions](#menuitemoptions对象说明) \| [CustomBuilder](ts-types.md#custombuilder8) | 否 | 包含设置MenuItem的各项信息。 | 26 27## MenuItemOptions对象说明 28 29**系统能力：** SystemCapability.ArkUI.ArkUI.Full 30 31| 名称 | 类型 | 必填 | 说明 | 32| --------- | ------------------------------------------- | ---- | -------------------------------------- | 33| startIcon | [ResourceStr](ts-types.md#resourcestr) | 否 | item中显示在左侧的图标信息路径。 <br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 34| content | [ResourceStr](ts-types.md#resourcestr) | 否 | item的内容信息。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 35| endIcon | [ResourceStr](ts-types.md#resourcestr) | 否 | item中显示在右侧的图标信息路径。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 36| labelInfo | [ResourceStr](ts-types.md#resourcestr) | 否 | 定义结束标签信息，如快捷方式Ctrl+C等。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 37| builder | [CustomBuilder](ts-types.md#custombuilder8) | 否 | 用于构建二级菜单。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 38| symbolStartIcon<sup>12+</sup> | [SymbolGlyphModifier](ts-universal-attributes-attribute-modifier.md) | 否 | item中显示在左侧的HMSymbol图标信息路径。配置该项时，原先startIcon图标不显示。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。| 39| symbolEndIcon<sup>12+</sup> | [SymbolGlyphModifier](ts-universal-attributes-attribute-modifier.md) | 否 | item中显示在右侧的HMSymbol图标信息路径。配置该项时，原先endIcon图标不显示。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。| 40 41 42## 属性 43 44除支持[通用属性](ts-component-general-attributes.md)外，还支持以下属性： 45 46### selected 47 48selected(value: boolean) 49 50设置菜单项是否选中。 51 52从API version 10开始，该参数支持[$$](../../../quick-start/arkts-two-way-sync.md)双向绑定变量。 53 54**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 55 56**系统能力：** SystemCapability.ArkUI.ArkUI.Full 57 58**参数：** 59 60| 参数名 | 类型 | 必填 | 说明 | 61| ------ | ------- | ---- | ------------------------------------------------------------ | 62| value | boolean | 是 | 菜单项是否选中。<br />默认值：false<br/>值为true时，菜单项被选中。值为false时，菜单项不被选中。 | 63 64### selectIcon 65 66selectIcon(value: boolean | ResourceStr | SymbolGlyphModifier) 67 68设置当菜单项被选中时，是否显示被选中的图标。 69 70**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 71 72**系统能力：** SystemCapability.ArkUI.ArkUI.Full 73 74**参数：** 75 76| 参数名 | 类型 | 必填 | 说明 | 77| ------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 78| value | boolean \| [ResourceStr](ts-types.md#resourcestr)<sup>10+</sup>\| [SymbolGlyphModifier](ts-universal-attributes-attribute-modifier.md)<sup>12+</sup> | 是 | 菜单项被选中时，是否显示被选中的图标。<br/>默认值：false<br/>true: 菜单项被选中时，显示默认的对勾图标。<br/>false: 即使菜单项被选中也不显示图标。<br/>ResourceStr: 菜单项被选中时，显示指定的图标。<br/>SymbolGlyphModifier: 菜单项被选中时，显示指定的HMSymbol图标。 | 79### contentFont<sup>10+</sup> 80 81contentFont(value: Font) 82 83设置菜单项中内容信息的字体样式。 84 85**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 86 87**系统能力：** SystemCapability.ArkUI.ArkUI.Full 88 89**参数：** 90 91| 参数名 | 类型 | 必填 | 说明 | 92| ------ | ------------------------ | ---- | ---------------------------- | 93| value | [Font](ts-types.md#font) | 是 | 菜单项中内容信息的字体样式。 | 94 95### contentFontColor<sup>10+</sup> 96 97contentFontColor(value: ResourceColor) 98 99设置菜单项中内容信息的字体颜色。 100 101**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 102 103**系统能力：** SystemCapability.ArkUI.ArkUI.Full 104 105**参数：** 106 107| 参数名 | 类型 | 必填 | 说明 | 108| ------ | ------------------------------------------ | ---- | ---------------------------- | 109| value | [ResourceColor](ts-types.md#resourcecolor) | 是 | 菜单项中内容信息的字体颜色。<br />默认值：'#E5000000' | 110 111### labelFont<sup>10+</sup> 112 113labelFont(value: Font) 114 115设置菜单项中标签信息的字体样式。 116 117**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 118 119**系统能力：** SystemCapability.ArkUI.ArkUI.Full 120 121**参数：** 122 123| 参数名 | 类型 | 必填 | 说明 | 124| ------ | ------------------------ | ---- | ---------------------------- | 125| value | [Font](ts-types.md#font) | 是 | 菜单项中标签信息的字体样式。 | 126 127### labelFontColor<sup>10+</sup> 128 129labelFontColor(value: ResourceColor) 130 131设置菜单项中标签信息的字体颜色。 132 133**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 134 135**系统能力：** SystemCapability.ArkUI.ArkUI.Full 136 137**参数：** 138 139| 参数名 | 类型 | 必填 | 说明 | 140| ------ | ------------------------------------------ | ---- | ---------------------------- | 141| value | [ResourceColor](ts-types.md#resourcecolor) | 是 | 菜单项中标签信息的字体颜色。<br />默认值：'#99000000' | 142 143## 事件 144 145### onChange 146 147onChange(callback: (selected: boolean) => void) 148 149当选中状态发生变化时，触发该回调。只有手动触发且MenuItem状态改变时才会触发onChange回调。 150 151**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 152 153**系统能力：** SystemCapability.ArkUI.ArkUI.Full 154 155**参数：** 156 157| 参数名 | 类型 | 必填 | 说明 | 158| -------- | ------- | ---- | ------------------------------------------------------------ | 159| selected | boolean | 是 | 选中状态发生变化时，触发该回调。<br />返回值为true时，表示已选中，为false时，表示未选中。 | 160 161## 示例 162 163详见[Menu组件示例](ts-basic-components-menu.md#示例)。 164