# 灵梭RPA 教程文档 - 相似元素操作 ## 目录 - [概述](#概述) - [1. 循环相似元素](#1-循环相似元素) - [获取元素文本内容](#获取元素文本内容) - [获取元素对象](#获取元素对象) - [获取元素值](#获取元素值) - [获取元素链接地址](#获取元素链接地址) - [获取元素源代码](#获取元素源代码) - [获取元素属性](#获取元素属性) - [2. 获取相似元素列表](#2-获取相似元素列表) - [使用技巧](#使用技巧) - [常见问题](#常见问题) --- ## 概述 **相似元素操作**就像批量处理网页上相似的东西一样。当网页上有多个结构相同的元素（比如商品列表、文章列表、表格行等）时，可以用这个功能批量处理它们。 ### 主要功能 - ✅ **循环相似元素**：遍历每个元素，对每个元素执行操作（比如点击、获取信息等） - ✅ **获取相似元素列表**：一次性获取所有元素的数据（不用循环，直接全部获取） ### 和批量数据获取有什么区别？ - **批量数据获取**：只能获取元素的文字内容，适合简单的数据采集 - **相似元素操作**：可以获取元素的多种属性（文字、链接、属性等），还可以对每个元素进行复杂操作（比如点击、输入等） --- ## 1. 循环相似元素 **循环相似元素**就像一个个处理列表里的每个东西一样，找到所有相似的元素，然后对每个元素执行操作。这是处理列表数据最强大的方式。 ### 功能说明 - **找到所有匹配的元素**：根据选择器找到所有相似的元素 - **遍历每个元素**：一个个处理，不遗漏 - **可以执行任意操作**：在循环里可以对每个元素做各种操作（点击、输入、获取信息等） - **获取多种属性**：可以获取元素的文字、链接、属性等 - **指定循环范围**：可以只处理前几个，或者从第几个开始 ### 需要填什么？ | 参数 | 说明 | 必填 | 默认值 | | ----------------- | ----------------------------------------------------- | ------ | ---------------- | | tab对象 | 要在哪个网页操作？填标签页变量名，比如`{{网页1}}` | ✅ | - | | 操作目标css/xpath | 要处理什么元素？填选择器，比如`.商品` | ✅ | - | | 元素操作 | 要获取元素的什么？选类型（下面有说明） | ✅ | 获取元素文本内容 | | 属性名 | 如果选"获取元素属性"，要填属性名（比如`href`、`src`） | 看情况 | - | | 保存当前循环项至 | 把当前元素的值存到哪个变量？填变量名，比如`当前商品` | ✅ | - | ### 元素操作类型（要获取什么？） - **获取元素文本内容**：获取元素显示的文字（最常用） - **获取元素对象**：获取元素对象本身（可以用来后续操作，比如点击这个元素） - **获取元素值**：获取表单元素的值（比如输入框里的值） - **获取元素链接地址**：获取链接的地址（比如`href`属性） - **获取元素源代码**：获取元素的HTML代码 - **获取元素属性**：获取指定的属性值（比如`src`、`data-id`等） ### 什么时候用？ - **遍历商品列表**：获取每个商品的信息（名称、价格等） - **遍历表格行**：处理表格的每一行数据 - **遍历链接列表**：打开每个链接（比如打开所有新闻链接） - **遍历图片列表**：下载每张图片 - **遍历评论列表**：采集每条评论的内容 --- ### 获取元素文本内容获取每个元素显示的文字内容，这是最常用的方式。比如获取商品名称、新闻标题等。 #### 示例 **示例1**：遍历商品标题列表 ```html

商品A

¥99

商品B

¥199

商品C

¥299

``` ``` 配置： tab对象：{{main_tab}} 操作目标css/xpath：.title 元素操作：获取元素文本内容保存当前循环项至：current_title 循环体内的操作： 1. 日志输出 - 输出内容：当前商品标题：{{current_title}} ``` **输出结果**： ``` 当前商品标题：商品A 当前商品标题：商品B 当前商品标题：商品C ``` **示例2**：采集并保存到列表 ``` 前置步骤：新建列表 - 保存列表对象至：product_list 循环相似元素： - tab对象：{{shop_tab}} - 操作目标css/xpath：.product-title - 元素操作：获取元素文本内容 - 保存当前循环项至：title 列表插入一项： - 列表：{{product_list}} - 插入内容：{{title}} 后续处理： - 列表去重 - 列表排序 - 保存到CSV ``` --- ### 获取元素对象获取元素对象本身，可以在循环里对这个元素进行进一步操作（比如点击、输入等）。 #### 为什么用这个？ - **可以对元素操作**：可以对元素进行点击、输入等操作 - **可以获取多个属性**：可以获取元素的多个属性（文字、链接、class等） - **适合复杂场景**：适合需要和元素交互的复杂场景 #### 示例 **示例1**：点击每个按钮 ``` 循环相似元素： - tab对象：{{page_tab}} - 操作目标css/xpath：.action-button - 元素操作：获取元素对象 - 保存当前循环项至：button_element 点击元素： - 元素对象：{{button_element}} - 点击方式：单击自定义等待时长：1秒 ``` **示例2**：获取多个属性 ``` 循环相似元素： - tab对象：{{list_tab}} - 操作目标css/xpath：.list-item - 元素操作：获取元素对象 - 保存当前循环项至：item_element 执行JS脚本： - 脚本内容： var ele = arguments[0]; return { text: ele.textContent, href: ele.getAttribute('href'), class: ele.className }; - 保存结果至：item_data 日志输出： - 输出内容：元素信息：{{item_data}} ``` --- ### 获取元素值获取表单元素的值（比如input输入框、textarea文本域、select下拉框的值）。 #### 适用元素 - `` 输入框 - `

` 文本域
- `<select>` 下拉框

#### 示例

**示例1**：获取所有输入框的值

```
循环相似元素：
  - tab对象：{{form_tab}}
  - 操作目标css/xpath：input[type="text"]
  - 元素操作：获取元素值
  - 保存当前循环项至：input_value

条件判断：if条件
    - 对象1：{{input_value}}
    - 关系：为空

日志输出：发现空输入框

否则：
    日志输出：输入框值：{{input_value}}
```

**示例2**：验证表单数据

```
前置步骤：新建列表
  - 保存列表对象至：empty_fields

循环相似元素：
  - 操作目标css/xpath：.required-input
  - 元素操作：获取元素值
  - 保存当前循环项至：field_value

条件判断：if条件
    - 对象1：{{field_value}}
    - 关系：为空

列表插入一项：
      - 列表：{{empty_fields}}
      - 插入内容：字段为空

后续操作：
  获取列表长度：
    - 列表：{{empty_fields}}
    - 保存至：empty_count

条件判断：
    - 对象1：{{empty_count}}
    - 关系：大于
    - 对象2：0

日志输出：发现{{empty_count}}个空字段
```

---

### 获取元素链接地址

获取链接元素（`<a>`标签）的href属性（链接的地址）。

#### 示例

**示例1**：收集所有链接

```
前置步骤：新建列表
  - 保存列表对象至：link_list

循环相似元素：
  - tab对象：{{page_tab}}
  - 操作目标css/xpath：.article-link
  - 元素操作：获取元素链接地址
  - 保存当前循环项至：link_url

列表插入一项：
    - 列表：{{link_list}}
    - 插入内容：{{link_url}}

后续处理：
  列表去重：
    - 列表：{{link_list}}

列表聚合成文本：
    - 列表：{{link_list}}
    - 连接符号：换行符
    - 保存结果至：links_text

写入文件：
    - 文件路径：D:\data\links.txt
    - 内容：{{links_text}}
```

**示例2**：依次打开每个链接

```
循环相似元素：
  - tab对象：{{main_tab}}
  - 操作目标css/xpath：//a[@class='detail-link']
  - 元素操作：获取元素链接地址
  - 保存当前循环项至：detail_url

打开网页：
    - 网址：{{detail_url}}
    - 标签页名称：detail_tab

等待网页加载完成

# 在详情页执行操作
  获取网页信息：
    - tab对象：{{detail_tab}}
    - 操作：获取网页标题
    - 存贮网页信息至：page_title

日志输出：
    - 输出内容：页面标题：{{page_title}}

关闭网页：
    - 关闭方式：关闭指定标签页
    - tab对象：{{detail_tab}}

自定义等待时长：2秒
```

---

### 获取元素源代码

获取元素的HTML源代码（包括元素本身和它里面所有的子元素）。

#### 什么时候用？

- **获取复杂结构**：获取结构复杂的元素（比如包含多个子元素的卡片）
- **保存HTML分析**：保存元素的HTML代码，用于后续分析
- **提取内嵌内容**：提取元素里的样式或脚本

#### 示例

**示例1**：获取文章HTML

```
循环相似元素：
  - tab对象：{{blog_tab}}
  - 操作目标css/xpath：.article-content
  - 元素操作：获取元素源代码
  - 保存当前循环项至：article_html

写入文件：
    - 文件路径：D:\articles\article_{{loop_index}}.html
    - 内容：{{article_html}}
```

**示例2**：分析元素结构

```
循环相似元素：
  - 操作目标css/xpath：.complex-widget
  - 元素操作：获取元素源代码
  - 保存当前循环项至：widget_html

文本操作（提取内容）：
    - 内容源：{{widget_html}}
    - 提取方式：提取自定义内容
    - 正则表达式：data-id="(.*?)"
    - 保存结果至：widget_id

日志输出：
    - 输出内容：组件ID：{{widget_id}}
```

---

### 获取元素属性

获取元素的指定HTML属性值（比如`href`、`src`、`data-id`等）。

#### 常用的属性

- `href` - 链接地址
- `src` - 图片或脚本的源地址
- `data-*` - 自定义数据属性（比如`data-id`、`data-name`）
- `id` - 元素的ID
- `class` - CSS类名
- `title` - 提示文本（鼠标悬停时显示）
- `alt` - 图片的替代文本

#### 示例

**示例1**：获取图片src属性

```
前置步骤：新建列表
  - 保存列表对象至：image_urls

循环相似元素：
  - tab对象：{{gallery_tab}}
  - 操作目标css/xpath：img.gallery-image
  - 元素操作：获取元素属性
  - 属性名：src
  - 保存当前循环项至：img_src

列表插入一项：
    - 列表：{{image_urls}}
    - 插入内容：{{img_src}}

后续操作：
  foreach列表循环：
    - 列表：{{image_urls}}
    - 保存当前循环项至：current_url

http下载：
      - 下载地址：{{current_url}}
      - 保存目录：D:\images

自定义等待时长：1秒
```

**示例2**：获取自定义data属性

```
循环相似元素：
  - tab对象：{{product_tab}}
  - 操作目标css/xpath：.product-card
  - 元素操作：获取元素属性
  - 属性名：data-product-id
  - 保存当前循环项至：product_id

日志输出：
    - 输出内容：商品ID：{{product_id}}

# 使用产品ID进行其他操作...
```

**示例3**：获取多个属性

```
新建字典：
  - 保存字典对象至：product_info

循环相似元素：
  - 操作目标css/xpath：.product-item
  - 元素操作：获取元素属性
  - 属性名：data-id
  - 保存当前循环项至：item_id

设置键值对：
    - 字典：{{product_info}}
    - 键名：{{item_id}}
    - 值：已处理
```

---

### 高级设置

#### 循环范围控制

可以指定只循环部分元素：

- **循环开始位置**：从第几个元素开始（索引从0开始）
- **循环结束位置**：到第几个元素结束（不包含该位置）

**示例**：只处理前5个元素

```
配置：
  操作目标css/xpath：.item
  循环开始位置：0
  循环结束位置：5
```

**示例**：跳过前3个元素

```
配置：
  操作目标css/xpath：.item
  循环开始位置：3
  循环结束位置：（留空表示到末尾）
```

#### 等待元素存在

- **默认值**：10秒
- **说明**：等待元素出现的超时时间
- **建议**：对于动态加载的元素，可以增加等待时间

---

## 2. 获取相似元素列表

**获取相似元素列表**就像一次性把所有相似元素的数据都抓下来，返回一个列表。和循环相似元素不同，这个操作不会一个个遍历，而是直接返回所有数据。

### 功能说明

- **找到所有匹配的元素**：根据选择器找到所有相似的元素
- **提取属性**：提取每个元素的指定属性（文字、链接等）
- **返回列表**：返回包含所有数据的列表
- **速度快**：执行速度快，适合简单的数据采集

### 需要填什么？

| 参数               | 说明                                              | 必填   | 默认值           |
| ------------------ | ------------------------------------------------- | ------ | ---------------- |
| tab对象            | 要在哪个网页操作？填标签页变量名，比如`{{网页1}}` | ✅      | -                |
| 操作目标css/xpath  | 要获取什么元素？填选择器，比如`.标题`             | ✅      | -                |
| 元素操作           | 要获取元素的什么？选类型（和循环相似元素一样）    | ✅      | 获取元素文本内容 |
| 属性名             | 如果选"获取元素属性"，要填属性名                  | 看情况 | -                |
| 保存相似元素列表至 | 把结果列表存到哪个变量？填变量名，比如`标题列表`  | ✅      | -                |

### 什么时候用？

- **快速采集数据**：快速采集列表数据（不用循环，直接全部获取）
- **获取所有链接**：获取所有链接地址（比如获取所有新闻链接）
- **提取表格数据**：提取表格里的数据
- **收集图片URL**：收集所有图片的URL

### 示例

**示例1**：获取所有标题文本

```
配置：
  tab对象：{{news_tab}}
  操作目标css/xpath：.news-title
  元素操作：获取元素文本内容
  保存相似元素列表至：titles_list
```

**输出结果**：

```python
titles_list = ['新闻A', '新闻B', '新闻C', ...]
```

**示例2**：获取所有链接并保存

```
步骤1：获取相似元素列表
  - tab对象：{{page_tab}}
  - 操作目标css/xpath：a.article-link
  - 元素操作：获取元素链接地址
  - 保存相似元素列表至：links

步骤2：列表去重
  - 列表：{{links}}
  - 保存结果至：unique_links

步骤3：列表聚合成文本
  - 列表：{{unique_links}}
  - 连接符号类型：标准连接符号
  - 连接符号：换行符
  - 保存结果至：links_text

步骤4：写入文件
  - 文件路径：D:\data\links.txt
  - 内容：{{links_text}}
```

**示例3**：获取所有图片URL

```
步骤1：获取相似元素列表
  - tab对象：{{gallery_tab}}
  - 操作目标css/xpath：img.photo
  - 元素操作：获取元素属性
  - 属性名：src
  - 保存相似元素列表至：image_urls

步骤2：获取列表长度
  - 列表：{{image_urls}}
  - 保存至：image_count

步骤3：日志输出
  - 输出内容：找到{{image_count}}张图片

步骤4：foreach列表循环
  - 列表：{{image_urls}}
  - 保存当前循环项至：img_url

http下载：
    - 下载地址：{{img_url}}
    - 保存目录：D:\gallery

自定义等待时长：0.5秒
```

---

### 与循环相似元素的对比

| 特性     | 循环相似元素         | 获取相似元素列表 |
| -------- | -------------------- | ---------------- |
| 执行方式 | 遍历每个元素         | 一次性获取所有   |
| 返回结果 | 无（在循环体内处理） | 列表             |
| 复杂操作 | ✅ 支持               | ❌ 不支持         |
| 执行速度 | 较慢                 | 较快             |
| 适用场景 | 需要对每个元素操作   | 只需要数据列表   |

**选择建议**：

- 如果只需要获取数据列表：使用"获取相似元素列表"
- 如果需要对每个元素进行操作：使用"循环相似元素"

---

## 使用技巧

### 1. 选择器的编写技巧

**技巧1**：使用唯一的class

```css
/* 好的选择器 */
.product-item h3.title

/* 避免过于宽泛的选择器 */
div h3
```

**技巧2**：使用XPath的位置限定

```xpath
/* 只选择列表容器内的元素 */
//div[@class='list-container']//li

/* 排除某些元素 */
//li[not(@class='hidden')]
```

### 2. 处理动态元素

```
步骤1：鼠标滚动页面
  - 滚动位置：滚动到底部
  - 滚动效果：平滑滚动

步骤2：自定义等待时长
  - 等待时长：2秒

步骤3：循环相似元素
  - 操作目标css/xpath：.lazy-loaded-item
```

### 3. 数据清洗

```
获取相似元素列表：
  - 保存至：raw_data

列表去重：
  - 列表：{{raw_data}}

列表操作（删除空项）：
  foreach列表循环：
    - 列表：{{raw_data}}
    - 保存当前循环项至：item

条件判断：
      - 对象1：{{item}}
      - 关系：不为空

列表插入一项：
        - 列表：{{clean_data}}
        - 插入内容：{{item}}
```

### 4. 组合使用两种方式

```
步骤1：获取相似元素列表（快速获取所有链接）
  - 元素操作：获取元素链接地址
  - 保存至：all_links

步骤2：循环相似元素（处理每个链接）
  foreach列表循环：
    - 列表：{{all_links}}
    - 保存当前循环项至：link_url

打开网页：
      - 网址：{{link_url}}

# 在新页面执行操作...
```

---

## 常见问题

### Q1: 循环相似元素找不到元素？

**A:** 检查以下几点：

1. **选择器是否正确**：使用浏览器开发者工具验证
2. **元素是否已加载**：增加等待时间或先滚动页面
3. **选择器是否过于具体**：简化选择器，确保能匹配所有目标元素

### Q2: 循环相似元素只处理了部分元素？

**A:** 可能的原因：

1. **循环范围设置**：检查"循环开始位置"和"循环结束位置"
2. **元素动态加载**：某些元素在循环开始时还未加载
   - 解决方案：先滚动到底部，确保所有元素都加载

### Q3: 获取元素属性返回None或空值？

**A:** 可能的原因：

1. **属性名拼写错误**：检查属性名是否正确
2. **属性不存在**：该元素没有这个属性
3. **使用data属性**：data属性需要包含"data-"前缀，如`data-id`

### Q4: 循环体内的操作影响了后续元素？

**A:** 这是正常现象，解决方案：

1. **保存状态**：在操作前保存当前页面状态
2. **使用新标签页**：在新标签页中打开链接
3. **重新定位**：操作后重新获取元素列表

### Q5: 如何获取嵌套元素的数据？

**A:** 方法：

```
方法1：使用元素对象
循环相似元素：
  - 元素操作：获取元素对象
  - 保存至：item_element

执行JS脚本：
    - 脚本：
      var title = arguments[0].querySelector('.title').textContent;
      var price = arguments[0].querySelector('.price').textContent;
      return {title: title, price: price};
    - 传入参数：{{item_element}}
    - 保存结果至：item_data

方法2：使用更具体的选择器
循环相似元素（外层）：
  - 操作目标：.product-item
  - 元素操作：获取元素对象
  - 保存至：product

# 在循环内获取子元素
  获取相似元素列表：
    - 父元素：{{product}}
    - 操作目标：.detail
```

### Q6: 循环大量元素时性能慢怎么办？

**A:** 优化建议：

1. **使用获取相似元素列表**：如果不需要复杂操作，直接获取列表更快
2. **减少等待时间**：去除不必要的等待
3. **批处理**：每处理N个元素后保存一次数据
4. **限制循环范围**：使用循环开始/结束位置

---

## 实战案例

### 案例1：电商商品信息采集

```
场景：采集商品列表中的标题、价格、链接

步骤1：打开网页
  - 网址：https://shop.example.com/products
  - 标签页名称：shop_tab

步骤2：新建列表（准备存储数据）
  - 保存列表对象至：products_data

步骤3：循环相似元素
  - tab对象：{{shop_tab}}
  - 操作目标css/xpath：.product-card
  - 元素操作：获取元素对象
  - 保存当前循环项至：product_ele

# 获取标题
  执行JS脚本：
    - 脚本：return arguments[0].querySelector('.title').textContent
    - 传入参数：{{product_ele}}
    - 保存结果至：title

# 获取价格
  执行JS脚本：
    - 脚本：return arguments[0].querySelector('.price').textContent
    - 传入参数：{{product_ele}}
    - 保存结果至：price

# 获取链接
  执行JS脚本：
    - 脚本：return arguments[0].querySelector('a').href
    - 传入参数：{{product_ele}}
    - 保存结果至：link

# 组装数据
  新建字典：
    - 保存字典对象至：item_data

设置键值对：
    - 字典：{{item_data}}
    - 键名：title
    - 值：{{title}}

设置键值对：
    - 字典：{{item_data}}
    - 键名：price
    - 值：{{price}}

设置键值对：
    - 字典：{{item_data}}
    - 键名：link
    - 值：{{link}}

# 添加到列表
  列表插入一项：
    - 列表：{{products_data}}
    - 插入内容：{{item_data}}

步骤4：保存到文件
  json对象转换成文本：
    - json对象：{{products_data}}
    - 保存文本至：json_text

写入文件：
    - 文件路径：D:\data\products.json
    - 内容：{{json_text}}
```

### 案例2：批量下载图片

```
场景：下载页面中的所有图片

步骤1：打开网页
  - 网址：https://gallery.example.com
  - 标签页名称：gallery_tab

步骤2：获取相似元素列表（图片URL）
  - tab对象：{{gallery_tab}}
  - 操作目标css/xpath：img.photo
  - 元素操作：获取元素属性
  - 属性名：src
  - 保存相似元素列表至：image_urls

步骤3：获取列表长度
  - 列表：{{image_urls}}
  - 保存至：total

步骤4：日志输出
  - 输出内容：找到{{total}}张图片，开始下载...

步骤5：设置变量（计数器）
  - 变量名：counter
  - 变量值：0

步骤6：foreach列表循环
  - 列表：{{image_urls}}
  - 保存当前循环项至：img_url

# 下载图片
  http下载：
    - 下载地址：{{img_url}}
    - 保存目录：D:\gallery
    - 保存文件名：image_{{counter}}.jpg

# 计数器加1
  数据处理（加法）：
    - 变量：counter
    - 值：1

日志输出：
    - 输出内容：已下载{{counter}}/{{total}}

自定义等待时长：1秒
```

---

## 更新日志

- **v4.2.4**：优化了元素查找的性能
- **v4.2.0**：新增了循环范围控制功能
- **v4.1.0**：增强了元素属性获取功能

---

## 技术支持

如果您在使用过程中遇到问题，可以通过以下方式获取帮助：

- 💬 在线客服：访问官网获取在线支持
- 📖 文档中心：查看完整的产品文档

---

**文档版本**：v1.0  
**最后更新**：2026年

</article></body></html>

相似元素操作教程