菜單控制
為組件綁定彈出式菜單,彈出式菜單以垂直列表形式顯示菜單項,可通過長按、點擊或鼠標右鍵觸發。
說明:
開發前請熟悉鴻蒙開發指導文檔 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
屬性
名稱 | 參數類型 | 描述 |
---|---|---|
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+
名稱 | 類型 | 必填 | 描述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 | 否 | 菜單消失時的事件回調。 |
審核編輯 黃宇
聲明:本文內容及配圖由入駐作者撰寫或者入駐合作網站授權轉載。文章觀點僅代表作者本人,不代表電子發燒友網立場。文章及其配圖僅供工程師學習之用,如有內容侵權或者其他違規問題,請聯系本站處理。
舉報投訴
-
鴻蒙
+關注
關注
59文章
2507瀏覽量
43766
發布評論請先 登錄
相關推薦
熱點推薦
鴻蒙ArkTS聲明式開發:跨平臺支持列表【觸摸測試控制】觸摸交互控制
設置組件的觸摸測試類型。ArkUI開發框架在處理觸屏事件時,會在觸屏事件觸發前,進行按壓點和組件區域的觸摸測試來收集需要響應觸屏事件的組件,然后基于觸摸測試結果分發相應的觸屏
鴻蒙ArkTS聲明式開發:跨平臺支持列表【組件內容模糊】 通用屬性
為當前組件提供內容模糊能力。 value: 內容模糊樣式。模糊樣式由模糊半徑、蒙版顏色、蒙版透明度、飽和度、亮度五個參數組成。 options: 可選參數,內容模糊選項。

鴻蒙ArkTS聲明式開發:跨平臺支持列表【分布式遷移標識】 通用屬性
組件的分布式遷移標識,指明了該組件在分布式遷移場景下可以將特定狀態恢復到對端設備。
鴻蒙ArkTS聲明式開發:跨平臺支持列表【形狀裁剪】 通用屬性
參數為相應類型的組件,按指定的形狀對當前組件進行裁剪;參數為boolean類型時,設置是否按照父容器邊緣輪廓進行裁剪。 默認值:false 從API version 9開始,該接口支持在ArkTS卡片中使用。

評論