智慧屏和智能穿戴开发：基础组件menu

HarmonyOS应用开发文档更新修改说明：menu组件补充示例代码和示例效果图，方便开发者掌握该组件的使用方式。

提供菜单组件，作为临时性弹出窗口，用于展示用户可执行的操作。

支持设备

表1 组件的设备支持情况

智慧屏	智能穿戴
支持	不支持

权限列表

无

子组件

子组件。

属性

名称	类型	默认值	必填	描述
target	string	-	否	目标元素选择器。当使用目标元素选择器后，点击目标元素会自动弹出menu菜单。弹出菜单位置优先为目标元素右下角，当右边可视空间不足时会适当左移，当下方空间不足时会适当上移。
title	string	-	否	菜单标题内容。
id	string	-	否	组件的唯一标识。
style	string	-	否	组件的样式声明。
class	string	-	否	组件的样式类，用于引用样式表。

事件

名称	参数	描述
selected	{ value:value }	菜单中某个值被点击选中时触发，返回的value值为option组件的value属性。
cancel	-	用户取消。

样式

名称	类型	默认值	必填	描述
text-color		-	否	设置菜单的文本颜色。
font-size		30px	否	设置菜单的文本尺寸。
allow-scale	boolean	true	否	设置菜单的文本尺寸是否跟随系统设置字体缩放尺寸进行放大缩小。 说明 如果在config描述文件中针对ability配置了fontSize的config-changes标签，则应用不会重启而直接生效。
letter-spacing		0	否	设置菜单的字符间距。
font-style	string	normal	否	设置菜单的字体样式。见text组件font-style的样式属性。
font-weight	number | string	normal	否	设置菜单的字体粗细。见text组件font-weight的样式属性。
font-family	string	sans-serif	否	设置菜单的字体列表，用逗号分隔，每个字体用字体名或者字体族名设置。列表中第一个系统中存在的或者通过自定义字体指定的字体，会被选中作为文本的字体。

方法

支持如下方法。

名称	参数	描述
show	{ x:x, y:y }	显示menu菜单。(x, y)指定菜单弹窗位置。其中x表示距离可见区域左边沿的 X 轴坐标，不包含任何滚动偏移，y表示距离可见区域上边沿的 Y 轴坐标，不包含任何滚动偏移以及状态栏。菜单优先显示在弹窗位置右下角，当右边可视空间不足时会适当左移，当下方空间不足时会适当上移。

示例

  Show popup menu.
  
    Item 1
    Item 2
    Item 3
  

/* xxx.css */
.container {
  flex-direction: column;
  align-items: flex-start;
  justify-content: center;
}
.title-text {
  margin: 20px;
}

// xxx.js
import prompt from '@system.prompt';
 
export default {
  onMenuSelected(e) {
    prompt.showToast({
      message: e.value
    })
  },
  onTextClick() {
    this.$element("apiMenu").show({x:280,y:120});
  }
}