1# menu 2 3>  **说明：** 4> 从API version 4开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 5 6提供菜单组件，作为临时性弹出窗口，用于展示用户可执行的操作。 7 8## 权限列表 9 10无 11 12 13## 子组件 14 15<[option](../arkui-js/js-components-basic-option.md)>子组件。 16 17 18## 属性 19 20除支持[通用属性](../arkui-js/js-components-common-attributes.md)外，还支持如下属性：↵ 21 22| 名称 | 类型 | 默认值 | 必填 | 描述 | 23| -------- | -------- | -------- | -------- | -------- | 24| target | string | - | 否 | 目标元素选择器。当使用目标元素选择器后，点击目标元素会自动弹出menu菜单。弹出菜单位置优先为目标元素右下角，当右边可视空间不足时会适当左移，当下方空间不足时会适当上移。 | 25| type | string | click | 否 | 目标元素触发弹窗的方式，可选值有：<br/>- click：点击弹窗。<br/>- longpress：长按弹窗。 | 26| title | string | - | 否 | 菜单标题内容。 | 27 28>  **说明：** 29> 不支持focusable、disabled属性。 30 31 32## 样式 33 34仅支持如下样式： 35 36| 名称 | 类型 | 默认值 | 必填 | 描述 | 37| -------- | -------- | -------- | -------- | -------- | 38| text-color | <color> | - | 否 | 设置菜单的文本颜色。 | 39| font-size | <length> | 30px | 否 | 设置菜单的文本尺寸。 | 40| allow-scale | boolean | true | 否 | 设置菜单的文本尺寸是否跟随系统设置字体缩放尺寸进行放大缩小。<br/>>  **说明：**<br/>> 如果在config描述文件中针对ability配置了fontSize的config-changes标签，则应用不会重启而直接生效。 | 41| letter-spacing | <length> | 0 | 否 | 设置菜单的字符间距。 | 42| font-style | string | normal | 否 | 设置菜单的字体样式。见[text组件font-style的样式属性](../arkui-js/js-components-basic-text.md#样式)。 | 43| font-weight | number \| string | normal | 否 | 设置菜单的字体粗细。见[text组件font-weight的样式属性](../arkui-js/js-components-basic-text.md#样式)。 | 44| font-family | string | sans-serif | 否 | 设置菜单的字体列表，用逗号分隔，每个字体用字体名或者字体族名设置。列表中第一个系统中存在的或者通过[自定义字体](../arkui-js/js-components-common-customizing-font.md)指定的字体，会被选中作为文本的字体。 | 45 46 47## 事件 48 49仅支持如下事件： 50 51| 名称 | 参数 | 描述 | 52| -------- | -------- | -------- | 53| selected | { value:value } | 菜单中某个值被点击选中时触发，返回的value值为option组件的value属性。 | 54| cancel | - | 用户取消。 | 55 56 57## 方法 58 59仅支持如下方法。 60 61| 名称 | 参数 | 描述 | 62| -------- | -------- | -------- | 63| show | { x:x, y:y } | 显示menu菜单。(x, y)指定菜单弹窗位置。其中x表示距离可见区域左边沿的 X 轴坐标，不包含任何滚动偏移，y表示距离可见区域上边沿的 Y 轴坐标，不包含任何滚动偏移以及状态栏。菜单优先显示在弹窗位置右下角，当右边可视空间不足时会适当左移，当下方空间不足时会适当上移。 | 64 65## 示例 66 67``` 68<!-- xxx.hml --> 69<div class="container"> 70 <text onclick="onTextClick" class="title-text">Show popup menu.</text> 71 <menu id="apiMenu" onselected="onMenuSelected"> 72 <option value="Item 1">Item 1</option> 73 <option value="Item 2">Item 2</option> 74 <option value="Item 3">Item 3</option> 75 </menu> 76</div> 77``` 78 79``` 80/* xxx.css */ 81.container { 82 flex-direction: column; 83 align-items: flex-start; 84 justify-content: center; 85} 86.title-text { 87 margin: 20px; 88} 89``` 90 91``` 92// xxx.js 93import prompt from '@system.prompt'; 94export default { 95 onMenuSelected(e) { 96 prompt.showToast({ 97 message: e.value 98 }) 99 }, 100 onTextClick() { 101 this.$element("apiMenu").show({x:280,y:120}); 102 } 103} 104``` 105 106 107
