元素菜单模式

元素菜单模式会为当前聚焦窗口或鼠标下方元素打开一个小型覆盖菜单。你可以用它查看 Cursor Crane 识别到的目标、复制当前目标的信息、截图、进入元素展开模式、触发辅助功能行为，或把窗口加入关注，供元素模式和滚动模式之后使用。

进入元素菜单模式

你可以在命令模式中通过以下命令进入元素菜单模式：

CommandIdentifier	默认序列	目标
command.enterElementMenuModeForFocusedWindow	XW	当前聚焦窗口
command.enterElementMenuModeForElementBelowCursor	XE	鼠标下方元素

你也可以为这两个命令单独设置快捷键。

打开菜单

进入元素菜单模式后，Cursor Crane 会高亮当前选中的目标。按住 Space 打开菜单，松开 Space 关闭菜单。

打开菜单前，输入元素的提示标签可以将焦点移动到该元素。按住 Shift 并输入提示标签，可以将该元素加入或移出选择。你可以用这种方式选择多个元素，然后按住 Space 打开菜单，对这些元素执行操作。

菜单打开时：

• 输入显示的提示标签可以触发菜单项。
• 可以用方向键在菜单项之间移动。
• 按 Enter 触发当前选中的菜单项。
• 按 Delete 或方向左键返回上一层或关闭菜单。
• 按住 Option 可以在菜单项提供替代项时显示替代菜单项。

菜单动作

当前目标可能会提供这些动作：

• 打开 复制 子菜单，复制当前元素中的文本和元数据。
• 进入 元素展开模式，从当前元素中提取可复制文本。
• 打开 触发行为，执行当前元素暴露的辅助功能行为，或从元素展开模式中触发子元素行为。
• 拖选当前元素在屏幕上的范围。
• 将选中目标移动到父元素。
• 关注或取消关注当前目标所在的窗口。
• 截取当前元素，或截取当前目标所在的窗口。

具体显示哪些菜单项，取决于当前选中的目标。比如只有能解析回窗口的目标，才会显示 关注窗口。

复制动作

选择 复制 会打开当前元素的复制子菜单。这个子菜单可以复制当前目标中的文本和元数据；依赖不可用元素属性的菜单项会被隐藏。

菜单项	提示标签	结果
复制全文	C	复制从当前元素收集到的文本；如果没有找到辅助功能文本元素，会回退到 OCR。
复制 OCR	O	始终对当前元素的屏幕区域执行 OCR，再复制识别结果。
复制识别内容	R	以文本视图打开元素展开模式，从中选择识别出的文本或结构化内容。
复制选择器	S	复制可用于脚本的选择器；当前元素提供 domClass 时，生成结果也会带上该条件。
复制应用 Bundle Identifier	A	复制当前元素所属应用的 Bundle Identifier。
复制标题	T	复制当前元素的标题。
复制文档路径	D	当辅助功能层级提供该信息时，复制文档路径。
复制 URL	U	可用时复制 URL。
复制文件名	N	可用时复制文件名。
复制 DOM Class Name	L	可用时复制元素的 DOM class 列表。
复制 DOM ID	I	可用时复制元素的 DOM 标识符。
复制值	V	可用时复制当前元素的辅助功能值。

若要在脚本中使用复制出的选择器，参见元素选择器。需要时可以再显式调整生成结果中的 domClass 条件。

触发行为

选择 触发行为 会打开当前元素暴露的辅助功能行为列表。

触发子元素行为 会以行为视图打开元素展开模式，适合当前元素内部还有更深层按钮或控件时使用。

拖选范围

选中 会模拟从当前元素左上角拖到右下角。它适合配合需要在屏幕上选择矩形范围的流程使用，比如系统截图的区域选择工具；不适合用来选择文本。

截图动作

当当前目标能够解析回窗口时，元素菜单模式可以执行截图动作：

菜单项	目标	结果
复制截图	当前选中的元素	将元素截图复制到剪贴板
复制窗口截图	当前目标所在窗口	将窗口截图复制到剪贴板
截图	当前选中的元素	将元素截图保存到桌面
窗口截图	当前目标所在窗口	将窗口截图保存到桌面

截图 和 窗口截图 是替代菜单项。菜单打开时按住 Option ，截图菜单项会从“直接把图片写入剪贴板”切换为“保存到桌面”。

关注窗口

当补充窗口功能启用时，元素模式中的关注窗口和滚动模式中的关注窗口都会把这些窗口作为额外来源。这样即使重要窗口不是当前最前方窗口，也可以被纳入元素或滚动区域搜索范围。

若要关注窗口，你可以为当前聚焦窗口进入元素菜单模式，也可以先选中该窗口中的某个元素，再按住 Space ，然后选择 关注窗口。

只有能够从当前目标解析回窗口的项目，才能通过这种方式加入关注。Cursor Crane 会清理已经不存在的关注窗口。

相关模式

• 元素展开模式 用来提取当前元素中的可复制文本和可用操作。
• 当启用补充窗口功能时，元素模式会使用关注窗口作为额外来源。
• 滚动模式也可以把关注窗口作为额外来源。

相关命令

CommandIdentifier	动作
command.enterElementMenuModeForFocusedWindow	为当前聚焦窗口进入元素菜单
command.enterElementMenuModeForElementBelowCursor	为鼠标下方元素进入元素菜单