跳到主要内容

# 文本元素抓取器

文本元素抓取器用于从设备当前画面中抓取可被系统识别的文本、按钮、输入框和其它界面元素。它适合生成点击、输入、滚动和判断页面是否出现某段文字的脚本代码。

## 打开方式​

- 打开 `样本工作台`，切换到顶部的 `文本元素` 页。
- 在设备列表中右键目标设备，选择 `文本元素抓取`。这样会直接打开文本元素页，并带入该设备。

## 抓取当前页面​

抓取前，先让设备停在要分析的 App 页面。可以通过远控面板操作设备，也可以直接在设备上切到目标页面。设备需要在线，并支持文本元素抓取。

1. 点击面板右上角 `设置`。
2. 在 `元素抓取设备` 中点击 `选择设备`。如果已经设置开发测试设备，也可以选择 `当前开发测试设备`。
3. 点击 `抓取文本元素`。
4. 抓取完成后，左侧会显示截图和元素框，右侧会显示层级概览和元素详情。
5. 在截图或层级树上移动鼠标查看元素范围，点击后固定选择。
6. 在元素详情中选择动作并点击 `复制代码`。

抓取结果会以标签形式保留。多次抓取不同画面时，可以在结果标签之间切换、拖动排序或关闭旧结果。

## 选择生成动作​

常见选择：

- 要点击按钮，选择 `点击`。
- 要判断页面是否出现某段文字，选择 `判断存在`。
- 要给输入框输入内容，选择 `插入文本` 或 `设置文本`。
- 要清空输入框，选择 `清空文本`。
- 要翻动列表或页面，选择 `滚动`。
- 只是想先找到元素，选择 `查找`。

普通脚本优先使用 `复制代码`。如果想自己组合条件，可以用 `复制匹配字段`；`复制 JSON` 更适合排查问题或反馈给维护者，不建议作为日常写脚本的首选。

如果同一个元素要连续做多步操作，可以把生成方式切到 `复用元素引用`；只做一次点击或判断时，保持默认即可。

## 点不到或抓不到时​

- 抓取失败：点击 `重试`，并确认设备在线、当前页面没有频繁切换。
- 结果为空：确认页面上确实有系统可识别的文本或控件；如果没有，可以改用 取色器 的坐标和颜色方案。
- 元素框位置不准或生成的点击点不到：重新抓取当前页面，再在设置中调整 `Hit 网格`；必要时开启 `强制命中` 后重新抓取。
- 提示当前设备不支持文本元素抓取：换用支持该能力的设备，或改用取色器完成定位。