菜單控制

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

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

屬性

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

MenuItem

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

MenuOptions10+

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

ContextMenuOptions10+

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

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

審核編輯黃宇

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

鴻蒙

鴻蒙

+關(guān)注

關(guān)注
57

文章
2302

瀏覽量
42689

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【文本通用】

文本通用屬性目前只針對包含文本元素的組件，設(shè)置文本樣式。

發(fā)表于 06-13 15:09 ?398次閱讀

<b class='flag-5'>鴻蒙</b><b class='flag-5'>ArkTS</b><b class='flag-5'>聲明</b><b class='flag-5'>式</b><b class='flag-5'>開發(fā)</b>：<b class='flag-5'>跨</b><b class='flag-5'>平臺</b><b class='flag-5'>支持</b><b class='flag-5'>列表</b>【文本<b class='flag-5'>通用</b>】

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【無障礙屬性】通用屬性

組件可以設(shè)置相應(yīng)的無障礙屬性和事件來更好地使用無障礙能力。

發(fā)表于 06-11 17:30 ?342次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【分布式遷移標識】通用屬性

組件的分布式遷移標識，指明了該組件在分布式遷移場景下可以將特定狀態(tài)恢復到對端設(shè)備。

發(fā)表于 06-07 21:15 ?336次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【多態(tài)樣式】通用屬性

設(shè)置組件不同狀態(tài)的樣式。從API version 9開始，該接口支持在ArkTS卡片中使用。

發(fā)表于 06-07 09:48 ?345次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【組件標識】通用屬性

id為組件的唯一標識，在整個應(yīng)用內(nèi)唯一。本模塊提供組件標識相關(guān)接口，可以獲取指定id組件的屬性，也提供向指定id組件發(fā)送事件的功能。

發(fā)表于 06-06 15:51 ?333次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【柵格設(shè)置】通用屬性

默認占用列數(shù)，指useSizeType屬性沒有設(shè)置對應(yīng)尺寸的列數(shù)(span)時，占用的柵格列數(shù)。

發(fā)表于 06-05 09:28 ?348次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【形狀裁剪】通用屬性

參數(shù)為相應(yīng)類型的組件，按指定的形狀對當前組件進行裁剪；參數(shù)為boolean類型時，設(shè)置是否按照父容器邊緣輪廓進行裁剪。默認值：false 從API version 9開始，該接口支持在ArkTS卡片中使用。

發(fā)表于 06-04 15:22 ?404次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【透明度設(shè)置】通用屬性

從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標單獨標記該內(nèi)容的起始版本。

發(fā)表于 06-03 15:59 ?541次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【顯隱控制】通用屬性

控制當前組件顯示或隱藏。注意，即使組件處于隱藏狀態(tài)，在頁面刷新時仍存在重新創(chuàng)建過程，因此當對性能有嚴格要求時建議使用[條件渲染]代替。默認值：Visibility.Visible 從API version 9開始，該接口支持在ArkT

發(fā)表于 06-03 14:46 ?527次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【浮層】通用屬性

從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標單獨標記該內(nèi)容的起始版本。

發(fā)表于 06-03 09:48 ?295次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【背景設(shè)置】通用屬性

從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標單獨標記該內(nèi)容的起始版本。

發(fā)表于 05-31 15:22 ?557次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【邊框設(shè)置】通用屬性

從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標單獨標記該內(nèi)容的起始版本。

發(fā)表于 05-31 09:48 ?838次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【圖片邊框設(shè)置】通用屬性

從API Version 9開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標單獨標記該內(nèi)容的起始版本。

發(fā)表于 05-31 09:41 ?719次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【Flex布局】通用屬性

從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標單獨標記該內(nèi)容的起始版本。 > - 僅當父組件是 Flex、Column、Row 、GridRow時生效。

發(fā)表于 05-30 14:38 ?506次閱讀

鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【按鍵事件】

按鍵事件指組件與鍵盤、遙控器等按鍵設(shè)備交互時觸發(fā)的事件，適用于所有可獲焦組件，例如Button。對于Text，Image等默認不可獲焦的組件，可以設(shè)置focusable屬性為true后使用按鍵事件。

發(fā)表于 05-28 18:12 ?789次閱讀