鴻蒙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)容及配圖由入駐作者撰寫或者入駐合作網(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文章
2620瀏覽量
44058
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
熱點(diǎn)推薦
【 HarmonyOS 5 入門系列 】鴻蒙HarmonyOS示例項(xiàng)目講解
【 HarmonyOS 5 入門系列 】鴻蒙HarmonyOS示例項(xiàng)目講解 ##鴻蒙開(kāi)發(fā)能力 ##HarmonyOS SDK應(yīng)用服務(wù)##鴻蒙金融類應(yīng)用 （金融理財(cái)# 一、前言：移動(dòng)
UI開(kāi)發(fā)概述
基于ArkTS的聲明式開(kāi)發(fā)范式的方舟開(kāi)發(fā)框架是一套開(kāi)發(fā)極簡(jiǎn)、高性能、
發(fā)表于 06-24 06:36
什么是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
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)源啦?。?！基于鴻蒙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開(kāi)發(fā)指南優(yōu)化上新
ArkTS是HarmonyOS應(yīng)用開(kāi)發(fā)的官方高級(jí)語(yǔ)言，提供了聲明式UI范式、狀態(tài)管理、渲染控制等相應(yīng)能力，讓
鴻蒙跨端實(shí)踐-布局方案介紹
封裝到標(biāo)簽中實(shí)現(xiàn)，業(yè)務(wù)只需要針對(duì)標(biāo)簽簡(jiǎn)單地設(shè)置相關(guān)屬性，即可實(shí)現(xiàn)列表類布局，大幅提升研發(fā)效率。同時(shí)動(dòng)態(tài)化也支持絕對(duì)布局以及控制視圖的顯示和隱藏等功能，使之能勝任絕大多數(shù)業(yè)務(wù)布局場(chǎng)景。
HarmonyOS Next原生應(yīng)用開(kāi)發(fā)-從TS到ArkTS的適配規(guī)則（十四）
語(yǔ)句表示執(zhí)行順序，而非逗號(hào)運(yùn)算符
let x = 0;
++x;
x = x++;
不支持解構(gòu)變量聲明
規(guī)則：arkts-no-destruct-decls
級(jí)別：錯(cuò)誤
ArkTS
發(fā)表于 08-16 10:20
鴻蒙原生應(yīng)用元服務(wù)開(kāi)發(fā)-倉(cāng)頡ArkTS相互操作（一）
在 OpenHarmony 系統(tǒng)上，ArkTS 具備完整廣泛的生態(tài)，為復(fù)用 ArkTS 生態(tài)，倉(cāng)頡支持與 ArkTS 高效跨語(yǔ)言互通。
倉(cāng)頡
發(fā)表于 07-31 17:43
HarmonyOS Next原生應(yīng)用開(kāi)發(fā)-從TS到ArkTS的適配規(guī)則（十）
約束
對(duì)象字面量必須對(duì)應(yīng)某些顯式聲明的類或接口
對(duì)象字面量不能用于類型聲明
二、使用箭頭函數(shù)而非函數(shù)表達(dá)式
規(guī)則：arkts-no-func-expressions
級(jí)別：錯(cuò)誤
發(fā)表于 07-29 16:02
HarmonyOS Next原生應(yīng)用開(kāi)發(fā)-從TS到ArkTS的適配規(guī)則（七）
一、不支持this類型
規(guī)則：arkts-no-typing-with-this
級(jí)別：錯(cuò)誤
ArkTS不支持this類型，改用顯式具體類型
發(fā)表于 07-22 15:11
工商網(wǎng)監(jiān)
評(píng)論