菜單控制

為組件綁定彈出式菜單，彈出式菜單以垂直列表形式顯示菜單項，可通過長按、點擊或鼠標右鍵觸發。

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
從API Version 7開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。
CustomBuilder里不支持再使用bindMenu、bindContextMenu彈出菜單。多級菜單可使用[Menu組件])。

屬性

名稱	參數類型	描述
bindMenu	content: Array<[MenuItem]>	[CustomBuilder], options?: [MenuOptions]
bindContextMenu8+	content: [CustomBuilder], responseType: [ResponseType]options?: [ContextMenuOptions]	給組件綁定菜單，觸發方式為長按或者右鍵點擊，彈出菜單項需要自定義。 responseType: 菜單彈出條件，長按或者右鍵點擊。 options: 配置彈出菜單的參數。

MenuItem

名稱	類型	必填	描述
value	string	是	菜單項文本。
icon10+	[ResourceStr]	否	菜單項圖標。
action	() => void	是	點擊菜單項的事件回調。

MenuOptions10+

名稱	類型	必填	描述
title	string	否	菜單標題。說明：僅在content設置為Array<[MenuItem]> 時生效。
offset	[Position]	否	菜單彈出位置的偏移量，不會導致菜單顯示超出屏幕范圍。說明：菜單類型為相對?組件區域彈出時，?動根據菜單位置屬性 (placement)將區域的寬或?計?偏移量中。當菜單相對父組件出現在上側時（placement設置為Placement.TopLeft，Placement.Top，Placement.TopRight），x為正值，菜單相對組件向右進行偏移，y為正值，菜單相對組件向上進行偏移。當菜單相對父組件出現在下側時（placement設置為Placement.BottomLeft，Placement.Bottom，Placement.BottomRight），x為正值，菜單相對組件向右進行偏移，y為正值，菜單相對組件向下進行偏移。當菜單相對父組件出現在左側時（placement設置為Placement.LeftTop，Placement.Left，Placement.LeftBottom），x為正值，菜單相對組件向左進行偏移，y為正值，菜單相對組件向下進行偏移。當菜單相對父組件出現在右側時（placement設置為Placement.RightTop，Placement.Right，Placement.RightBottom），x為正值，菜單相對組件向右進行偏移，y為正值，菜單相對組件向下進行偏移。如果菜單調整了顯示位置（與placement初始值主方向不?致），則偏移值 (offset) 失效。
placement	[Placement]	否	菜單組件優先顯示的位置，當前位置顯示不下時，會自動調整位置。說明：placement值設置為undefined、null或沒有設置此選項時，按默認值[BottomLeft]處理，相對父組件區域彈出。
onAppear	() => void	否	菜單彈出時的事件回調。
onDisappear	() => void	否	菜單消失時的事件回調。

ContextMenuOptions10+

搜狗高速瀏覽器截圖20240326151450.png

名稱	類型	必填	描述`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`
offset	[Position]	否	菜單彈出位置的偏移量，不會導致菜單顯示超出屏幕范圍。說明：菜單類型為相對?組件區域彈出時，?動根據菜單位置屬性 (placement)將區域的寬或?計?偏移量中。當菜單相對父組件出現在上側時（placement設置為Placement.TopLeft，Placement.Top，Placement.TopRight），x為正值，菜單相對組件向右進行偏移，y為正值，菜單相對組件向上進行偏移。當菜單相對父組件出現在下側時（placement設置為Placement.BottomLeft，Placement.Bottom，Placement.BottomRight），x為正值，菜單相對組件向右進行偏移，y為正值，菜單相對組件向下進行偏移。當菜單相對父組件出現在左側時（placement設置為Placement.LeftTop，Placement.Left，Placement.LeftBottom），x為正值，菜單相對組件向左進行偏移，y為正值，菜單相對組件向下進行偏移。當菜單相對父組件出現在右側時（placement設置為Placement.RightTop，Placement.Right，Placement.RightBottom），x為正值，菜單相對組件向右進行偏移，y為正值，菜單相對組件向下進行偏移。如果菜單調整了顯示位置（與placement初始值主方向不?致），則偏移值 (offset) 失效。
placement	[Placement]	否	菜單組件優先顯示的位置，當前位置顯示不下時，會自動調整位置。說明：placement值設置為undefined、null或沒有設置此選項時，按未設置placement處理，菜單跟隨點擊位置彈出。
arrowOffset	[Length]	否	箭頭在菜單處的偏移。箭頭在菜單水平方向時，偏移量為箭頭至最左側的距離，默認居中。箭頭在菜單豎直方向時，偏移量為箭頭至最上側的距離，默認居中。偏移量必須合法且轉換為具體數值時大于0才會生效，另外該值生效時不會導致箭頭超出菜單四周的安全距離。根據配置的placement來計算是在水平還是豎直方向上偏移。
onAppear	() => void	否	菜單彈出時的事件回調。
onDisappear	() => void	否	菜單消失時的事件回調。

審核編輯黃宇

聲明：本文內容及配圖由入駐作者撰寫或者入駐合作網站授權轉載。文章觀點僅代表作者本人，不代表電子發燒友網立場。文章及其配圖僅供工程師學習之用，如有內容侵權或者其他違規問題，請聯系本站處理。舉報投訴

鴻蒙

鴻蒙

+關注

關注
60

文章
2963

瀏覽量
45883

搜索歷史

鴻蒙ArkTS聲明式開發：跨平臺支持列表【菜單控制】通用屬性

菜單控制

屬性

MenuItem

MenuOptions10+

ContextMenuOptions10+

評論

搜索歷史

鴻蒙ArkTS聲明式開發：跨平臺支持列表【菜單控制】 通用屬性

菜單控制

屬性

MenuItem

MenuOptions10+

ContextMenuOptions10+

評論

鴻蒙ArkTS聲明式開發：跨平臺支持列表【菜單控制】通用屬性