鴻蒙ArkTS聲明式開發(fā)：跨平臺支持列表【菜單控制】 通用屬性
菜單控制
為組件綁定彈出式菜單，彈出式菜單以垂直列表形式顯示菜單項(xiàng)，可通過長按、點(diǎn)擊或鼠標(biāo)右鍵觸發(fā)。
說明：
開發(fā)前請熟悉鴻蒙開發(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] | 否 | 菜單彈出位置的偏移量，不會導(dǎo)致菜單顯示超出屏幕范圍。**說明：**菜單類型為相對?組件區(qū)域彈出時(shí)，?動(dòng)根據(jù)菜單位置屬性 (placement)將區(qū)域的寬或?計(jì)?偏移量中。 當(dāng)菜單相對父組件出現(xiàn)在上側(cè)時(shí)（placement設(shè)置為Placement.TopLeft，Placement.Top，Placement.TopRight），x為正值，菜單相對組件向右進(jìn)行偏移，y為正值，菜單相對組件向上進(jìn)行偏移。 當(dāng)菜單相對父組件出現(xiàn)在下側(cè)時(shí)（placement設(shè)置為Placement.BottomLeft，Placement.Bottom，Placement.BottomRight），x為正值，菜單相對組件向右進(jìn)行偏移，y為正值，菜單相對組件向下進(jìn)行偏移。 當(dāng)菜單相對父組件出現(xiàn)在左側(cè)時(shí)（placement設(shè)置為Placement.LeftTop，Placement.Left，Placement.LeftBottom），x為正值，菜單相對組件向左進(jìn)行偏移，y為正值，菜單相對組件向下進(jìn)行偏移。 當(dāng)菜單相對父組件出現(xiàn)在右側(cè)時(shí)（placement設(shè)置為Placement.RightTop，Placement.Right，Placement.RightBottom），x為正值，菜單相對組件向右進(jìn)行偏移，y為正值，菜單相對組件向下進(jìn)行偏移。 如果菜單調(diào)整了顯示位置（與placement初始值主方向不?致），則偏移值 (offset) 失效。 |
| placement | [Placement] | 否 | 菜單組件優(yōu)先顯示的位置，當(dāng)前位置顯示不下時(shí)，會自動(dòng)調(diào)整位置。**說明：**placement值設(shè)置為undefined、null或沒有設(shè)置此選項(xiàng)時(shí)，按默認(rèn)值[BottomLeft]處理，相對父組件區(qū)域彈出。 |
| onAppear | () => void | 否 | 菜單彈出時(shí)的事件回調(diào)。 |
| onDisappear | () => void | 否 | 菜單消失時(shí)的事件回調(diào)。 |
ContextMenuOptions10+
| 名稱 | 類型 | 必填 | 描述HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿 |
|---|---|---|---|
| offset | [Position] | 否 | 菜單彈出位置的偏移量，不會導(dǎo)致菜單顯示超出屏幕范圍。**說明：**菜單類型為相對?組件區(qū)域彈出時(shí)，?動(dòng)根據(jù)菜單位置屬性 (placement)將區(qū)域的寬或?計(jì)?偏移量中。 當(dāng)菜單相對父組件出現(xiàn)在上側(cè)時(shí)（placement設(shè)置為Placement.TopLeft，Placement.Top，Placement.TopRight），x為正值，菜單相對組件向右進(jìn)行偏移，y為正值，菜單相對組件向上進(jìn)行偏移。 當(dāng)菜單相對父組件出現(xiàn)在下側(cè)時(shí)（placement設(shè)置為Placement.BottomLeft，Placement.Bottom，Placement.BottomRight），x為正值，菜單相對組件向右進(jìn)行偏移，y為正值，菜單相對組件向下進(jìn)行偏移。 當(dāng)菜單相對父組件出現(xiàn)在左側(cè)時(shí)（placement設(shè)置為Placement.LeftTop，Placement.Left，Placement.LeftBottom），x為正值，菜單相對組件向左進(jìn)行偏移，y為正值，菜單相對組件向下進(jìn)行偏移。 當(dāng)菜單相對父組件出現(xiàn)在右側(cè)時(shí)（placement設(shè)置為Placement.RightTop，Placement.Right，Placement.RightBottom），x為正值，菜單相對組件向右進(jìn)行偏移，y為正值，菜單相對組件向下進(jìn)行偏移。 如果菜單調(diào)整了顯示位置（與placement初始值主方向不?致），則偏移值 (offset) 失效。 |
| placement | [Placement] | 否 | 菜單組件優(yōu)先顯示的位置，當(dāng)前位置顯示不下時(shí)，會自動(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才會生效，另外該值生效時(shí)不會導(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)立場。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請聯(lián)系本站處理。
舉報(bào)投訴
-
鴻蒙
+關(guān)注
關(guān)注
60文章
2621瀏覽量
44074
發(fā)布評論請先 登錄
相關(guān)推薦
熱點(diǎn)推薦
【 HarmonyOS 5 入門系列 】鴻蒙HarmonyOS示例項(xiàng)目講解
【 HarmonyOS 5 入門系列 】鴻蒙HarmonyOS示例項(xiàng)目講解 ##鴻蒙開發(fā)能力 ##HarmonyOS SDK應(yīng)用服務(wù)##鴻蒙金融類應(yīng)用 （金融理財(cái)# 一、前言：移動(dòng)
ArkUI-X跨平臺應(yīng)用改造指南
Android/iOS與HarmonyOS Next上能夠擁有相同的展示效果和交互體驗(yàn)。
1.開發(fā)者進(jìn)行設(shè)計(jì)時(shí)需首先考慮ArkUI-X框架的實(shí)際適配狀況，使用支持跨平臺的UI控件、
發(fā)表于 06-16 23:05
使用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跨平臺Bridge最佳實(shí)踐
;一碼三平臺\"
前面講到的bridge主要是解決開發(fā)者在進(jìn)行ArkTS代碼開發(fā)時(shí)，需要使用的鴻蒙API不
發(fā)表于 06-10 23:06
Kuikly鴻蒙版正式開源 —— 揭秘卓越性能適配之旅
Android、iOS開源基礎(chǔ)上，本次開源鴻蒙平臺支持和Compose DSL支持，進(jìn)一步提升業(yè)務(wù)多端適配和鴻蒙
發(fā)表于 06-04 16:46
ArkUI-X跨平臺框架接入指南
ArkUI跨平臺框架(ArkUI-X)進(jìn)一步將ArkUI開發(fā)框架擴(kuò)展到了多個(gè)OS平臺：目前支持OpenHarmony、Android、 iO
發(fā)表于 05-18 18:21
開源啦?。?！基于鴻蒙ArkTS封裝的圖表組件《McCharts》，大家快來一起共創(chuàng)
的地方請大家高抬貴手，寬容一下，謝謝。
這次主要是給大家?guī)硪粋€(gè)重磅消息，就是我自己使用鴻蒙ArkTS語法開發(fā)的圖表組件今日正式開源了。為什么？原因有兩點(diǎn)吧！
鴻蒙是國產(chǎn)的操作系統(tǒng)，
發(fā)表于 03-15 15:21
ArkTS開發(fā)指南優(yōu)化上新
ArkTS是HarmonyOS應(yīng)用開發(fā)的官方高級語言，提供了聲明式UI范式、狀態(tài)管理、渲染控制等相應(yīng)能力，讓
鴻蒙跨端實(shí)踐-布局方案介紹
封裝到標(biāo)簽中實(shí)現(xiàn)，業(yè)務(wù)只需要針對標(biāo)簽簡單地設(shè)置相關(guān)屬性，即可實(shí)現(xiàn)列表類布局，大幅提升研發(fā)效率。同時(shí)動(dòng)態(tài)化也支持絕對布局以及控制視圖的顯示和隱藏等功能，使之能勝任絕大多數(shù)業(yè)務(wù)布局場景。
HarmonyOS Next原生應(yīng)用開發(fā)-從TS到ArkTS的適配規(guī)則（十四）
語句表示執(zhí)行順序，而非逗號運(yùn)算符
let x = 0;
++x;
x = x++;
不支持解構(gòu)變量聲明
規(guī)則：arkts-no-destruct-decls
級別：錯(cuò)誤
ArkTS
發(fā)表于 08-16 10:20
鴻蒙原生應(yīng)用元服務(wù)開發(fā)-倉頡ArkTS相互操作（一）
在 OpenHarmony 系統(tǒng)上，ArkTS 具備完整廣泛的生態(tài)，為復(fù)用 ArkTS 生態(tài)，倉頡支持與 ArkTS 高效跨語言互通。
倉頡
發(fā)表于 07-31 17:43
HarmonyOS Next原生應(yīng)用開發(fā)-從TS到ArkTS的適配規(guī)則（十）
約束
對象字面量必須對應(yīng)某些顯式聲明的類或接口
對象字面量不能用于類型聲明
二、使用箭頭函數(shù)而非函數(shù)表達(dá)式
規(guī)則：arkts-no-func-expressions
級別：錯(cuò)誤
發(fā)表于 07-29 16:02
HarmonyOS Next原生應(yīng)用開發(fā)-從TS到ArkTS的適配規(guī)則（七）
一、不支持this類型
規(guī)則：arkts-no-typing-with-this
級別：錯(cuò)誤
ArkTS不支持this類型，改用顯式具體類型
發(fā)表于 07-22 15:11
工商網(wǎng)監(jiān)
評論