鴻蒙ArkTS聲明式開發(fā)：跨平臺(tái)支持列表【菜單控制】 通用屬性
菜單控制
為組件綁定彈出式菜單，彈出式菜單以垂直列表形式顯示菜單項(xiàng)，可通過長按、點(diǎn)擊或鼠標(biāo)右鍵觸發(fā)。
說明：
開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
屬性
| 名稱 | 參數(shù)類型 | 描述 |
|---|---|---|
| bindMenu | content: Array<[MenuItem]> | [CustomBuilder], options?: [MenuOptions] |
| bindContextMenu8+ | content: [CustomBuilder], responseType: [ResponseType]options?: [ContextMenuOptions] | 給組件綁定菜單，觸發(fā)方式為長按或者右鍵點(diǎn)擊，彈出菜單項(xiàng)需要自定義。 responseType: 菜單彈出條件，長按或者右鍵點(diǎn)擊。 options: 配置彈出菜單的參數(shù)。 |
MenuItem
| 名稱 | 類型 | 必填 | 描述 |
|---|---|---|---|
| value | string | 是 | 菜單項(xiàng)文本。 |
| icon10+ | [ResourceStr] | 否 | 菜單項(xiàng)圖標(biāo)。 |
| action | () => void | 是 | 點(diǎn)擊菜單項(xiàng)的事件回調(diào)。 |
MenuOptions10+
| 名稱 | 類型 | 必填 | 描述 |
|---|---|---|---|
| title | string | 否 | 菜單標(biāo)題。**說明：**僅在content設(shè)置為Array<[MenuItem]> 時(shí)生效。 |
| offset | [Position] | 否 | 菜單彈出位置的偏移量，不會(huì)導(dǎo)致菜單顯示超出屏幕范圍。**說明：**菜單類型為相對(duì)?組件區(qū)域彈出時(shí)，?動(dòng)根據(jù)菜單位置屬性 (placement)將區(qū)域的寬或?計(jì)?偏移量中。 當(dāng)菜單相對(duì)父組件出現(xiàn)在上側(cè)時(shí)（placement設(shè)置為Placement.TopLeft，Placement.Top，Placement.TopRight），x為正值，菜單相對(duì)組件向右進(jìn)行偏移，y為正值，菜單相對(duì)組件向上進(jìn)行偏移。 當(dāng)菜單相對(duì)父組件出現(xiàn)在下側(cè)時(shí)（placement設(shè)置為Placement.BottomLeft，Placement.Bottom，Placement.BottomRight），x為正值，菜單相對(duì)組件向右進(jìn)行偏移，y為正值，菜單相對(duì)組件向下進(jìn)行偏移。 當(dāng)菜單相對(duì)父組件出現(xiàn)在左側(cè)時(shí)（placement設(shè)置為Placement.LeftTop，Placement.Left，Placement.LeftBottom），x為正值，菜單相對(duì)組件向左進(jìn)行偏移，y為正值，菜單相對(duì)組件向下進(jìn)行偏移。 當(dāng)菜單相對(duì)父組件出現(xiàn)在右側(cè)時(shí)（placement設(shè)置為Placement.RightTop，Placement.Right，Placement.RightBottom），x為正值，菜單相對(duì)組件向右進(jìn)行偏移，y為正值，菜單相對(duì)組件向下進(jìn)行偏移。 如果菜單調(diào)整了顯示位置（與placement初始值主方向不?致），則偏移值 (offset) 失效。 |
| placement | [Placement] | 否 | 菜單組件優(yōu)先顯示的位置，當(dāng)前位置顯示不下時(shí)，會(huì)自動(dòng)調(diào)整位置。**說明：**placement值設(shè)置為undefined、null或沒有設(shè)置此選項(xiàng)時(shí)，按默認(rèn)值[BottomLeft]處理，相對(duì)父組件區(qū)域彈出。 |
| onAppear | () => void | 否 | 菜單彈出時(shí)的事件回調(diào)。 |
| onDisappear | () => void | 否 | 菜單消失時(shí)的事件回調(diào)。 |
ContextMenuOptions10+
| 名稱 | 類型 | 必填 | 描述HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿 |
|---|---|---|---|
| offset | [Position] | 否 | 菜單彈出位置的偏移量，不會(huì)導(dǎo)致菜單顯示超出屏幕范圍。**說明：**菜單類型為相對(duì)?組件區(qū)域彈出時(shí)，?動(dòng)根據(jù)菜單位置屬性 (placement)將區(qū)域的寬或?計(jì)?偏移量中。 當(dāng)菜單相對(duì)父組件出現(xiàn)在上側(cè)時(shí)（placement設(shè)置為Placement.TopLeft，Placement.Top，Placement.TopRight），x為正值，菜單相對(duì)組件向右進(jìn)行偏移，y為正值，菜單相對(duì)組件向上進(jìn)行偏移。 當(dāng)菜單相對(duì)父組件出現(xiàn)在下側(cè)時(shí)（placement設(shè)置為Placement.BottomLeft，Placement.Bottom，Placement.BottomRight），x為正值，菜單相對(duì)組件向右進(jìn)行偏移，y為正值，菜單相對(duì)組件向下進(jìn)行偏移。 當(dāng)菜單相對(duì)父組件出現(xiàn)在左側(cè)時(shí)（placement設(shè)置為Placement.LeftTop，Placement.Left，Placement.LeftBottom），x為正值，菜單相對(duì)組件向左進(jìn)行偏移，y為正值，菜單相對(duì)組件向下進(jìn)行偏移。 當(dāng)菜單相對(duì)父組件出現(xiàn)在右側(cè)時(shí)（placement設(shè)置為Placement.RightTop，Placement.Right，Placement.RightBottom），x為正值，菜單相對(duì)組件向右進(jìn)行偏移，y為正值，菜單相對(duì)組件向下進(jìn)行偏移。 如果菜單調(diào)整了顯示位置（與placement初始值主方向不?致），則偏移值 (offset) 失效。 |
| placement | [Placement] | 否 | 菜單組件優(yōu)先顯示的位置，當(dāng)前位置顯示不下時(shí)，會(huì)自動(dòng)調(diào)整位置。**說明：**placement值設(shè)置為undefined、null或沒有設(shè)置此選項(xiàng)時(shí)，按未設(shè)置placement處理，菜單跟隨點(diǎn)擊位置彈出。 |
| arrowOffset | [Length] | 否 | 箭頭在菜單處的偏移。箭頭在菜單水平方向時(shí)，偏移量為箭頭至最左側(cè)的距離，默認(rèn)居中。箭頭在菜單豎直方向時(shí)，偏移量為箭頭至最上側(cè)的距離，默認(rèn)居中。偏移量必須合法且轉(zhuǎn)換為具體數(shù)值時(shí)大于0才會(huì)生效，另外該值生效時(shí)不會(huì)導(dǎo)致箭頭超出菜單四周的安全距離。根據(jù)配置的placement來計(jì)算是在水平還是豎直方向上偏移。 |
| onAppear | () => void | 否 | 菜單彈出時(shí)的事件回調(diào)。 |
| onDisappear | () => void | 否 | 菜單消失時(shí)的事件回調(diào)。 |
審核編輯 黃宇
聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請(qǐng)聯(lián)系本站處理。
舉報(bào)投訴
-
鴻蒙
+關(guān)注
關(guān)注
60文章
3012瀏覽量
46156
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
熱點(diǎn)推薦
基于凌羽派的OpenHarmony北向應(yīng)用開發(fā)：ArkTS語法-數(shù)據(jù)類型和變量聲明
包含初始值，開發(fā)者無需顯式指定類型，因?yàn)?b class='flag-5'>ArkTS規(guī)范已列舉了所有允許自動(dòng)推斷類型的場(chǎng)景。
以下示例中，兩條聲明語句都是有效的，兩個(gè)變量都是string類型：
let hi1: str
發(fā)表于 02-26 14:24
開源鴻蒙技術(shù)大會(huì)2025丨跨平臺(tái)開發(fā)框架分論壇：共拓移動(dòng)開發(fā)新邊界，共創(chuàng)跨平臺(tái)生態(tài)新時(shí)代
隨著開源鴻蒙生態(tài)的持續(xù)壯大，開發(fā)者迎來了除Android與iOS之外的“第三種選擇”。為解決“加入一個(gè)新生態(tài)就會(huì)增加一倍投入”的行業(yè)痛點(diǎn)，讓開發(fā)者的代碼能夠在更多平臺(tái)上復(fù)用，開源
開源鴻蒙技術(shù)大會(huì)2025丨開源鴻蒙應(yīng)用開發(fā)再提速，跨平臺(tái)框架PMC（籌）正式啟動(dòng)孵化
9月27日，開源鴻蒙技術(shù)大會(huì)2025在長沙國際會(huì)議中心盛大舉辦。大會(huì)現(xiàn)場(chǎng)，開源鴻蒙跨平臺(tái)框架PMC（籌）正式啟動(dòng)孵化，標(biāo)志著開源鴻蒙在應(yīng)用
【 HarmonyOS 5 入門系列 】鴻蒙HarmonyOS示例項(xiàng)目講解
【 HarmonyOS 5 入門系列 】鴻蒙HarmonyOS示例項(xiàng)目講解 ##鴻蒙開發(fā)能力 ##HarmonyOS SDK應(yīng)用服務(wù)##鴻蒙金融類應(yīng)用 （金融理財(cái)# 一、前言：移動(dòng)
鴻蒙ArkTS+ArkUI仿微信消息列表頁制作
\'
})
這里使用了justifyContent屬性來進(jìn)行居中，如果不加這個(gè)屬性的話，那么100%寬度的row會(huì)讓文字靠左顯示。接下來是顯示聊天數(shù)據(jù)的列表，這里采用ForEach列表
發(fā)表于 06-30 18:28
ArkUI-X跨平臺(tái)技術(shù)落地-華為運(yùn)動(dòng)健康(一)
開”的加載速度，所以目前H5跨平臺(tái)技術(shù)只在運(yùn)動(dòng)健康應(yīng)用某些低頻和容易變化的頁面上使用，在一二級(jí)頁面仍使用原生native開發(fā)。
跨平臺(tái)方案選
發(fā)表于 06-18 22:53
ArkUI-X跨平臺(tái)應(yīng)用改造指南
Android/iOS與HarmonyOS Next上能夠擁有相同的展示效果和交互體驗(yàn)。
1.開發(fā)者進(jìn)行設(shè)計(jì)時(shí)需首先考慮ArkUI-X框架的實(shí)際適配狀況，使用支持跨平臺(tái)的UI控件、
發(fā)表于 06-16 23:05
鴻蒙5開發(fā)寶藏案例分享---跨線程性能優(yōu)化指南
;>Worker</span>做多線程開發(fā)時(shí)，總遇到對(duì)象跨線程卡頓的問題，原來鴻蒙早就提供了解決方案。下面結(jié)合代碼和實(shí)戰(zhàn)案例，帶你徹底玩轉(zhuǎn)性能優(yōu)化！
一、痛點(diǎn)：跨線程
發(fā)表于 06-12 17:13
使用DevEcoStudio 開發(fā)、編譯鴻蒙 NEXT_APP 以及使用中文插件
的一站式集成開發(fā)環(huán)境（IDE），專為鴻蒙操作系統(tǒng)（HarmonyOS Next）應(yīng)用和服務(wù)開發(fā)設(shè)計(jì) DevEco Studio，掌握基本操作和開發(fā)
發(fā)表于 06-11 17:18
ArkUI-x跨平臺(tái)Bridge最佳實(shí)踐
;一碼三平臺(tái)\"
前面講到的bridge主要是解決開發(fā)者在進(jìn)行ArkTS代碼開發(fā)時(shí)，需要使用的鴻蒙API不
發(fā)表于 06-10 23:06
Kuikly鴻蒙版正式開源 —— 揭秘卓越性能適配之旅
Android、iOS開源基礎(chǔ)上，本次開源鴻蒙平臺(tái)支持和Compose DSL支持，進(jìn)一步提升業(yè)務(wù)多端適配和鴻蒙
發(fā)表于 06-04 16:46
HarmonyOS5云服務(wù)技術(shù)分享--ArkTS開發(fā)Node環(huán)境
? 你好呀，開發(fā)者小伙伴們！今天我們來聊聊如何在HarmonyOS（ArkTS API 9及以上）中玩轉(zhuǎn)云函數(shù)，特別是結(jié)合Node.js和HTTP觸發(fā)器的開發(fā)技巧。文章會(huì)手把手帶你從零開始，用最接地
發(fā)表于 05-22 17:21
ArkUI-X跨平臺(tái)框架接入指南
ArkUI跨平臺(tái)框架(ArkUI-X)進(jìn)一步將ArkUI開發(fā)框架擴(kuò)展到了多個(gè)OS平臺(tái)：目前支持OpenHarmony、Android、 iO
發(fā)表于 05-18 18:21
評(píng)論