跳到主要内容

菜单项类型与原生菜单项

kind 参数说明

创建菜单项时通过 kind 参数指定菜单项的类型和行为。

kind说明label 含义点击行为
0命令显示文本menu-item-clicked 事件
1复选框显示文本menu-item-clicked 事件
2单选显示文本menu-item-clicked 事件
3分隔线忽略
4子菜单显示文本展开子菜单
5默认菜单项WebView2 Name(如 "copy"WebView2 原生操作,不发事件

⚠️ 注意:kind 枚举值 1/2/3 在早期版本中映射有误(1=分隔线、2=复选框、3=单选),现已修正为上述对应关系。此修正影响 context-menu 事件的 default_menu_names 字段中的 kind 值。

kind=5label 参数填写 WebView2 默认菜单项的 Name,点击时由 WebView2 执行原生操作,不触发 menu-item-clicked 事件

以下数据基于 WebView2 Runtime 实际运行输出采集。WebView2 对部分菜单项(分隔线、扩展注入项等)不暴露程序化 Name(返回 "other"),此类项无法通过 jade_menu_item_create(kind=5) 引用,已从列表中排除。


原生菜单项 Name 列表

按右键上下文分类

页面空白处(kind=page)

NameLabel类型
back返回(&B)命令
forward前进(&F)命令
reload刷新(&R)命令
分隔线分隔线
saveAs另存为(&A)命令
print打印(&P)命令
分隔线分隔线
moreTools更多工具(&L)子菜单
share共享(&S)命令
分隔线分隔线
inspectElement检查(&N)命令

选中文本(kind=selected_text)

NameLabel类型
copy复制(&C)命令
copyLinkToHighlight复制指向突出显示的链接命令
print打印(&P)命令
分割线分隔线
moreTools更多工具(&L)子菜单
share共享(&S)命令
分割线分隔线
inspectElement检查(&N)命令

可编辑区域(is_editable=true)

NameLabel类型
emoji表情符号(&E)命令
分割线分隔线
undo撤消(&U)命令
redo恢复(&R)命令
分割线分隔线
cut剪切(&T)命令
copy复制(&C)命令
paste粘贴(&P)命令
pasteAndMatchStyle粘贴为纯文本(&A)命令
selectAll全选(&A)命令
分割线分隔线
moreTools更多工具(&L)子菜单
share共享(&S)命令
分割线分隔线
inspectElement检查(&N)命令

链接(has_link=true)

NameLabel类型
openLinkInNewWindow在新窗口中打开链接(&W)命令
分割线分隔线
saveLinkAs将链接另存为(&K)命令
copyLinkLocation复制链接(&O)命令
分割线分隔线
moreTools更多工具(&L)子菜单
share共享(&S)命令
分割线分隔线
inspectElement检查(&N)命令

图片(kind=image)

NameLabel类型
saveImageAs将图像另存为(&V)命令
copyImage复制图像(&Y)命令
copyImageLocation复制图像链接(&M)命令
分割线分隔线
moreTools更多工具(&L)子菜单
magnifyImage放大图像(&M)命令
share共享(&S)命令
分割线分隔线
inspectElement检查(&N)命令

视频(kind=video)

NameLabel类型
saveMediaAs将视频另存为命令
copyLink复制链接(&O)命令
分割线分隔线
inspectElement检查(&N)命令

音频(kind=audio)

NameLabel类型
saveMediaAs将音频另存为(&V)命令
copyLink复制链接(&O)命令
分割线分隔线
inspectElement检查(&N)命令

完整 Name 索引

#Name说明出现场景
1back后退页面
2forward前进页面
3reload刷新页面
4cut剪切可编辑区域
5copy复制选中文本 / 可编辑区域
6paste粘贴可编辑区域
7pasteAndMatchStyle粘贴为纯文本可编辑区域
8selectAll全选可编辑区域
9undo撤消可编辑区域
10redo恢复可编辑区域
11emoji表情符号可编辑区域
12saveAs另存为页面
13saveLinkAs将链接另存为链接
14saveImageAs图片另存为图片
15saveMediaAs将媒体另存为视频 / 音频
16copyImage复制图片图片
17copyImageLocation复制图片地址图片
18copyLinkLocation复制链接链接
19copyLink复制链接视频 / 音频
20copyLinkToHighlight复制指向突出显示的链接选中文本
21openLinkInNewWindow在新窗口打开链接链接
22print打印页面 / 选中文本
23inspectElement检查元素所有场景
24moreTools更多工具(子菜单)大部分场景
25magnifyImage放大图像图片(moreTools 子项)
26share共享大部分场景(moreTools 子项)
27spellCheck拼写检查(子菜单)可编辑区域(取决于 WebView2 版本)
28extension扩展(子菜单)取决于已安装扩展
注意

Name 列表取决于 WebView2 Runtime 版本和右键上下文,部分项仅在特定场景下可用(如 copy 仅在选中文本时存在)。如果指定的 Name 在当前右键上下文中不存在,jade_menu_item_create 将返回 0context-menu 事件的 default_menu_names 字段会返回当前右键上下文中实际可用的完整列表。