Class: MenuItem to zh-CN
This commit is contained in:
Weiqiang Lin
parent
eba65eb4d3
commit
e267a0dd41
1 changed files with 71 additions and 22 deletions
|
|
@ -1,29 +1,40 @@
|
||||||
# 菜单项
|
# 菜单项
|
||||||
菜单项模块允许你向应用或[menu][1]添加选项。
|
|
||||||
|
|
||||||
查看[menu][1]例子。
|
## 类：菜单项
|
||||||
|
|
||||||
## 类：MenuItem
|
> 向原生的应用菜单和 context 菜单添加菜单项。
|
||||||
使用下面的方法创建一个新的 `MenuItem`
|
|
||||||
|
进程： [Main](../glossary.md#main-process)
|
||||||
|
|
||||||
|
查看 [`Menu`](menu.md) 的示。
|
||||||
|
|
||||||
|
### `new MenuItem(options)`
|
||||||
|
|
||||||
###new MenuItem(options)
|
|
||||||
* `options` Object
|
* `options` Object
|
||||||
* `click` Function - 当菜单项被点击的时候，使用 `click(menuItem,browserWindow)` 调用
|
* `click` Function (可选) - 当菜单项被点击的时候，使用 `click(menuItem,browserWindow)` 调用。
|
||||||
* `role` String - 定义菜单项的行为，在指定 `click` 属性时将会被忽略
|
* `menuItem` MenuItem
|
||||||
* `type` String - 取值 `normal`，`separator`，`checkbox`or`radio`
|
* `browserWindow` BrowserWindow
|
||||||
* `label` String
|
* `event` Event
|
||||||
* `sublabel` String
|
* `role` String (可选) - 定义菜单项的行为，在指定 `click` 属性时将会被忽略。
|
||||||
* `accelerator` [Accelerator][2]
|
* `type` String (可选) - 取值 `normal`, `separator`, `submenu`, `checkbox` or `radio`。
|
||||||
* `icon` [NativeImage][3]
|
* `label` String - (可选)
|
||||||
* `enabled` Boolean
|
* `sublabel` String - (可选)
|
||||||
* `visible` Boolean
|
* `accelerator` [Accelerator](accelerator.md) (可选)
|
||||||
* `checked` Boolean
|
* `icon` ([NativeImage](native-image.md) | String) (可选)
|
||||||
* `submenu` Menu - 应当作为 `submenu` 菜单项的特定类型，当它作为 `type: 'submenu'` 菜单项的特定类型时可以忽略。如果它的值不是 `Menu`，将自动转为 `Menu.buildFromTemplate`。
|
* `enabled` Boolean (可选) - 如果为 false，菜单项将显示为灰色不可点击。
|
||||||
* `id` String - 标志一个菜单的唯一性。如果被定义使用，它将被用作这个菜单项的参考位置属性。
|
unclickable.
|
||||||
* `position` String - 定义给定的菜单的具体指定位置信息。
|
* `visible` Boolean (可选) - 如果为 false，菜单项将完全隐藏。
|
||||||
|
* `checked` Boolean (可选) - 只为 `checkbox` 或 `radio` 类型的菜单项。
|
||||||
|
* `submenu` (MenuItemConstructorOptions[] | Menu) (可选) - 应当作为 `submenu` 菜单项的特定类型，当它作为 `type: 'submenu'` 菜单项的特定类型时可以忽略。如果它的值不是 `Menu`，将自动转为 `Menu.buildFromTemplate`。
|
||||||
|
* `id` String (可选) - 标志一个菜单的唯一性。如果被定义使用，它将被用作这个菜单项的参考位置属性。
|
||||||
|
* `position` String (可选) - 定义菜单的具体指定位置信息。
|
||||||
|
|
||||||
在创建菜单项时，如果有匹配的方法，建议指定 `role` 属性，不需要人为操作它的行为，这样菜单使用可以给用户最好的体验。
|
在创建菜单项时，如果有匹配的方法，建议指定 `role` 属性，
|
||||||
|
而不是试图手动实现在一个 `click` 函数中的行为。
|
||||||
|
内置的 `role` 行为将提供最好的原生体验。
|
||||||
|
|
||||||
|
当使用 `role' 时，`label' 和 `accelerator` 是可选的，默认为
|
||||||
|
到每个平台的适当值。
|
||||||
|
|
||||||
`role`属性值可以为：
|
`role`属性值可以为：
|
||||||
|
|
||||||
|
|
@ -32,9 +43,19 @@
|
||||||
* `cut`
|
* `cut`
|
||||||
* `copy`
|
* `copy`
|
||||||
* `paste`
|
* `paste`
|
||||||
|
* `pasteandmatchstyle`
|
||||||
* `selectall`
|
* `selectall`
|
||||||
|
* `delete`
|
||||||
* `minimize` - 最小化当前窗口
|
* `minimize` - 最小化当前窗口
|
||||||
* `close` - 关闭当前窗口
|
* `close` - 关闭当前窗口
|
||||||
|
* `quit`- 退出应用程序
|
||||||
|
* `reload` - 正常重新加载当前窗口
|
||||||
|
* `forcereload` - 忽略缓存并重新加载当前窗口
|
||||||
|
* `toggledevtools` - 在当前窗口中切换开发者工具
|
||||||
|
* `togglefullscreen`- 在当前窗口中切换全屏模式
|
||||||
|
* `resetzoom` - 将对焦页面的缩放级别重置为原始大小
|
||||||
|
* `zoomin` - 将聚焦页面缩小10％
|
||||||
|
* `zoomout` - 将聚焦页面放大10％
|
||||||
|
|
||||||
在 macOS 上，`role` 还可以有以下值：
|
在 macOS 上，`role` 还可以有以下值：
|
||||||
|
|
||||||
|
|
@ -42,16 +63,44 @@
|
||||||
* `hide` - 匹配 `hide` 行为
|
* `hide` - 匹配 `hide` 行为
|
||||||
* `hideothers` - 匹配 `hideOtherApplications` 行为
|
* `hideothers` - 匹配 `hideOtherApplications` 行为
|
||||||
* `unhide` - 匹配 `unhideAllApplications` 行为
|
* `unhide` - 匹配 `unhideAllApplications` 行为
|
||||||
|
* `startspeaking` - 匹配 `startSpeaking` 行为
|
||||||
|
* `stopspeaking` - 匹配 `stopSpeaking` 行为
|
||||||
* `front` - 匹配 `arrangeInFront` 行为
|
* `front` - 匹配 `arrangeInFront` 行为
|
||||||
|
* `zoom` - 匹配 `performZoom` 行为
|
||||||
* `window` - "Window" 菜单项
|
* `window` - "Window" 菜单项
|
||||||
* `help` - "Help" 菜单项
|
* `help` - "Help" 菜单项
|
||||||
* `services` - "Services" 菜单项
|
* `services` - "Services" 菜单项
|
||||||
|
|
||||||
|
当在 macOS 上指定 `role' 时，`label` 和 `accelerator` 是影响MenuItem的唯一的选项
|
||||||
|
所有其他选项将被忽略。
|
||||||
|
|
||||||
|
### 实例属性
|
||||||
|
|
||||||
|
`MenuItem` 对象拥有以下属性：
|
||||||
|
|
||||||
|
#### `menuItem.enabled`
|
||||||
|
|
||||||
|
一个布尔值表示是否启用该项，此属性可以动态改变。
|
||||||
|
|
||||||
[1]:https://github.com/heyunjiang/electron/blob/master/docs-translations/zh-CN/api/menu.md
|
#### `menuItem.visible`
|
||||||
[2]:https://github.com/heyunjiang/electron/blob/master/docs/api/accelerator.md
|
|
||||||
[3]:https://github.com/heyunjiang/electron/blob/master/docs/api/native-image.md
|
一个布尔值表示是否可见，此属性可以动态改变。
|
||||||
|
|
||||||
|
#### `menuItem.checked`
|
||||||
|
|
||||||
|
一个布尔值表示是否选中该项，此属性可以动态改变。
|
||||||
|
|
||||||
|
`checkbox` 菜单项将在选中和未选中切换 `checked` 属性。
|
||||||
|
|
||||||
|
`radio` 菜单项将在选中切换 `checked` 属性，并且
|
||||||
|
将关闭同一菜单中所有相邻项目的属性。
|
||||||
|
|
||||||
|
您可以为其他行为添加一个 `click` 函数。
|
||||||
|
|
||||||
|
#### `menuItem.label`
|
||||||
|
|
||||||
|
一个表示菜单项可见标签的字符串
|
||||||
|
|
||||||
|
#### `menuItem.click`
|
||||||
|
|
||||||
|
当 MenuItem 接收到点击事件时触发的函数
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue