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