鴻蒙ArkTS聲明式開(kāi)發(fā)：跨平臺(tái)支持列表【菜單控制】 通用屬性
菜單控制
為組件綁定彈出式菜單，彈出式菜單以垂直列表形式顯示菜單項(xiàng)，可通過(guò)長(zhǎng)按、點(diǎn)擊或鼠標(biāo)右鍵觸發(fā)。
說(shuō)明：
開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(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ā)方式為長(zhǎng)按或者右鍵點(diǎn)擊，彈出菜單項(xiàng)需要自定義。 responseType: 菜單彈出條件，長(zhǎng)按或者右鍵點(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)題。**說(shuō)明：**僅在content設(shè)置為Array<[MenuItem]> 時(shí)生效。 |
| offset | [Position] | 否 | 菜單彈出位置的偏移量，不會(huì)導(dǎo)致菜單顯示超出屏幕范圍。**說(shuō)明：**菜單類型為相對(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)整位置。**說(shuō)明：**placement值設(shè)置為undefined、null或沒(méi)有設(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)致菜單顯示超出屏幕范圍。**說(shuō)明：**菜單類型為相對(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)整位置。**說(shuō)明：**placement值設(shè)置為undefined、null或沒(méi)有設(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來(lái)計(jì)算是在水平還是豎直方向上偏移。 |
| onAppear | () => void | 否 | 菜單彈出時(shí)的事件回調(diào)。 |
| onDisappear | () => void | 否 | 菜單消失時(shí)的事件回調(diào)。 |
審核編輯 黃宇
聲明：本文內(nèi)容及配圖由入駐作者撰寫(xiě)或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問(wèn)題，請(qǐng)聯(lián)系本站處理。
舉報(bào)投訴
-
鴻蒙
+關(guān)注
關(guān)注
60文章
2841瀏覽量
45335
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
熱點(diǎn)推薦
開(kāi)源鴻蒙技術(shù)大會(huì)2025丨跨平臺(tái)開(kāi)發(fā)框架分論壇：共拓移動(dòng)開(kāi)發(fā)新邊界，共創(chuàng)跨平臺(tái)生態(tài)新時(shí)代
隨著開(kāi)源鴻蒙生態(tài)的持續(xù)壯大，開(kāi)發(fā)者迎來(lái)了除Android與iOS之外的“第三種選擇”。為解決“加入一個(gè)新生態(tài)就會(huì)增加一倍投入”的行業(yè)痛點(diǎn)，讓開(kāi)發(fā)者的代碼能夠在更多平臺(tái)上復(fù)用，開(kāi)源
開(kāi)源鴻蒙技術(shù)大會(huì)2025丨開(kāi)源鴻蒙應(yīng)用開(kāi)發(fā)再提速，跨平臺(tái)框架PMC（籌）正式啟動(dòng)孵化
9月27日，開(kāi)源鴻蒙技術(shù)大會(huì)2025在長(zhǎng)沙國(guó)際會(huì)議中心盛大舉辦。大會(huì)現(xiàn)場(chǎng)，開(kāi)源鴻蒙跨平臺(tái)框架PMC（籌）正式啟動(dòng)孵化，標(biāo)志著開(kāi)源鴻蒙在應(yīng)用
【 HarmonyOS 5 入門(mén)系列 】鴻蒙HarmonyOS示例項(xiàng)目講解
【 HarmonyOS 5 入門(mén)系列 】鴻蒙HarmonyOS示例項(xiàng)目講解 ##鴻蒙開(kāi)發(fā)能力 ##HarmonyOS SDK應(yīng)用服務(wù)##鴻蒙金融類應(yīng)用 （金融理財(cái)# 一、前言：移動(dòng)
鴻蒙ArkTS+ArkUI仿微信消息列表頁(yè)制作
\'
})
這里使用了justifyContent屬性來(lái)進(jìn)行居中，如果不加這個(gè)屬性的話，那么100%寬度的row會(huì)讓文字靠左顯示。接下來(lái)是顯示聊天數(shù)據(jù)的列表，這里采用ForEach列表
發(fā)表于 06-30 18:28
UI開(kāi)發(fā)概述
基于ArkTS的聲明式開(kāi)發(fā)范式的方舟開(kāi)發(fā)框架是一套開(kāi)發(fā)極簡(jiǎn)、高性能、
發(fā)表于 06-24 06:36
ArkUI-X跨平臺(tái)技術(shù)落地-華為運(yùn)動(dòng)健康(一)
開(kāi)”的加載速度，所以目前H5跨平臺(tái)技術(shù)只在運(yùn)動(dòng)健康應(yīng)用某些低頻和容易變化的頁(yè)面上使用，在一二級(jí)頁(yè)面仍使用原生native開(kāi)發(fā)。
跨平臺(tái)方案選
發(fā)表于 06-18 22:53
什么是ArkTS？
ArkTS簡(jiǎn)介
ArkTS是OpenHarmony優(yōu)選的應(yīng)用高級(jí)開(kāi)發(fā)語(yǔ)言。ArkTS提供了聲明式
發(fā)表于 06-17 06:24
ArkUI-X跨平臺(tái)應(yīng)用改造指南
Android/iOS與HarmonyOS Next上能夠擁有相同的展示效果和交互體驗(yàn)。
1.開(kāi)發(fā)者進(jìn)行設(shè)計(jì)時(shí)需首先考慮ArkUI-X框架的實(shí)際適配狀況，使用支持跨平臺(tái)的UI控件、
發(fā)表于 06-16 23:05
使用DevEcoStudio 開(kāi)發(fā)、編譯鴻蒙 NEXT_APP 以及使用中文插件
的一站式集成開(kāi)發(fā)環(huán)境（IDE），專為鴻蒙操作系統(tǒng)（HarmonyOS Next）應(yīng)用和服務(wù)開(kāi)發(fā)設(shè)計(jì) DevEco Studio，掌握基本操作和開(kāi)發(fā)
發(fā)表于 06-11 17:18
ArkUI-x跨平臺(tái)Bridge最佳實(shí)踐
;一碼三平臺(tái)\"
前面講到的bridge主要是解決開(kāi)發(fā)者在進(jìn)行ArkTS代碼開(kāi)發(fā)時(shí)，需要使用的鴻蒙API不
發(fā)表于 06-10 23:06
Kuikly鴻蒙版正式開(kāi)源 —— 揭秘卓越性能適配之旅
Android、iOS開(kāi)源基礎(chǔ)上，本次開(kāi)源鴻蒙平臺(tái)支持和Compose DSL支持，進(jìn)一步提升業(yè)務(wù)多端適配和鴻蒙
發(fā)表于 06-04 16:46
HarmonyOS5云服務(wù)技術(shù)分享--ArkTS開(kāi)發(fā)Node環(huán)境
? 你好呀，開(kāi)發(fā)者小伙伴們！今天我們來(lái)聊聊如何在HarmonyOS（ArkTS API 9及以上）中玩轉(zhuǎn)云函數(shù)，特別是結(jié)合Node.js和HTTP觸發(fā)器的開(kāi)發(fā)技巧。文章會(huì)手把手帶你從零開(kāi)始，用最接地
發(fā)表于 05-22 17:21
ArkUI-X跨平臺(tái)框架接入指南
ArkUI跨平臺(tái)框架(ArkUI-X)進(jìn)一步將ArkUI開(kāi)發(fā)框架擴(kuò)展到了多個(gè)OS平臺(tái)：目前支持OpenHarmony、Android、 iO
發(fā)表于 05-18 18:21
開(kāi)源啦?。。』?b class='flag-5'>鴻蒙ArkTS封裝的圖表組件《McCharts》，大家快來(lái)一起共創(chuàng)
的地方請(qǐng)大家高抬貴手，寬容一下，謝謝。
這次主要是給大家?guī)?lái)一個(gè)重磅消息，就是我自己使用鴻蒙ArkTS語(yǔ)法開(kāi)發(fā)的圖表組件今日正式開(kāi)源了。為什么？原因有兩點(diǎn)吧！
鴻蒙是國(guó)產(chǎn)的操作系統(tǒng)，
發(fā)表于 03-15 15:21
ArkTS語(yǔ)言基礎(chǔ)介紹篇
KaihongOS是一個(gè)開(kāi)源的、跨設(shè)備的操作系統(tǒng)，它支持多種設(shè)備類型。ArkTS是KaihongOS應(yīng)用開(kāi)發(fā)中使用的TypeScript超集，提供了一套豐富的API來(lái)構(gòu)建應(yīng)用界面和邏輯
發(fā)表于 01-10 10:15
工商網(wǎng)監(jiān)
評(píng)論